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:

industryoptional, up to 80 charactersThe prospect's industry, e.g. grocery.
roleoptional, up to 80 charactersTheir role, e.g. category manager.
topicoptional, up to 120 charactersWhat the email, ad or slide is about, e.g. new brands.
limitoptional, 1 to 25, default 5How many stats.
sinceoptional, YYYY-MM-DDOnly 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
}
  • line is the stat, the headline and the source as one line to paste, without changing a word.
  • best is the first stat on its own, or null, for tools that read one field.
  • stat is the card's own stat, or null; it is not always a bare number ("3 in 5").
  • card_url opens the card in GatherHQ, for people in your workspace.
  • With no stats, note says why.

Use it in Clay

  1. In your table, click Add enrichment, search for HTTP API, and open the Configure tab.
  2. Method GET, Endpoint URL https://synthetic.gatherhq.com/api/v1/stats.
  3. Query string parameters: industry as /Industry, role as /Job Title, topic as your campaign's topic, and limit as 1.
  4. Under Select header account, click + Add account and add Authorization with Bearer <your GatherHQ API key> under API Request Headers, then save it, so the key is not shown in the column.
  5. Field paths to return: best.line, or best.stat, best.headline and best.source for separate columns.
  6. Set rate limiting to 5 requests per 1000 ms, click Test on one row, then run the column.

Errors and limits

400 invalid_requestA parameter to fix; the message names it.
401A missing, bad or revoked key.
403The person behind the key can no longer open the workspace.
429 rate_limitedThe 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_errorGatherHQ could not find stats; the message says why. Retry shortly.
503Retry 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.