curl --request GET \
--url https://api.syntalic.com/v1/marketing/brand-trackerimport requests
url = "https://api.syntalic.com/v1/marketing/brand-tracker"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/marketing/brand-tracker', 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/marketing/brand-tracker",
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/marketing/brand-tracker"
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/marketing/brand-tracker")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/marketing/brand-tracker")
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{
"brand": "allbirds",
"country": "us",
"currency": "USD",
"window": {
"preset": "last_30_days",
"from": "2026-10-20",
"to": "2026-11-19",
"granularity": "daily",
"timezone": "UTC"
},
"sample_threshold": 5,
"insufficient_sample_points": 0,
"insufficient_sample": false,
"coverage": {
"products": 0,
"sufficient": false,
"reason": "below_min_matched",
"min": 5
},
"freshness": {
"observedThrough": "2026-11-17T07:23:16.269Z",
"staleHours": 51
},
"quality": {
"platform": "shopify",
"country": "us",
"category_root": "__all__",
"quality_status": "serving",
"is_serving_eligible": true,
"priced_product_count": "409315",
"recent_priced_product_count": "393789"
},
"stable_basket_size": 0,
"time_series": [
{
"date": "2026-10-24",
"avg_price": 114.81,
"min_price": 67,
"max_price": 160,
"product_count": 4317,
"stable_avg_price": null,
"insufficient_sample": false,
"sample_threshold": 5,
"in_stock_count": 2186,
"promo_count": 118
},
{
"date": "2026-11-01",
"avg_price": 114.52,
"min_price": 67,
"max_price": 160,
"product_count": 3932,
"stable_avg_price": null,
"insufficient_sample": false,
"sample_threshold": 5,
"in_stock_count": 2085,
"promo_count": 59
}
],
"resolved": null,
"meta": {
"served_from": "live",
"freshness_seconds": 183587,
"schema_version": "v3",
"computed_at": "2026-11-19T10:23:04.177Z",
"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": {}
}
}Track a brand's pricing and presence over time
Track a brand’s average/min/max price, product count, in-stock count, and promo count day-by-day across a date range. Brand input matches case-insensitively and across normalization variants (jbl == JBL, tplink == TP-Link). Each point reports insufficient_sample when its basket is under sample_threshold products, plus stable_avg_price computed over only the products priced on every day of the series — use stable_avg_price for trend reads; the all-products average moves with basket composition.
curl --request GET \
--url https://api.syntalic.com/v1/marketing/brand-trackerimport requests
url = "https://api.syntalic.com/v1/marketing/brand-tracker"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/marketing/brand-tracker', 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/marketing/brand-tracker",
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/marketing/brand-tracker"
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/marketing/brand-tracker")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/marketing/brand-tracker")
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{
"brand": "allbirds",
"country": "us",
"currency": "USD",
"window": {
"preset": "last_30_days",
"from": "2026-10-20",
"to": "2026-11-19",
"granularity": "daily",
"timezone": "UTC"
},
"sample_threshold": 5,
"insufficient_sample_points": 0,
"insufficient_sample": false,
"coverage": {
"products": 0,
"sufficient": false,
"reason": "below_min_matched",
"min": 5
},
"freshness": {
"observedThrough": "2026-11-17T07:23:16.269Z",
"staleHours": 51
},
"quality": {
"platform": "shopify",
"country": "us",
"category_root": "__all__",
"quality_status": "serving",
"is_serving_eligible": true,
"priced_product_count": "409315",
"recent_priced_product_count": "393789"
},
"stable_basket_size": 0,
"time_series": [
{
"date": "2026-10-24",
"avg_price": 114.81,
"min_price": 67,
"max_price": 160,
"product_count": 4317,
"stable_avg_price": null,
"insufficient_sample": false,
"sample_threshold": 5,
"in_stock_count": 2186,
"promo_count": 118
},
{
"date": "2026-11-01",
"avg_price": 114.52,
"min_price": 67,
"max_price": 160,
"product_count": 3932,
"stable_avg_price": null,
"insufficient_sample": false,
"sample_threshold": 5,
"in_stock_count": 2085,
"promo_count": 59
}
],
"resolved": null,
"meta": {
"served_from": "live",
"freshness_seconds": 183587,
"schema_version": "v3",
"computed_at": "2026-11-19T10:23:04.177Z",
"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
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.
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 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}$Response
Brand tracking data