curl --request GET \
--url https://api.syntalic.com/v1/measures/signalsimport requests
url = "https://api.syntalic.com/v1/measures/signals"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/measures/signals', 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/signals",
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/signals"
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/signals")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/measures/signals")
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",
"brand": null,
"window_days": 90,
"platform": "all",
"organic_only": false,
"brands": [
{
"brand_key": "oreo",
"brand": "Oreo",
"signal_posts": 2,
"launch_posts": 2,
"review_posts": 0,
"stance_positive": 0,
"stance_negative": 0,
"stance_neutral": 0,
"stance_questioning": 0,
"retailer_posts": 0,
"retailers": [],
"other_retailer_posts": 0,
"exclusive_retailers": [],
"price_posts": 0,
"price_min": null,
"price_median": null,
"price_max": null,
"attributes": [],
"event_posts": 0,
"roundup_posts": 0,
"recommend_posts": 16,
"neutral_posts": 27,
"mixed_posts": 2,
"criticise_posts": 0,
"topic_read_posts": 0,
"topic_posts": 0,
"topics": []
},
{
"brand_key": "starbucks",
"brand": "Starbucks",
"signal_posts": 11,
"launch_posts": 8,
"review_posts": 0,
"stance_positive": 0,
"stance_negative": 0,
"stance_neutral": 0,
"stance_questioning": 0,
"retailer_posts": 4,
"retailers": [],
"other_retailer_posts": 4,
"exclusive_retailers": [],
"price_posts": 1,
"price_min": "12.39",
"price_median": "12.39",
"price_max": "12.39",
"attributes": [],
"event_posts": 0,
"roundup_posts": 2,
"recommend_posts": 17,
"neutral_posts": 25,
"mixed_posts": 2,
"criticise_posts": 0,
"topic_read_posts": 0,
"topic_posts": 0,
"topics": []
}
],
"coverage": {
"products": 263,
"sufficient": true,
"counted": "brands",
"field_coverage": {
"creator_stance": {
"brands": 262
},
"carousel_stance": {
"brands": 8,
"superseded_by": [
"recommend_posts",
"neutral_posts"
]
},
"topics": {
"brands": 0,
"reason": "not_published"
},
"attributes": {
"brands": 2,
"reason": "below_min",
"min": 3
},
"retailers": {
"brands": 52
},
"prices": {
"brands": 9
}
},
"signals_note": "`field_coverage` counts, for each group of fields, the brands in this scope that have any value in it, with a `reason` when that is none or few: read it before reading an empty field on a row. `not_pu"
},
"freshness": {
"observedThrough": "2026-11-16T06:26:37.000Z",
"staleHours": 75.7
},
"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-19T10:08:04.238Z"
}
}{
"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": {}
}
}What posts say, as labels: launches, reviews, stance, names, practices.
What posts say, as labels: launches, reviews, stance, names, practices. 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: launches, reviews, stance, retailers and prices posts attach to each brand, answered by /v1/social/brand-signals. by=product_name: product names read off posts that match no catalog product, answered by /v1/social/product-names. by=practice: the marketing practices creators describe brands using, answered by /v1/social/tactics.
curl --request GET \
--url https://api.syntalic.com/v1/measures/signalsimport requests
url = "https://api.syntalic.com/v1/measures/signals"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.syntalic.com/v1/measures/signals', 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/signals",
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/signals"
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/signals")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syntalic.com/v1/measures/signals")
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",
"brand": null,
"window_days": 90,
"platform": "all",
"organic_only": false,
"brands": [
{
"brand_key": "oreo",
"brand": "Oreo",
"signal_posts": 2,
"launch_posts": 2,
"review_posts": 0,
"stance_positive": 0,
"stance_negative": 0,
"stance_neutral": 0,
"stance_questioning": 0,
"retailer_posts": 0,
"retailers": [],
"other_retailer_posts": 0,
"exclusive_retailers": [],
"price_posts": 0,
"price_min": null,
"price_median": null,
"price_max": null,
"attributes": [],
"event_posts": 0,
"roundup_posts": 0,
"recommend_posts": 16,
"neutral_posts": 27,
"mixed_posts": 2,
"criticise_posts": 0,
"topic_read_posts": 0,
"topic_posts": 0,
"topics": []
},
{
"brand_key": "starbucks",
"brand": "Starbucks",
"signal_posts": 11,
"launch_posts": 8,
"review_posts": 0,
"stance_positive": 0,
"stance_negative": 0,
"stance_neutral": 0,
"stance_questioning": 0,
"retailer_posts": 4,
"retailers": [],
"other_retailer_posts": 4,
"exclusive_retailers": [],
"price_posts": 1,
"price_min": "12.39",
"price_median": "12.39",
"price_max": "12.39",
"attributes": [],
"event_posts": 0,
"roundup_posts": 2,
"recommend_posts": 17,
"neutral_posts": 25,
"mixed_posts": 2,
"criticise_posts": 0,
"topic_read_posts": 0,
"topic_posts": 0,
"topics": []
}
],
"coverage": {
"products": 263,
"sufficient": true,
"counted": "brands",
"field_coverage": {
"creator_stance": {
"brands": 262
},
"carousel_stance": {
"brands": 8,
"superseded_by": [
"recommend_posts",
"neutral_posts"
]
},
"topics": {
"brands": 0,
"reason": "not_published"
},
"attributes": {
"brands": 2,
"reason": "below_min",
"min": 3
},
"retailers": {
"brands": 52
},
"prices": {
"brands": 9
}
},
"signals_note": "`field_coverage` counts, for each group of fields, the brands in this scope that have any value in it, with a `reason` when that is none or few: read it before reading an empty field on a row. `not_pu"
},
"freshness": {
"observedThrough": "2026-11-16T06:26:37.000Z",
"staleHours": 75.7
},
"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-19T10:08:04.238Z"
}
}{
"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.
Only this practice, by its vocabulary id.
restock_as_launch, launch_arc, collab_arc, founder_letter, recipe_click_through, calendar_content, soft_sell_guide, discount_in_hero, offer_steps, immersive_hero, buttons_above_fold, category_buttons, final_cta, bright_visuals, editorial_layout, stated_cadence, retail_ready_first, mid_tier_first, buyer_timelines, door_by_door, retailer_discovery_event, long_supplier_list, pitch_like_investor, preorder_list, build_in_public, launch_event_creators, channel_ladder, named_series, founder_on_camera, questions_to_content, gifting_not_paid, content_system, per_buyer_pages, homepage_headline, origin_story_research, packaging_for_use, founder_handles_service 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.