How much evidence stands behind ids, and what was looked at
curl --request GET \
--url https://api.syntalic.com/v1/ontology/coverageimport requests
url = "https://api.syntalic.com/v1/ontology/coverage"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/ontology/coverage', 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/ontology/coverage",
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/ontology/coverage"
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/ontology/coverage")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/ontology/coverage")
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": [
{
"id": "spt:fb-2-17-2-4",
"country": "us",
"kind": "category",
"label": "Food, Beverages & Tobacco > Food Items > Snack Foods > Cereal & Granola Bars > Protein Bars",
"found": true,
"coverage": {
"listings": 232,
"entities": 164,
"brands": 45,
"retailers": 25,
"priced": 232,
"fresh_24h": 0,
"fresh_7d": 60,
"fresh_7d_pct": 25.9,
"last_observed_at": "2026-11-17T07:23:19.919Z",
"channels_present": [
"ecommerce"
],
"channels_not_observed": [
"physical_store"
],
"priced_by_channel": {
"ecommerce": 232
},
"retailers_scanned": [
"afarfoods",
"alaninu"
],
"n_retailers_scanned": 25,
"social": {
"mentions": 2,
"creators": 2
}
},
"suggested_next_calls": [
{
"tool": "ontology_neighbors",
"route": "/v1/ontology/neighbors",
"method": "GET",
"args": {
"id": "spt:fb-2-17-2-4"
},
"price_usd": 0.01,
"why": "siblings, top brands and retailers on the shelf"
},
{
"tool": "price_dispersion",
"route": "/v1/analyst/price-dispersion",
"method": "GET",
"args": {
"spt": "spt:fb-2-17-2-4"
},
"price_usd": 0.02,
"why": "how prices are spread across the shelf"
}
]
}
],
"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": {}
}
}Ontology
How much evidence stands behind ids, and what was looked at
The denominators of an absence claim: listings, freshness, the channels present and not observed, and the chains scanned. “Not seen at X” may be said only when X is in retailers_scanned; a chain outside it is unknown, not absent. retailer= asks one brand-and-chain question: seen there, scanned and not seen, or not scanned. A well-formed id that names nothing is found: false, not an error. coverage.social carries the 30-day social mention count for a shelf, a product type’s shelves or a brand, when the rollup has one: the count the social calls in suggested_next_calls are decided on. One cent a call, no key: pay the 402 like any other route.
GET
/
v1
/
ontology
/
coverage
How much evidence stands behind ids, and what was looked at
curl --request GET \
--url https://api.syntalic.com/v1/ontology/coverageimport requests
url = "https://api.syntalic.com/v1/ontology/coverage"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/ontology/coverage', 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/ontology/coverage",
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/ontology/coverage"
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/ontology/coverage")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/ontology/coverage")
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": [
{
"id": "spt:fb-2-17-2-4",
"country": "us",
"kind": "category",
"label": "Food, Beverages & Tobacco > Food Items > Snack Foods > Cereal & Granola Bars > Protein Bars",
"found": true,
"coverage": {
"listings": 232,
"entities": 164,
"brands": 45,
"retailers": 25,
"priced": 232,
"fresh_24h": 0,
"fresh_7d": 60,
"fresh_7d_pct": 25.9,
"last_observed_at": "2026-11-17T07:23:19.919Z",
"channels_present": [
"ecommerce"
],
"channels_not_observed": [
"physical_store"
],
"priced_by_channel": {
"ecommerce": 232
},
"retailers_scanned": [
"afarfoods",
"alaninu"
],
"n_retailers_scanned": 25,
"social": {
"mentions": 2,
"creators": 2
}
},
"suggested_next_calls": [
{
"tool": "ontology_neighbors",
"route": "/v1/ontology/neighbors",
"method": "GET",
"args": {
"id": "spt:fb-2-17-2-4"
},
"price_usd": 0.01,
"why": "siblings, top brands and retailers on the shelf"
},
{
"tool": "price_dispersion",
"route": "/v1/analyst/price-dispersion",
"method": "GET",
"args": {
"spt": "spt:fb-2-17-2-4"
},
"price_usd": 0.02,
"why": "how prices are spread across the shelf"
}
]
}
],
"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
Response
The answer, naming the vocabulary release it came from