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.