Query handles. Get graphs.
curl https://graphs.socialsignal.ai/v1/attention/similar/starbucks
{
"handle": "starbucks",
"domain": "attention",
"version": "2026.01",
"results": [
{ "handle": "upsstore", "title": "The UPS Store", "score": 0.93 },
{ "handle": "coffeeandtea", "title": "Coffee & Tea", "score": 0.93 },
{ "handle": "fedex", "title": "FedEx", "score": 0.92 },
{ "handle": "traderjoes", "title": "Trader Joe's", "score": 0.92 },
{ "handle": "officesupplies", "title": "Office Supplies & Services","score": 0.92 }
],
"latency_ms": 34
}
Two endpoint families.
/similar/{handle} returns entities with similar audience shape.
/affinity/{handle} returns entities your target audience over-indexes on.
Pairwise similarity by handle pair, text resolution, taxonomy, full handle search — all under /v1/attention/.
Handles are permanent. A handle issued today resolves to the same entity in every future version.
Scores are version-pinned. Each response carries its data version. Pin in production; upgrade deliberately.