curl --request GET \
--url https://api.syntalic.com/v1/measures/offersimport requests
url = "https://api.syntalic.com/v1/measures/offers"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/measures/offers', 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/offers",
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/offers"
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/offers")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/measures/offers")
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": "allbirds tree runner",
"dropped_terms": null,
"country": "us",
"currency": "USD",
"product_uid": "amazon:B0DQBPR2ZN",
"entity_uid": "c603fd0ce3c0a71d6e1e13e7d052cf5f",
"scope": "entity",
"member_count": 27,
"match_suspect": false,
"retailers_compared": 3,
"resolved_product": {
"product_uid": "amazon:B0DQBPR2ZN",
"entity_uid": "c603fd0ce3c0a71d6e1e13e7d052cf5f",
"scope": "entity",
"member_count": 27,
"match_suspect": false,
"product_name": "Allbirds Womens Tree Runner Nz",
"brand": "Allbirds",
"retailer": "amazon",
"product_type": "Sneakers",
"category_path": "apparel-accessories/shoes/sneakers",
"condition": "new",
"image_url": "https://m.media-amazon.com/images/I/61xoVG7eyJL._AC_SL1500_.jpg",
"description": "Fresh yet familiar, the new Tree Runner NZ has the supremely comfortable feel of the Tree Runner and a refined look that sets it apart. Luxe details include debossed branding, a sleek one-piece upper,",
"description_chars": 246,
"description_truncated": false
},
"gpc": {
"code": "10001070",
"title": "Athletic Footwear - General Purpose",
"level": "brick",
"segment": "Footwear",
"family": "Footwear",
"class": "Athletic Footwear",
"brick": "Athletic Footwear - General Purpose",
"match_precision": "narrowerThan",
"match_source": "self"
},
"brand_presence": {
"brand": {
"id": "brand:b_4afed26c712ad555",
"norm": "allbirds",
"label": "Allbirds"
},
"country": "us",
"carried_at": [
{
"store": "allbirds",
"label": "allbirds.com",
"own_store": true,
"kind": "storefront",
"n_brands": 1,
"listings": 7868,
"entities": 294,
"last_seen_at": "2026-11-17T07:23:16.269Z"
}
],
"n_carried_at": 3,
"not_observed_at": [
{
"store": "walmart",
"label": "Walmart",
"kind": "retailer",
"n_brands": 2286
}
],
"n_not_observed_at": 20,
"n_retailers_scanned": 23,
"n_storefronts_left_out": 25,
"basis": "chains with a priced listing on the shelves holding at least 5% of this brand's products; a chain is listed as not observed only if it is one of those and carries none of the brand; a chain that carri"
},
"similar_products": [
{
"entity_uid": "c55a603fd9d22f9379c691b620dc197f",
"name": "Women's Courier Sneakers",
"brand": "Allbirds",
"category_path": "clothing-shoes-jewelry/women/shoes/fashion-sneakers",
"rank": 1,
"comp_score": 0.8672,
"price_ratio": 1.02,
"within_price_band": true,
"same_brand": true,
"same_product_type": true
}
],
"best_price": {
"product_uid": "shopify:4870547963984:33179620900944",
"entity_uid": "c603fd0ce3c0a71d6e1e13e7d052cf5f",
"product_name": "Women's Tree Runner - Jet Black (White Sole)",
"display_title": "Women's Tree Runner - Jet Black (White Sole) — 6",
"variant_label": "6",
"retailer": "shopify",
"price": 50,
"list_price": 100,
"store": "allbirds",
"seller": "allbirds.com",
"store_basis": "seller",
"url": "https://allbirds.com/products/womens-tree-runners-jet-black-white?variant=33179620900944",
"lane": "shopify",
"barcode": null,
"pack_count": null,
"unit_size": null,
"unit_measure": null,
"unit_price": null,
"price_changed_at": "2026-11-17T07:23:16.269Z",
"previous_price": 100,
"list_price_changed_at": "2026-11-17T07:23:16.269Z",
"previous_list_price": null,
"standard_unit": null,
"standard_unit_price": null,
"savings_pct": 50,
"in_stock": true,
"condition": "new",
"match_type": "entity",
"scraped_at": "2026-11-17T07:23:16.269Z",
"price_observed_at": "2026-11-17T07:23:16.269Z",
"last_read_at": "2026-11-17T07:23:16.269Z",
"age_days": 2,
"current": true,
"price_suspect": null,
"fresh": true
},
"stale_offers": 0,
"per_unit": {
"floor": {
"min_rows": 3,
"min_share_pct": 30
},
"count": {
"unit": "count",
"status": "not_enough_data",
"median": null,
"rows": 1,
"of": 26,
"share_pct": 3.8,
"outliers_dropped": 0,
"cheapest": null
},
"size": []
},
"other_prices": [
{
"product_uid": "shopify:4870548062288:33179621195856",
"entity_uid": "c603fd0ce3c0a71d6e1e13e7d052cf5f",
"retailer": "shopify",
"product_name": "Women's Tree Runner - Navy Night (White Sole)",
"display_title": "Women's Tree Runner - Navy Night (White Sole) — 5",
"variant_label": "5",
"price": 50,
"store": "allbirds",
"seller": "allbirds.com",
"store_basis": "seller",
"url": "https://allbirds.com/products/womens-tree-runners-navy-night?variant=33179621195856",
"lane": "shopify",
"barcode": null,
"pack_count": null,
"unit_size": null,
"unit_measure": null,
"unit_price": null,
"price_changed_at": "2026-11-17T07:23:16.269Z",
"previous_price": 100,
"list_price_changed_at": "2026-11-17T07:23:16.269Z",
"previous_list_price": null,
"standard_unit": null,
"standard_unit_price": null,
"in_stock": true,
"condition": "new",
"match_type": "entity",
"observed_at": "2026-11-17T07:23:16.269Z",
"price_observed_at": "2026-11-17T07:23:16.269Z",
"last_read_at": "2026-11-17T07:23:16.269Z",
"age_days": 2,
"current": true,
"price_suspect": null,
"fresh": true
}
],
"related_matches": [
{
"product_uid": "shopify:6586109395024:39480897142864",
"entity_uid": "4a0cc84bd7b801fb00092a6563451a80",
"retailer": "shopify",
"product_name": "Men's Tree Runner - Wheat (Beige Sole)",
"display_title": "Men's Tree Runner - Wheat (Beige Sole) — 9",
"variant_label": "9",
"price": 70,
"store": "allbirds",
"seller": "allbirds.com",
"store_basis": "seller",
"url": "https://allbirds.com/products/mens-tree-runners-wheat-dark-beige?variant=39480897142864",
"lane": "shopify",
"barcode": null,
"pack_count": null,
"unit_size": null,
"unit_measure": null,
"unit_price": null,
"price_changed_at": "2026-11-17T07:23:16.269Z",
"previous_price": 100,
"list_price_changed_at": "2026-11-17T07:23:16.269Z",
"previous_list_price": null,
"standard_unit": null,
"standard_unit_price": null,
"in_stock": true,
"condition": "new",
"match_type": "title",
"observed_at": "2026-11-17T07:23:16.269Z",
"price_observed_at": "2026-11-17T07:23:16.269Z",
"last_read_at": "2026-11-17T07:23:16.269Z",
"age_days": 2,
"current": true,
"price_suspect": null,
"fresh": true
}
],
"lower_uncompared": null,
"coverage": {
"products": 26,
"sufficient": true,
"counted": "offers compared"
},
"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"
}
}{
"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": {}
}
}Who sells one product, and at what price, now.
Who sells one product, and at what price, now. 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=retailer: the current offers for one product across retailers, cheapest first, answered by /v1/shopper/best-price.
curl --request GET \
--url https://api.syntalic.com/v1/measures/offersimport requests
url = "https://api.syntalic.com/v1/measures/offers"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/measures/offers', 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/offers",
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/offers"
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/offers")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/measures/offers")
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": "allbirds tree runner",
"dropped_terms": null,
"country": "us",
"currency": "USD",
"product_uid": "amazon:B0DQBPR2ZN",
"entity_uid": "c603fd0ce3c0a71d6e1e13e7d052cf5f",
"scope": "entity",
"member_count": 27,
"match_suspect": false,
"retailers_compared": 3,
"resolved_product": {
"product_uid": "amazon:B0DQBPR2ZN",
"entity_uid": "c603fd0ce3c0a71d6e1e13e7d052cf5f",
"scope": "entity",
"member_count": 27,
"match_suspect": false,
"product_name": "Allbirds Womens Tree Runner Nz",
"brand": "Allbirds",
"retailer": "amazon",
"product_type": "Sneakers",
"category_path": "apparel-accessories/shoes/sneakers",
"condition": "new",
"image_url": "https://m.media-amazon.com/images/I/61xoVG7eyJL._AC_SL1500_.jpg",
"description": "Fresh yet familiar, the new Tree Runner NZ has the supremely comfortable feel of the Tree Runner and a refined look that sets it apart. Luxe details include debossed branding, a sleek one-piece upper,",
"description_chars": 246,
"description_truncated": false
},
"gpc": {
"code": "10001070",
"title": "Athletic Footwear - General Purpose",
"level": "brick",
"segment": "Footwear",
"family": "Footwear",
"class": "Athletic Footwear",
"brick": "Athletic Footwear - General Purpose",
"match_precision": "narrowerThan",
"match_source": "self"
},
"brand_presence": {
"brand": {
"id": "brand:b_4afed26c712ad555",
"norm": "allbirds",
"label": "Allbirds"
},
"country": "us",
"carried_at": [
{
"store": "allbirds",
"label": "allbirds.com",
"own_store": true,
"kind": "storefront",
"n_brands": 1,
"listings": 7868,
"entities": 294,
"last_seen_at": "2026-11-17T07:23:16.269Z"
}
],
"n_carried_at": 3,
"not_observed_at": [
{
"store": "walmart",
"label": "Walmart",
"kind": "retailer",
"n_brands": 2286
}
],
"n_not_observed_at": 20,
"n_retailers_scanned": 23,
"n_storefronts_left_out": 25,
"basis": "chains with a priced listing on the shelves holding at least 5% of this brand's products; a chain is listed as not observed only if it is one of those and carries none of the brand; a chain that carri"
},
"similar_products": [
{
"entity_uid": "c55a603fd9d22f9379c691b620dc197f",
"name": "Women's Courier Sneakers",
"brand": "Allbirds",
"category_path": "clothing-shoes-jewelry/women/shoes/fashion-sneakers",
"rank": 1,
"comp_score": 0.8672,
"price_ratio": 1.02,
"within_price_band": true,
"same_brand": true,
"same_product_type": true
}
],
"best_price": {
"product_uid": "shopify:4870547963984:33179620900944",
"entity_uid": "c603fd0ce3c0a71d6e1e13e7d052cf5f",
"product_name": "Women's Tree Runner - Jet Black (White Sole)",
"display_title": "Women's Tree Runner - Jet Black (White Sole) — 6",
"variant_label": "6",
"retailer": "shopify",
"price": 50,
"list_price": 100,
"store": "allbirds",
"seller": "allbirds.com",
"store_basis": "seller",
"url": "https://allbirds.com/products/womens-tree-runners-jet-black-white?variant=33179620900944",
"lane": "shopify",
"barcode": null,
"pack_count": null,
"unit_size": null,
"unit_measure": null,
"unit_price": null,
"price_changed_at": "2026-11-17T07:23:16.269Z",
"previous_price": 100,
"list_price_changed_at": "2026-11-17T07:23:16.269Z",
"previous_list_price": null,
"standard_unit": null,
"standard_unit_price": null,
"savings_pct": 50,
"in_stock": true,
"condition": "new",
"match_type": "entity",
"scraped_at": "2026-11-17T07:23:16.269Z",
"price_observed_at": "2026-11-17T07:23:16.269Z",
"last_read_at": "2026-11-17T07:23:16.269Z",
"age_days": 2,
"current": true,
"price_suspect": null,
"fresh": true
},
"stale_offers": 0,
"per_unit": {
"floor": {
"min_rows": 3,
"min_share_pct": 30
},
"count": {
"unit": "count",
"status": "not_enough_data",
"median": null,
"rows": 1,
"of": 26,
"share_pct": 3.8,
"outliers_dropped": 0,
"cheapest": null
},
"size": []
},
"other_prices": [
{
"product_uid": "shopify:4870548062288:33179621195856",
"entity_uid": "c603fd0ce3c0a71d6e1e13e7d052cf5f",
"retailer": "shopify",
"product_name": "Women's Tree Runner - Navy Night (White Sole)",
"display_title": "Women's Tree Runner - Navy Night (White Sole) — 5",
"variant_label": "5",
"price": 50,
"store": "allbirds",
"seller": "allbirds.com",
"store_basis": "seller",
"url": "https://allbirds.com/products/womens-tree-runners-navy-night?variant=33179621195856",
"lane": "shopify",
"barcode": null,
"pack_count": null,
"unit_size": null,
"unit_measure": null,
"unit_price": null,
"price_changed_at": "2026-11-17T07:23:16.269Z",
"previous_price": 100,
"list_price_changed_at": "2026-11-17T07:23:16.269Z",
"previous_list_price": null,
"standard_unit": null,
"standard_unit_price": null,
"in_stock": true,
"condition": "new",
"match_type": "entity",
"observed_at": "2026-11-17T07:23:16.269Z",
"price_observed_at": "2026-11-17T07:23:16.269Z",
"last_read_at": "2026-11-17T07:23:16.269Z",
"age_days": 2,
"current": true,
"price_suspect": null,
"fresh": true
}
],
"related_matches": [
{
"product_uid": "shopify:6586109395024:39480897142864",
"entity_uid": "4a0cc84bd7b801fb00092a6563451a80",
"retailer": "shopify",
"product_name": "Men's Tree Runner - Wheat (Beige Sole)",
"display_title": "Men's Tree Runner - Wheat (Beige Sole) — 9",
"variant_label": "9",
"price": 70,
"store": "allbirds",
"seller": "allbirds.com",
"store_basis": "seller",
"url": "https://allbirds.com/products/mens-tree-runners-wheat-dark-beige?variant=39480897142864",
"lane": "shopify",
"barcode": null,
"pack_count": null,
"unit_size": null,
"unit_measure": null,
"unit_price": null,
"price_changed_at": "2026-11-17T07:23:16.269Z",
"previous_price": 100,
"list_price_changed_at": "2026-11-17T07:23:16.269Z",
"previous_list_price": null,
"standard_unit": null,
"standard_unit_price": null,
"in_stock": true,
"condition": "new",
"match_type": "title",
"observed_at": "2026-11-17T07:23:16.269Z",
"price_observed_at": "2026-11-17T07:23:16.269Z",
"last_read_at": "2026-11-17T07:23:16.269Z",
"age_days": 2,
"current": true,
"price_suspect": null,
"fresh": true
}
],
"lower_uncompared": null,
"coverage": {
"products": 26,
"sufficient": true,
"counted": "offers compared"
},
"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"
}
}{
"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.
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 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
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.