curl --request GET \
--url https://api.syntalic.com/v1/measures/resolveimport requests
url = "https://api.syntalic.com/v1/measures/resolve"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/measures/resolve', 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/resolve",
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/resolve"
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/resolve")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/measures/resolve")
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{
"results": [
{
"term": "protein bars",
"matches": [
{
"id": "spt:fb-2-17-2-4",
"kind": "category",
"label": "Food, Beverages & Tobacco > Food Items > Snack Foods > Cereal & Granola Bars > Protein Bars",
"how": "alias:node-name",
"key": "food-beverages-tobacco/food-items/snack-foods/cereal-granola-bars/protein-bars",
"name": "Protein Bars",
"depth": 5,
"source": "node-name",
"tier": "exact",
"coverage": {
"listings": 232,
"entities": 164,
"brands": 45,
"retailers": 25,
"priced": 232,
"fresh_24h": 0,
"fresh_7d": 60,
"last_observed_at": "2026-11-17T07:23:19.919Z",
"channels_present": [
"ecommerce"
]
},
"co_equal": [
"spt:hb-1-9-1-3"
]
},
{
"id": "spt:hb-1-9-1-3",
"kind": "category",
"label": "Health & Beauty > Health Care > Fitness & Nutrition > Nutrition Bars > Protein Bars",
"how": "alias:node-name",
"key": "health-beauty/health-care/fitness-nutrition/nutrition-bars/protein-bars",
"name": "Protein Bars",
"depth": 5,
"source": "node-name",
"tier": "exact",
"coverage": {
"listings": 966,
"entities": 595,
"brands": 71,
"retailers": 34,
"priced": 966,
"fresh_24h": 0,
"fresh_7d": 396,
"last_observed_at": "2026-11-17T07:23:19.919Z",
"channels_present": [
"ecommerce"
]
},
"co_equal": [
"spt:fb-2-17-2-4"
]
}
],
"also_ok": [],
"coverage": {
"shelves": 3,
"listings": 1209,
"priced": 1209,
"fresh_7d": 456,
"retailers": 41,
"last_observed_at": "2026-11-17T07:23:19.919Z",
"channels_present": [
"ecommerce"
],
"social": {
"mentions": 12,
"shelves": [
{
"id": "spt:fb-2-17-2-4",
"key": "food-beverages-tobacco/food-items/snack-foods/cereal-granola-bars/protein-bars",
"mentions": 2,
"creators": 2
},
{
"id": "spt:hb-1-9-1-3",
"key": "health-beauty/health-care/fitness-nutrition/nutrition-bars/protein-bars",
"mentions": 10,
"creators": 8
}
]
}
},
"miss": null,
"suggested_next_calls": [
{
"tool": "ontology_neighbors",
"route": "/v1/ontology/neighbors",
"method": "GET",
"args": {
"id": "gpc:10008059"
},
"price_usd": 0.01,
"why": "its shelves, siblings and phrases"
},
{
"tool": "price_dispersion",
"route": "/v1/analyst/price-dispersion",
"method": "GET",
"args": {
"gpc": "gpc:10008059"
},
"price_usd": 0.02,
"why": "how prices are spread across every shelf the type is filed under"
}
]
}
],
"suggested_next_calls": [],
"topics": {
"status": "ok",
"basis": "creator_stated",
"window_days": 30
},
"country": "us",
"vocab": {
"spt_release": "2026-08",
"gpc_publication": "v20260520",
"map_version": "spt-gpc-05ae4409bf35",
"lexicon_version": "lex2-976d6b315235",
"alias_version": "spt-aliases-404b65462b40",
"brand_version": "brands-057783b03cd8",
"published_at": "2026-11-18T07:46:06.583Z"
},
"schema_version": "ontology/1"
}{
"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": "NOT_PUBLISHED",
"message": "<string>",
"details": {}
}
}A name, phrase or code to ids.
A name, phrase or code to ids. 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=name: every shelf, product type, brand and chain a term names, as ids, answered by /v1/ontology/resolve. by=browse_node: Amazon browse node ids or phrases to GS1 GPC codes, answered by /v1/reference/classify. by=gpc_browse_nodes: the browse nodes mapped onto a GPC code, answered by /v1/reference/reverse. by=gpc_attributes: the attributes GS1 defines for a GPC brick, with their allowed values, answered by /v1/reference/brick-attributes.
curl --request GET \
--url https://api.syntalic.com/v1/measures/resolveimport requests
url = "https://api.syntalic.com/v1/measures/resolve"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/measures/resolve', 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/resolve",
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/resolve"
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/resolve")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/measures/resolve")
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{
"results": [
{
"term": "protein bars",
"matches": [
{
"id": "spt:fb-2-17-2-4",
"kind": "category",
"label": "Food, Beverages & Tobacco > Food Items > Snack Foods > Cereal & Granola Bars > Protein Bars",
"how": "alias:node-name",
"key": "food-beverages-tobacco/food-items/snack-foods/cereal-granola-bars/protein-bars",
"name": "Protein Bars",
"depth": 5,
"source": "node-name",
"tier": "exact",
"coverage": {
"listings": 232,
"entities": 164,
"brands": 45,
"retailers": 25,
"priced": 232,
"fresh_24h": 0,
"fresh_7d": 60,
"last_observed_at": "2026-11-17T07:23:19.919Z",
"channels_present": [
"ecommerce"
]
},
"co_equal": [
"spt:hb-1-9-1-3"
]
},
{
"id": "spt:hb-1-9-1-3",
"kind": "category",
"label": "Health & Beauty > Health Care > Fitness & Nutrition > Nutrition Bars > Protein Bars",
"how": "alias:node-name",
"key": "health-beauty/health-care/fitness-nutrition/nutrition-bars/protein-bars",
"name": "Protein Bars",
"depth": 5,
"source": "node-name",
"tier": "exact",
"coverage": {
"listings": 966,
"entities": 595,
"brands": 71,
"retailers": 34,
"priced": 966,
"fresh_24h": 0,
"fresh_7d": 396,
"last_observed_at": "2026-11-17T07:23:19.919Z",
"channels_present": [
"ecommerce"
]
},
"co_equal": [
"spt:fb-2-17-2-4"
]
}
],
"also_ok": [],
"coverage": {
"shelves": 3,
"listings": 1209,
"priced": 1209,
"fresh_7d": 456,
"retailers": 41,
"last_observed_at": "2026-11-17T07:23:19.919Z",
"channels_present": [
"ecommerce"
],
"social": {
"mentions": 12,
"shelves": [
{
"id": "spt:fb-2-17-2-4",
"key": "food-beverages-tobacco/food-items/snack-foods/cereal-granola-bars/protein-bars",
"mentions": 2,
"creators": 2
},
{
"id": "spt:hb-1-9-1-3",
"key": "health-beauty/health-care/fitness-nutrition/nutrition-bars/protein-bars",
"mentions": 10,
"creators": 8
}
]
}
},
"miss": null,
"suggested_next_calls": [
{
"tool": "ontology_neighbors",
"route": "/v1/ontology/neighbors",
"method": "GET",
"args": {
"id": "gpc:10008059"
},
"price_usd": 0.01,
"why": "its shelves, siblings and phrases"
},
{
"tool": "price_dispersion",
"route": "/v1/analyst/price-dispersion",
"method": "GET",
"args": {
"gpc": "gpc:10008059"
},
"price_usd": 0.02,
"why": "how prices are spread across every shelf the type is filed under"
}
]
}
],
"suggested_next_calls": [],
"topics": {
"status": "ok",
"basis": "creator_stated",
"window_days": 30
},
"country": "us",
"vocab": {
"spt_release": "2026-08",
"gpc_publication": "v20260520",
"map_version": "spt-gpc-05ae4409bf35",
"lexicon_version": "lex2-976d6b315235",
"alias_version": "spt-aliases-404b65462b40",
"brand_version": "brands-057783b03cd8",
"published_at": "2026-11-18T07:46:06.583Z"
},
"schema_version": "ontology/1"
}{
"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": "NOT_PUBLISHED",
"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.
A name to resolve: a category, a product type, a brand, a chain, a hashtag. Repeat the parameter for a batch (term=soda&term=olipop), one concept per term and at most 25: terms=a,b is refused, because a comma can sit inside a real name. A marketing practice ('founder letter', 'restock email') resolves to a facet match, and a word creators tag their posts with ('fiber', 'prebiotic soda') to a topic match. Ownership facets such as woman-owned are not served yet: they come back as a miss.
1 - 200An spt or gpc id naming the shelf the question is on. Hits standing in it stay in matches, the rest move to also_ok, and each carries where it stands. It never invents a primary: with no footprint in the scope nothing is promoted (within_applied: false).
(^spt:[a-z]{2}(-[0-9]+)*$)|(^gpc:[0-9]{8}$)Comma-separated product-type phrases to resolve to GPC bricks or classes via the curated lexicon, e.g. 'protein bars' or 'coffee'. Max 100 per request. Only an ASCII comma separates phrases. Certain-or-blank: a phrase the lexicon does not carry returns an empty gpc list plus miss { reason, detail, hint, try, candidates }, never a nearest guess. A class hit includes forms[]. Provide either browse_id or q, not both.
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.