Stats API
Put a fresh stat from your own customer research in an email step, an ad or a slide, matched to the prospect and with its source line: real interviews, how many people, and when.
Each stat is the stat and headline of one of your workspace's finished social cards, word for word, with the source line to print beside it, the study it came from and a link to the card. Every source is real interviews: only studies with real people make social cards.
Request
GET https://synthetic.gatherhq.com/api/v1/stats?industry=grocery&role=category%20manager&topic=new%20brands&limit=3 Authorization: Bearer <your GatherHQ API key>
Use an API key made in GatherHQ or an agent key, in the Authorization header or as x-api-key, never on the URL. All parameters are optional:
industry | optional, up to 80 characters | The prospect's industry, e.g. grocery. |
role | optional, up to 80 characters | Their role, e.g. category manager. |
topic | optional, up to 120 characters | What the email, ad or slide is about, e.g. new brands. |
limit | optional, 1 to 25, default 5 | How many stats. |
since | optional, YYYY-MM-DD | Only stats from studies that finished on or after this day. |
The words are matched against each card's headline, topic, study and stat. A short word in capitals (IT, HR, CFO) is matched as written, other words by their stem, so "buyers" finds "buyer". A stat that shares no word with the request is left out: a stat that does not fit the prospect is worse in an email than none. With no words, the newest stats come first.
Response
{
"object": "list",
"data": [
{
"object": "stat",
"id": 2201,
"stat": "3 in 5",
"headline": "A trusted recommendation decides whether buyers try a new brand",
"topic": "New brand trial",
"source": "Real interviews · 48 people · Nov 2026",
"line": "3 in 5: A trusted recommendation decides whether buyers try a new brand (Real interviews · 48 people · Nov 2026)",
"people": 48,
"study": { "id": 1201, "name": "How grocery buyers choose a new brand" },
"date": "2026-11-03",
"card_url": "https://app.gatherhq.com/content-library/social-cards/2201?brand_id=9",
"matched": ["grocery", "new", "brands"]
}
],
"best": { "...": "the first stat, or null" },
"available": 6
}lineis the stat, the headline and the source as one line to paste, without changing a word.bestis the first stat on its own, ornull, for tools that read one field.statis the card's own stat, ornull; it is not always a bare number ("3 in 5").card_urlopens the card in GatherHQ, for people in your workspace.- With no stats,
notesays why.
Use it in Clay
- In your table, click Add enrichment, search for HTTP API, and open the Configure tab.
- Method GET, Endpoint URL
https://synthetic.gatherhq.com/api/v1/stats. - Query string parameters:
industryas/Industry,roleas/Job Title,topicas your campaign's topic, andlimitas1. - Under Select header account, click + Add account and add
AuthorizationwithBearer <your GatherHQ API key>under API Request Headers, then save it, so the key is not shown in the column. - Field paths to return:
best.line, orbest.stat,best.headlineandbest.sourcefor separate columns. - Set rate limiting to 5 requests per 1000 ms, click Test on one row, then run the column.
Errors and limits
400 invalid_request | A parameter to fix; the message names it. |
401 | A missing, bad or revoked key. |
403 | The person behind the key can no longer open the workspace. |
429 rate_limited | The key's 2,000 stats requests for the day are used. They reset at 00:00 UTC. A stats request runs nothing, so it uses none of a key's report runs. |
502 upstream_error | GatherHQ could not find stats; the message says why. Retry shortly. |
503 | Retry shortly. |
Also in your AI assistant: the GatherHQ MCP has the same stats as gather_find_stats. Quotes, content and everything else in your workspace: the Tools API.