GET /v1/mentions (free, across every Source and every keyword) or have it POSTed to you as a signed webhook event. One keyword can carry several terms at once (a brand plus its variants), OR’d into a single upstream request at one tick’s cost. See Keywords.
To start with what a Source already holds, create the keyword with backfill: true (see Day-one backfill).
Sources
Each Source has its own coverage, criteria and event shape. See X, Reddit, Youtube, Bluesky, Hacker News, RSS & News, AI answers, and Vinted. Watching a clothing brand or sourcing resale? Vinted is a first-class Source, with observed price history and market statistics on top of its listings.What the API sells
Keywords and their mentions.POST /v1/keywords sets the monitoring up, GET /v1/mentions reads what it caught, annotated. Reading your own mentions is free; a keyword’s poll ticks are what deduct credits, see Credits. See Keywords.
Alongside them: webhooks, POST /v1/analyses over what your keywords collected, AI-answer runs, and Vinted’s observed price history and market statistics.
History & backfill
A keyword starts recording the moment it exists, and by default it starts empty: the first poll of each Source records what is there without emitting it, and everything after that is news. Two things change that.backfill: true on POST /v1/keywords runs one immediate search per enabled Source
and stores the results as the keyword’s starting history, so GET /v1/keywords/{id}/results
answers with content straight away. It costs one tick per Source at that Source’s
rate, or on X 5 credits plus 3 per tweet returned, at most 65 (see
Credits); it notifies nobody, no webhook and no
channel, and the rows come back with "seeded": true. The default is false: an
API default never spends. More under
Keywords: Day-one backfill.
History beyond the first page is a dashboard gesture. On the Sources whose upstream
can be asked for older items (Hacker News, Reddit, Bluesky, X, GitHub, YouTube, Stack
Overflow, Lemmy and Mastodon), a keyword can be handed its last 60 days, read one page
at a time up to five pages per Source, each page charged one tick, and on X charged per
tweet returned: at most 65 a page and 325 for the whole history. RSS feeds, AI answers
and Vinted listings are not swept: a feed serves what it serves, an answer engine has no
archive, and old listings are inventory rather than mentions. Seeded rows never trigger a
webhook, a channel, a rule or an agent step, and never count toward a spike alert.
Auth
All product API calls use an API key tied to your Account (billing tenant). See Authentication.Limits
What a plan sells is keywords × terms × freshness: how many things you watch, how many terms each search carries, and how often we check (Limits). Credits are the meter underneath, what each call and each tick costs (Credits), plus the per-Account request quota on/v1/*. Credit packs top the meter up and never change a
limit.