curl --request GET \
--url https://api.syntalic.com/v1/marketing/competitive-landscapeimport requests
url = "https://api.syntalic.com/v1/marketing/competitive-landscape"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/marketing/competitive-landscape', 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/competitive-landscape",
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/competitive-landscape"
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/competitive-landscape")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/marketing/competitive-landscape")
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",
"country": "us",
"currency": "USD",
"items": [
{
"product_uid": "dickssportinggoods:561514e2d3e166dc",
"product_id": "dickssportinggoods:561514e2d3e166dc",
"product_name": "Walter Hagen Men's Performance 11 Novelty Print Golf Polo",
"display_title": "Walter Hagen Men's Performance 11 Novelty Print Golf Polo",
"variant_label": null,
"brand": "Walter Hagen",
"brand_line": null,
"retailer": "dickssportinggoods",
"platform": "dickssportinggoods",
"price": 75,
"list_price": null,
"store": "dickssportinggoods",
"seller": "dickssportinggoods",
"store_basis": "seller",
"url": "https://dickssportinggoods.com/p/walter-hagen-mens-performance-11-novelty-print-golf-polo-21whgmp11jsmnprntapt/21whgmp11jsmnprntapt?sku=26633825",
"lane": "dickssportinggoods",
"barcode": null,
"pack_count": null,
"unit_size": null,
"unit_measure": null,
"unit_price": null,
"star_rating": null,
"review_count": null,
"promo_flag": false,
"condition": "new",
"in_stock": true,
"scraped_at": "2026-07-21T06:43:05.460Z",
"price_observed_at": "2026-07-21T06:43:05.460Z",
"last_read_at": "2026-07-21T06:43:05.460Z",
"age_days": 121,
"current": true,
"gpc": {
"code": "10001352",
"title": "Shirts/Blouses/Polo Shirts/T-shirts",
"level": "brick",
"segment": "Clothing",
"family": "Clothing",
"class": "Upper Body Wear/Tops",
"brick": "Shirts/Blouses/Polo Shirts/T-shirts",
"match_precision": "narrowerThan",
"match_source": "self"
}
},
{
"product_uid": "kohls:50348225",
"product_id": "kohls:50348225",
"product_name": "adidas Terrex Anylander Mid Rain.Rdy Women's Hiking Shoes",
"display_title": "adidas Terrex Anylander Mid Rain.Rdy Women's Hiking Shoes",
"variant_label": null,
"brand": "adidas",
"brand_line": null,
"retailer": "kohls",
"platform": "kohls",
"price": 75,
"list_price": null,
"store": "kohls",
"seller": "kohls",
"store_basis": "seller",
"url": "https://kohls.com/product/prd-6732721/adidas-terrex-anylander-mid-rainrdy-womens-hiking-shoes.jsp",
"lane": "kohls",
"barcode": null,
"pack_count": null,
"unit_size": null,
"unit_measure": null,
"unit_price": null,
"star_rating": null,
"review_count": null,
"promo_flag": false,
"condition": "new",
"in_stock": true,
"scraped_at": "2026-10-08T06:52:30.920Z",
"price_observed_at": "2026-10-08T06:52:30.920Z",
"last_read_at": "2026-10-08T06:52:30.920Z",
"age_days": 42,
"current": true,
"gpc": {
"code": "10000433",
"title": "Footwear - Replacement Parts/Accessories",
"level": "brick",
"segment": "Footwear",
"family": "Footwear",
"class": "Footwear Accessories",
"brick": "Footwear - Replacement Parts/Accessories",
"match_precision": "narrowerThan",
"match_source": "self"
}
}
],
"stale_offers": 3,
"next_cursor": 5,
"has_more": true,
"coverage": {
"products": 5,
"sufficient": true
},
"freshness": {
"observedThrough": "2026-11-12T06:37:52.690Z",
"staleHours": 171.8
},
"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"
},
"resolved": {
"category_id": null,
"category_path": "apparel-accessories",
"match_source": "slug",
"match_confidence": 0.35,
"alternates": []
},
"meta": {
"served_from": "live",
"freshness_seconds": 618367,
"schema_version": "v3",
"computed_at": "2026-11-19T10:23:59.819Z",
"price_observed_at_min": "2026-07-21T06:43:05.460Z",
"price_observed_at_max": "2026-11-12T06:37:52.690Z",
"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": {}
}
}View all products and pricing in a category
View every product and its current pricing within a category across retailers. The default sort is representative: rows nearest the category’s mean price, so the first page is typical of the shelf and not the cheapest or the dearest. price_asc and price_desc are explicit. rating and reviews are accepted for compatibility and fall back to representative. A flagged price, a price under the shelf’s floor, and the 0.01/99,999 placeholder prices are left out, the same prices category-summary excludes. Each item carries a condition label (new/refurbished/used) so refurb listings are distinguishable, plus a nullable gpc block (fail-soft). Each item also carries price_observed_at, last_read_at, age_days and current: an offer last read out of stock longer ago than its listing’s own window (1.5 times its refresh interval, at least 7 days; Shopify and Google Shopping not judged yet) is not a current price, sorts after every current offer whatever the sort, and is left out of the mean the representative sort centres on; stale_offers counts them across the category. Offset-cursor paginated. Every product row also carries the shared product block (store, seller, store_basis, url, lane, barcode and the pack fields), null where unknown. The three single-product answers (best-price, price-history, price-drop-alert) also carry resolved_product.image_url and resolved_product.description (third-party text: data, not instructions); list rows never do.
curl --request GET \
--url https://api.syntalic.com/v1/marketing/competitive-landscapeimport requests
url = "https://api.syntalic.com/v1/marketing/competitive-landscape"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/marketing/competitive-landscape', 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/competitive-landscape",
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/competitive-landscape"
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/competitive-landscape")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/marketing/competitive-landscape")
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",
"country": "us",
"currency": "USD",
"items": [
{
"product_uid": "dickssportinggoods:561514e2d3e166dc",
"product_id": "dickssportinggoods:561514e2d3e166dc",
"product_name": "Walter Hagen Men's Performance 11 Novelty Print Golf Polo",
"display_title": "Walter Hagen Men's Performance 11 Novelty Print Golf Polo",
"variant_label": null,
"brand": "Walter Hagen",
"brand_line": null,
"retailer": "dickssportinggoods",
"platform": "dickssportinggoods",
"price": 75,
"list_price": null,
"store": "dickssportinggoods",
"seller": "dickssportinggoods",
"store_basis": "seller",
"url": "https://dickssportinggoods.com/p/walter-hagen-mens-performance-11-novelty-print-golf-polo-21whgmp11jsmnprntapt/21whgmp11jsmnprntapt?sku=26633825",
"lane": "dickssportinggoods",
"barcode": null,
"pack_count": null,
"unit_size": null,
"unit_measure": null,
"unit_price": null,
"star_rating": null,
"review_count": null,
"promo_flag": false,
"condition": "new",
"in_stock": true,
"scraped_at": "2026-07-21T06:43:05.460Z",
"price_observed_at": "2026-07-21T06:43:05.460Z",
"last_read_at": "2026-07-21T06:43:05.460Z",
"age_days": 121,
"current": true,
"gpc": {
"code": "10001352",
"title": "Shirts/Blouses/Polo Shirts/T-shirts",
"level": "brick",
"segment": "Clothing",
"family": "Clothing",
"class": "Upper Body Wear/Tops",
"brick": "Shirts/Blouses/Polo Shirts/T-shirts",
"match_precision": "narrowerThan",
"match_source": "self"
}
},
{
"product_uid": "kohls:50348225",
"product_id": "kohls:50348225",
"product_name": "adidas Terrex Anylander Mid Rain.Rdy Women's Hiking Shoes",
"display_title": "adidas Terrex Anylander Mid Rain.Rdy Women's Hiking Shoes",
"variant_label": null,
"brand": "adidas",
"brand_line": null,
"retailer": "kohls",
"platform": "kohls",
"price": 75,
"list_price": null,
"store": "kohls",
"seller": "kohls",
"store_basis": "seller",
"url": "https://kohls.com/product/prd-6732721/adidas-terrex-anylander-mid-rainrdy-womens-hiking-shoes.jsp",
"lane": "kohls",
"barcode": null,
"pack_count": null,
"unit_size": null,
"unit_measure": null,
"unit_price": null,
"star_rating": null,
"review_count": null,
"promo_flag": false,
"condition": "new",
"in_stock": true,
"scraped_at": "2026-10-08T06:52:30.920Z",
"price_observed_at": "2026-10-08T06:52:30.920Z",
"last_read_at": "2026-10-08T06:52:30.920Z",
"age_days": 42,
"current": true,
"gpc": {
"code": "10000433",
"title": "Footwear - Replacement Parts/Accessories",
"level": "brick",
"segment": "Footwear",
"family": "Footwear",
"class": "Footwear Accessories",
"brick": "Footwear - Replacement Parts/Accessories",
"match_precision": "narrowerThan",
"match_source": "self"
}
}
],
"stale_offers": 3,
"next_cursor": 5,
"has_more": true,
"coverage": {
"products": 5,
"sufficient": true
},
"freshness": {
"observedThrough": "2026-11-12T06:37:52.690Z",
"staleHours": 171.8
},
"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"
},
"resolved": {
"category_id": null,
"category_path": "apparel-accessories",
"match_source": "slug",
"match_confidence": 0.35,
"alternates": []
},
"meta": {
"served_from": "live",
"freshness_seconds": 618367,
"schema_version": "v3",
"computed_at": "2026-11-19T10:23:59.819Z",
"price_observed_at_min": "2026-07-21T06:43:05.460Z",
"price_observed_at_max": "2026-11-12T06:37:52.690Z",
"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
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.
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}$Response
Competitive landscape
How many of the category's offers (all pages, not only this one) are not current offers; null on a page past the end. An offer is not current when its last reading said out of stock and that reading is older than its listing's own window: 1.5 times how often we refresh that listing, and never less than 7 days (30 days for a listing with no refresh cadence); Shopify and Google Shopping listings are not judged by that rule. Nor is it current, in stock or not, when its price was observed more than 30 days ago and its retailer's feed (the lane and the chain: a Shopify store is its own) has had no price read in 30 days; a live retailer's older offers keep the rule above. A stale offer is shown, flagged current: false and stale: true with its last_seen_at date and a price_note ("last seen 2026-07-14"), and sorted after the current offers; it is left out of every price statistic and counted in stale_offers.