curl --request GET \
--url https://api.syntalic.com/v1/measures/trendimport requests
url = "https://api.syntalic.com/v1/measures/trend"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/measures/trend', 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/trend",
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/trend"
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/trend")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/measures/trend")
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{
"query": "Daybreak Wireless Gaming Headset Black",
"dropped_terms": null,
"country": "us",
"currency": "USD",
"product_uid": "shopify:7041132855368:41070639906888",
"entity_uid": "3e3fd48b28844f606baa9740148b35bc",
"scope": "listing",
"member_count": 1,
"match_suspect": false,
"resolved_product": {
"product_uid": "shopify:7041132855368:41070639906888",
"entity_uid": "3e3fd48b28844f606baa9740148b35bc",
"scope": "listing",
"member_count": 1,
"match_suspect": false,
"product_name": "Daybreak Wireless Gaming Headset Black",
"brand": "JLab",
"retailer": "shopify",
"product_type": "Gaming Headset",
"category_path": "electronics/audio/audio-components/headphones-headsets/headsets/gaming-headsets",
"condition": "new",
"image_url": "https://cdn.shopify.com/s/files/1/0240/9337/files/1_Daybreak_Headset_Black.jpg?v=1774997404",
"description": "JLab Daybreak Wireless Gaming Headset is a premium wireless over-ear gaming headset and the best tier in JLab's gaming lineup. Built for PC, PlayStation, and Nintendo Switch, it combines dual-driver a",
"description_chars": 3657,
"description_truncated": true
},
"product_name": "Daybreak Wireless Gaming Headset Black",
"brand": "JLab",
"days": 30,
"retailer": "shopify",
"store": "jlab",
"seller": "jlab.com",
"store_basis": "seller",
"url": "https://jlab.com/products/daybreak-wireless-gaming-headset-black",
"lane": "shopify",
"barcode": null,
"pack_count": null,
"unit_size": null,
"unit_measure": null,
"unit_price": null,
"condition": "new",
"gpc": {
"code": "10001467",
"title": "Audio Headsets",
"level": "brick",
"segment": "Audio Visual/Photography",
"family": "Audio Visual Equipment",
"class": "Audio Visual Accessories",
"brick": "Audio Headsets",
"match_precision": "narrowerThan",
"match_source": "self"
},
"current_price": 74.99,
"period_low": 74.99,
"period_high": 149.99,
"period_avg": 131.24,
"is_good_deal": true,
"trend": "falling",
"insufficient_history": false,
"observation_count": 4,
"observations": [
{
"date": "2026-10-20",
"product_uid": "shopify:7041132855368:41070639906888",
"price": 149.99
},
{
"date": "2026-10-28",
"product_uid": "shopify:7041132855368:41070639906888",
"price": 149.99
}
],
"series": [
{
"date": "2026-10-20",
"price": 149.99
},
{
"date": "2026-10-28",
"price": 149.99
}
],
"series_summary": {
"current": 74.99,
"min": 74.99,
"min_date": "2026-11-13",
"max": 149.99,
"max_date": "2026-10-20",
"change_pct": -50,
"drops": [
{
"date": "2026-11-13",
"from_price": 149.99,
"to_price": 74.99,
"pct": 50
}
],
"change_window_days": 30
},
"coverage": {
"products": 4,
"sufficient": true,
"counted": "price observations"
},
"freshness": {
"observedThrough": "2026-11-13T06:07:20.882Z",
"staleHours": 136.8
},
"quality": {
"platform": "shopify",
"country": "us",
"category_root": "__all__",
"quality_status": "serving",
"is_serving_eligible": true,
"priced_product_count": "393375",
"recent_priced_product_count": "377922"
}
}{
"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": {}
}
}How prices moved, for a product, a shelf or a brand.
How prices moved, for a product, a shelf or a brand. 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=period (product): one product’s price series, with its low, high and direction, answered by /v1/shopper/price-history. by=period (brand): a brand’s price, product count and promo count, day by day, answered by /v1/marketing/brand-tracker. by=drop: whether one product’s current price is below its recent average, answered by /v1/shopper/price-drop-alert. by=product: the products that rose and fell most, on a shelf or for a brand, answered by /v1/analyst/price-change-leaders.
curl --request GET \
--url https://api.syntalic.com/v1/measures/trendimport requests
url = "https://api.syntalic.com/v1/measures/trend"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/measures/trend', 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/trend",
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/trend"
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/trend")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/measures/trend")
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{
"query": "Daybreak Wireless Gaming Headset Black",
"dropped_terms": null,
"country": "us",
"currency": "USD",
"product_uid": "shopify:7041132855368:41070639906888",
"entity_uid": "3e3fd48b28844f606baa9740148b35bc",
"scope": "listing",
"member_count": 1,
"match_suspect": false,
"resolved_product": {
"product_uid": "shopify:7041132855368:41070639906888",
"entity_uid": "3e3fd48b28844f606baa9740148b35bc",
"scope": "listing",
"member_count": 1,
"match_suspect": false,
"product_name": "Daybreak Wireless Gaming Headset Black",
"brand": "JLab",
"retailer": "shopify",
"product_type": "Gaming Headset",
"category_path": "electronics/audio/audio-components/headphones-headsets/headsets/gaming-headsets",
"condition": "new",
"image_url": "https://cdn.shopify.com/s/files/1/0240/9337/files/1_Daybreak_Headset_Black.jpg?v=1774997404",
"description": "JLab Daybreak Wireless Gaming Headset is a premium wireless over-ear gaming headset and the best tier in JLab's gaming lineup. Built for PC, PlayStation, and Nintendo Switch, it combines dual-driver a",
"description_chars": 3657,
"description_truncated": true
},
"product_name": "Daybreak Wireless Gaming Headset Black",
"brand": "JLab",
"days": 30,
"retailer": "shopify",
"store": "jlab",
"seller": "jlab.com",
"store_basis": "seller",
"url": "https://jlab.com/products/daybreak-wireless-gaming-headset-black",
"lane": "shopify",
"barcode": null,
"pack_count": null,
"unit_size": null,
"unit_measure": null,
"unit_price": null,
"condition": "new",
"gpc": {
"code": "10001467",
"title": "Audio Headsets",
"level": "brick",
"segment": "Audio Visual/Photography",
"family": "Audio Visual Equipment",
"class": "Audio Visual Accessories",
"brick": "Audio Headsets",
"match_precision": "narrowerThan",
"match_source": "self"
},
"current_price": 74.99,
"period_low": 74.99,
"period_high": 149.99,
"period_avg": 131.24,
"is_good_deal": true,
"trend": "falling",
"insufficient_history": false,
"observation_count": 4,
"observations": [
{
"date": "2026-10-20",
"product_uid": "shopify:7041132855368:41070639906888",
"price": 149.99
},
{
"date": "2026-10-28",
"product_uid": "shopify:7041132855368:41070639906888",
"price": 149.99
}
],
"series": [
{
"date": "2026-10-20",
"price": 149.99
},
{
"date": "2026-10-28",
"price": 149.99
}
],
"series_summary": {
"current": 74.99,
"min": 74.99,
"min_date": "2026-11-13",
"max": 149.99,
"max_date": "2026-10-20",
"change_pct": -50,
"drops": [
{
"date": "2026-11-13",
"from_price": 149.99,
"to_price": 74.99,
"pct": 50
}
],
"change_window_days": 30
},
"coverage": {
"products": 4,
"sufficient": true,
"counted": "price observations"
},
"freshness": {
"observedThrough": "2026-11-13T06:07:20.882Z",
"staleHours": 136.8
},
"quality": {
"platform": "shopify",
"country": "us",
"category_root": "__all__",
"quality_status": "serving",
"is_serving_eligible": true,
"priced_product_count": "393375",
"recent_priced_product_count": "377922"
}
}{
"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.
Search query (product name, keyword, or brand + model). Required unless product_uid or entity_uid is supplied. At least one word needs two or more letters or digits (LG, 3M and HP are enough): a shorter query, such as a single letter, is refused before payment with a 400.
1The chart's range, as a preset. last_N_days is the same range as lookback_days=N: N days back from now, through now. month_to_date and quarter_to_date start on the period's first day (UTC) and run through now, so today's readings, and with them the current price, are in them; on the first day of the period they are a 400, as on every route. previous_month is that calendar month (UTC). custom is the range from and to name, and needs both. month_over_month is a 400: a price history is one series. Name the range one way, time_window, lookback_days, or from/to: a second name that disagrees is a free 400, never a silent winner (lookback_days=90 beside last_90_days agrees). Nothing named is the last 30 days. When the product is named by id (entity_uid or product_uid) and the range holds no reading of it, the answer is a free 404 before payment whose error.details.newest_observed_at is the newest reading's time (null when none is held), so a wider range can be asked for.
last_30_days, last_60_days, last_90_days, month_to_date, previous_month, month_over_month, quarter_to_date, custom Optional. 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 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}$Brand name (e.g., Sony, Samsung, Nike) 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.
1Product 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.
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}$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.