curl --request GET \
--url https://api.syntalic.com/v1/measures/pricesimport requests
url = "https://api.syntalic.com/v1/measures/prices"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/measures/prices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.syntalic.com/v1/measures/prices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.syntalic.com/v1/measures/prices"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.syntalic.com/v1/measures/prices")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/measures/prices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"category": "apparel-accessories",
"department": null,
"country": "us",
"currency": "USD",
"product_count": 167738,
"brand_count": 1238,
"retailer_count": 631,
"retailer_kinds": {
"retailers": 62,
"storefronts": 569,
"unknown": 0
},
"pricing": {
"avg": 64.86,
"min": 5,
"max": 192,
"median": 51.99
},
"avg_rating": null,
"promo_rate_pct": 27,
"listprice_observed": 62902,
"in_stock_rate_pct": 66.6,
"representative_floor": 5,
"excluded": {
"below_floor": 275,
"refurbished_or_used": 65,
"accessory_or_parts": 0,
"price_outliers": 5832
},
"coverage": {
"products": 167738,
"sufficient": true,
"counted": "products inside the price floor and outlier fence"
},
"freshness": {
"observedThrough": "2026-11-19T07:22:02.239Z",
"staleHours": 3
},
"quality": {
"platform": "shopify",
"country": "us",
"category_root": "apparel-accessories",
"quality_status": "serving",
"is_serving_eligible": true,
"priced_product_count": "172268",
"recent_priced_product_count": "163526"
},
"top_brands": [
{
"brand": "Kyte Baby",
"product_count": 15451
},
{
"brand": "POPFLEX®",
"product_count": 13552
}
],
"resolved": {
"category_id": null,
"category_path": "apparel-accessories",
"match_source": "slug",
"match_confidence": 0.35,
"alternates": []
},
"meta": {
"served_from": "cache",
"freshness_seconds": 10896,
"schema_version": "v3",
"computed_at": "2026-11-19T10:23:38.319Z",
"publish_id": "0f6dbfc5-4a04-49b5-9a4e-257d6af4b0c4",
"published_at": "2026-11-19T07:56:57.632Z"
}
}{
"type": "<string>",
"title": "Bad Request",
"status": 400,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"type": "<string>",
"title": "Payment Required",
"status": 402,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"type": "<string>",
"title": "Not Found",
"status": 404,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"type": "<string>",
"title": "Conflict",
"status": 409,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"type": "<string>",
"title": "Unprocessable Content",
"status": 422,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"type": "<string>",
"title": "Too Many Requests",
"status": 429,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"type": "<string>",
"title": "Internal Server Error",
"status": 500,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"type": "<string>",
"title": "Service Unavailable",
"status": 503,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}The price level and spread of a shelf.
The price level and spread of a shelf. A measure is one metric family asked one way: by picks the split, subject is what it is about, and every other parameter is the answering route’s own. The answer is that route’s answer, unchanged, and X-Syntalic-Preset names it. An unknown by, or a subject the split cannot take, is refused before anything is billed, with the valid list. by=summary: counts, median and range, promo rate and in-stock rate, top brands, answered by /v1/analyst/category-summary. by=distribution: mean, spread and percentiles of current prices, answered by /v1/analyst/price-dispersion. by=band: the shelf’s price tiers and its comparability window, answered by /v1/analyst/price-bands. by=brand: one brand’s place on the shelf’s price ladder (send brand_id or brand), answered by /v1/marketing/price-positioning. by=product: every product on the shelf with its current price, answered by /v1/marketing/competitive-landscape. by=retailer: one retailer’s price index against the shelf, day by day (send retailer_id or retailer), answered by /v1/analyst/retailer-index.
curl --request GET \
--url https://api.syntalic.com/v1/measures/pricesimport requests
url = "https://api.syntalic.com/v1/measures/prices"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/measures/prices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.syntalic.com/v1/measures/prices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.syntalic.com/v1/measures/prices"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.syntalic.com/v1/measures/prices")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/measures/prices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"category": "apparel-accessories",
"department": null,
"country": "us",
"currency": "USD",
"product_count": 167738,
"brand_count": 1238,
"retailer_count": 631,
"retailer_kinds": {
"retailers": 62,
"storefronts": 569,
"unknown": 0
},
"pricing": {
"avg": 64.86,
"min": 5,
"max": 192,
"median": 51.99
},
"avg_rating": null,
"promo_rate_pct": 27,
"listprice_observed": 62902,
"in_stock_rate_pct": 66.6,
"representative_floor": 5,
"excluded": {
"below_floor": 275,
"refurbished_or_used": 65,
"accessory_or_parts": 0,
"price_outliers": 5832
},
"coverage": {
"products": 167738,
"sufficient": true,
"counted": "products inside the price floor and outlier fence"
},
"freshness": {
"observedThrough": "2026-11-19T07:22:02.239Z",
"staleHours": 3
},
"quality": {
"platform": "shopify",
"country": "us",
"category_root": "apparel-accessories",
"quality_status": "serving",
"is_serving_eligible": true,
"priced_product_count": "172268",
"recent_priced_product_count": "163526"
},
"top_brands": [
{
"brand": "Kyte Baby",
"product_count": 15451
},
{
"brand": "POPFLEX®",
"product_count": 13552
}
],
"resolved": {
"category_id": null,
"category_path": "apparel-accessories",
"match_source": "slug",
"match_confidence": 0.35,
"alternates": []
},
"meta": {
"served_from": "cache",
"freshness_seconds": 10896,
"schema_version": "v3",
"computed_at": "2026-11-19T10:23:38.319Z",
"publish_id": "0f6dbfc5-4a04-49b5-9a4e-257d6af4b0c4",
"published_at": "2026-11-19T07:56:57.632Z"
}
}{
"type": "<string>",
"title": "Bad Request",
"status": 400,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"type": "<string>",
"title": "Payment Required",
"status": 402,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"type": "<string>",
"title": "Not Found",
"status": 404,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"type": "<string>",
"title": "Conflict",
"status": 409,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"type": "<string>",
"title": "Unprocessable Content",
"status": 422,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"type": "<string>",
"title": "Too Many Requests",
"status": 429,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"type": "<string>",
"title": "Internal Server Error",
"status": 500,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"type": "<string>",
"title": "Service Unavailable",
"status": 503,
"detail": "<string>",
"instance": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}Query Parameters
What the question is about: an id (spt:, gpc:, brand:, retailer:, entity:) or a name. It is sent to the answering route as the parameter of its kind (an spt: id as spt, a brand: id as brand_id, a name as the route's name parameter), so send it OR that parameter, not both. Which kinds a split takes is in x-syntalic-presets; a kind it does not take is refused before anything is billed.
Product category in the Shopify product taxonomy. Accepts a display path (e.g. 'Electronics > Computers > Laptops'), its slug form (e.g. 'electronics/computers/laptops'), a single path segment (e.g. 'laptops', 'headphones'), or an everyday shelf name (e.g. 'apparel', 'beauty', 'grocery'); matched against the catalog's category tree (exact node, subtree, or whole path segment). Also accepts a GS1 GPC code (exactly 8 digits, e.g. '10001159') to filter by PRODUCT TYPE instead of by shelf placement — the same product type is shelved under different categories by different retailers, so a category filter answers from a fraction of the data while a GPC code spans them. Coarser codes (class/family/segment) match every brick beneath them. Resolve a phrase to a code with /v1/reference/classify?q=... ; when a code is used, resolved.match_source is 'gpc'. Some product types are filed under more than one department (e.g. Protein Bars under both Food and Health & Beauty); add include_homes=true to read every home of such a type as one shelf. For analyst endpoints, supply either category or department; both may be supplied to narrow the scope.
1A Shopify taxonomy root, e.g. 'Electronics' or 'Food, Beverages & Tobacco'. Case-insensitive; matched against that root and nothing under it. A name that is not a root, including a retired browse department such as 'Grocery' or 'Home & Kitchen', is refused before payment and the response names the roots to send. For analyst endpoints, supply either category or department; both may be supplied to narrow the scope.
1Optional. Pin the answer to a serving publish: pass meta.publish_id from an earlier answer. When the served snapshot has moved on, or cannot be confirmed, the request is answered 409 PUBLISH_CHANGED naming the current publish, before any payment challenge and free. Use it to keep several answers on one snapshot.
1A product type by GS1 GPC id, from GET /v1/ontology/resolve (a product_type match's id). Covers EVERY shelf the type is filed under, so a type shelved in two departments is one scope (category=<8 digits> filters by browse-node placement). Send it instead of category= or spt=, not with them.
^gpc:[0-9]{8}$A chain by id, from GET /v1/ontology/resolve (a retailer match's id): the chain (seller_norm) whatever lane its listings were scraped through, never a lane. retailer= matches the scrape lane, so a Shopify store's chain can only be asked for by id (#1090). Send it instead of retailer=, not with it.
^retailer:[a-z0-9]{1,64}$Optional. Locate one brand within the tiers: each tier gains brand_products, the count of that brand's products in it. Omit for the market view. A name that is nowhere in the catalog under that spelling is refused before payment, when the request arrives without payment attached (the normal 402 flow): a 404 whose error.details.alternates lists brands with a similar name (search them at /v1/public/brands?q=). A request that attaches payment up front is not checked and can still be billed for an empty answer, so send the unpaid request first or check the name at /v1/public/brands. A brand the catalog holds that has nothing for this request is still answered, with coverage.reason. A brand longer than 120 characters is a 400.
1Historical window preset. Explicit from/to takes precedence and is reported as custom; time_window=custom requires both from and to. Date-only ranges use UTC calendar boundaries with inclusive from and exclusive to.
last_30_days, last_60_days, last_90_days, month_to_date, previous_month, month_over_month, quarter_to_date, custom Response
The answer of the route that by selected, unchanged. The X-Syntalic-Preset response header names that route; its own path in this document has the response schema.
The response is of type object.