curl --request GET \
--url https://api.syntalic.com/v1/measures/attentionimport requests
url = "https://api.syntalic.com/v1/measures/attention"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/measures/attention', 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/attention",
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/attention"
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/attention")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/measures/attention")
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": "food-beverages-tobacco",
"subcategory": null,
"axis": "category",
"brand": null,
"window_days": 30,
"platform": "all",
"organic_only": false,
"brands": [
{
"brand_key": "oreo",
"brand": "Oreo",
"mentions": 21,
"views": "967284",
"share_pct": "5.75",
"creators": 5,
"skus": 12,
"growth_pct": "75.00",
"is_new": false,
"prior_mentions": 12,
"thin_base": false,
"rank": 1
},
{
"brand_key": "poppi",
"brand": "poppi",
"mentions": 17,
"views": "165368",
"share_pct": "4.66",
"creators": 8,
"skus": 35,
"growth_pct": "466.67",
"is_new": false,
"prior_mentions": 3,
"thin_base": true,
"rank": 2,
"tied_with": [
3
]
}
],
"left_off_shelf": [
{
"brand_key": "hormbleschormbles",
"brand": "Hormbles Chormbles",
"reason": "refiled",
"filed_under": "health-beauty/health-care/fitness-nutrition/nutrition-bars/protein-bars",
"talked_root": "health-beauty",
"evidence_posts": 3,
"typed_posts": 3,
"mentions": 17
},
{
"brand_key": "starshoney",
"brand": "Stars + Honey",
"reason": "refiled",
"filed_under": "health-beauty/health-care/fitness-nutrition/nutrition-bars/protein-bars",
"talked_root": "health-beauty",
"evidence_posts": 6,
"typed_posts": 7,
"mentions": 10
}
],
"siblings": [],
"thin_base_rows": 16,
"noise_pct": 74.08,
"coverage": {
"products": 151,
"sufficient": true,
"counted": "brands",
"rank_note": "22 of 25 brands sit within 5% of another brand's mention count and carry `tied_with`. That list is PAIRWISE proximity, not an equivalence class: A near B and B near C does not make A near C. Do not re",
"shelf_note": "15 brands are listed in `left_off_shelf`. No mention is dropped: the ones these rows are about are counted on another shelf. `refiled`: the brand's posts name its products on another shelf and the cat"
},
"freshness": {
"observedThrough": "2026-11-16T06:26:37.000Z",
"staleHours": 58.1
},
"snapshot": {
"run_id": "d62295dc-6bb4-4d49-bb56-62432658a10a",
"lens_version": "social-publish-0.7",
"computed_at": "2026-11-16T12:42:25.858Z"
},
"resolved": null,
"meta": {
"served_from": "cache",
"freshness_seconds": null,
"schema_version": "v3",
"computed_at": "2026-11-18T16:35:13.702Z"
}
}{
"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": {}
}
}Share of social conversation, and how it is moving.
Share of social conversation, and how it is moving. 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=brand: each brand’s share of mentions on a shelf, answered by /v1/social/brand-share. by=product: the catalog products a shelf is talking about, answered by /v1/social/product-share. by=category: which subcategories own a shelf’s conversation, answered by /v1/social/category-structure. by=creator: the creators driving a shelf’s conversation, answered by /v1/social/creator-index. by=product_type: attention per product type, and how the mix is shifting, answered by /v1/social/product-type-trends. by=topic: the topics emerging and fading on a shelf, answered by /v1/social/topic-trends. by=momentum: brands ranked by movement: new, rising, falling, answered by /v1/social/brand-momentum. by=emerging: brands creators keep tagging that the catalog does not carry, answered by /v1/social/emerging-brands. by=week: weekly mentions and views for one brand or one shelf, answered by /v1/social/series.
curl --request GET \
--url https://api.syntalic.com/v1/measures/attentionimport requests
url = "https://api.syntalic.com/v1/measures/attention"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/measures/attention', 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/attention",
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/attention"
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/attention")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/measures/attention")
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": "food-beverages-tobacco",
"subcategory": null,
"axis": "category",
"brand": null,
"window_days": 30,
"platform": "all",
"organic_only": false,
"brands": [
{
"brand_key": "oreo",
"brand": "Oreo",
"mentions": 21,
"views": "967284",
"share_pct": "5.75",
"creators": 5,
"skus": 12,
"growth_pct": "75.00",
"is_new": false,
"prior_mentions": 12,
"thin_base": false,
"rank": 1
},
{
"brand_key": "poppi",
"brand": "poppi",
"mentions": 17,
"views": "165368",
"share_pct": "4.66",
"creators": 8,
"skus": 35,
"growth_pct": "466.67",
"is_new": false,
"prior_mentions": 3,
"thin_base": true,
"rank": 2,
"tied_with": [
3
]
}
],
"left_off_shelf": [
{
"brand_key": "hormbleschormbles",
"brand": "Hormbles Chormbles",
"reason": "refiled",
"filed_under": "health-beauty/health-care/fitness-nutrition/nutrition-bars/protein-bars",
"talked_root": "health-beauty",
"evidence_posts": 3,
"typed_posts": 3,
"mentions": 17
},
{
"brand_key": "starshoney",
"brand": "Stars + Honey",
"reason": "refiled",
"filed_under": "health-beauty/health-care/fitness-nutrition/nutrition-bars/protein-bars",
"talked_root": "health-beauty",
"evidence_posts": 6,
"typed_posts": 7,
"mentions": 10
}
],
"siblings": [],
"thin_base_rows": 16,
"noise_pct": 74.08,
"coverage": {
"products": 151,
"sufficient": true,
"counted": "brands",
"rank_note": "22 of 25 brands sit within 5% of another brand's mention count and carry `tied_with`. That list is PAIRWISE proximity, not an equivalence class: A near B and B near C does not make A near C. Do not re",
"shelf_note": "15 brands are listed in `left_off_shelf`. No mention is dropped: the ones these rows are about are counted on another shelf. `refiled`: the brand's posts name its products on another shelf and the cat"
},
"freshness": {
"observedThrough": "2026-11-16T06:26:37.000Z",
"staleHours": 58.1
},
"snapshot": {
"run_id": "d62295dc-6bb4-4d49-bb56-62432658a10a",
"lens_version": "social-publish-0.7",
"computed_at": "2026-11-16T12:42:25.858Z"
},
"resolved": null,
"meta": {
"served_from": "cache",
"freshness_seconds": null,
"schema_version": "v3",
"computed_at": "2026-11-18T16:35:13.702Z"
}
}{
"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.
Shopify taxonomy path, as a join key or a display path: a root (food-beverages-tobacco) or any node under it. A brand is filed at one node and counted there and at every ancestor, so each depth is its own scope. A node no tracked brand sits under is refused free, with the published scopes that contain it. Retired browse roots (grocery-gourmet-food, ...) are refused with the root to use instead.
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.