Skip to main content
GET
List a keyword's mentions

Authorizations

x-api-key
string
header
required

API key created from the Nephia dashboard for your Account.

Path Parameters

id
string<uuid>
required

Query Parameters

since
string<date-time>
until
string<date-time>

ISO-8601 upper bound on occurredAt — the date Nephia collected the mention, not the date it was published. Inclusive. Absent means the window is open at the top. With since, this is a closed interval — ?since=2026-08-03T00:00:00Z&until=2026-08-05T23:59:59Z is those three days and nothing else.

limit
integer
Required range: 1 <= x <= 100
cursor
string
Minimum string length: 1
source
Available options:
x,
reddit,
youtube,
tiktok,
bluesky,
hackernews,
mastodon,
lemmy,
github,
producthunt,
stackoverflow,
rss,
ai_answers,
vinted
q
string
Required string length: 1 - 120
mode
enum<string>
Available options:
text,
semantic
bucket
Allowed value: "uncategorised"
intent
Available options:
purchase_intent,
comparison,
question,
complaint,
praise,
other,
unread
sentiment
Available options:
positive,
neutral,
negative,
question,
mixed,
unread
relevance
Available options:
high,
medium,
low,
unread
opportunity
enum<string>

true keeps only opportunities: mentions of a topic or competitor keyword that are highly relevant to it and whose author is someone to answer. On a keyword whose agent step has a boolean problem_fit field, that is problem_fit: true under the current step; on any other, an intent of purchase_intent, comparison or question. An own keyword has none. Free.

Available options:
true,
false
Example:

"true"

engagement_min
integer
Required range: x >= 0
engagement
Required string length: 1 - 120

Response

Mentions

since
string
required
keyword
object
required
enabledSources
enum<string>[]
required
Available options:
x,
reddit,
youtube,
tiktok,
bluesky,
hackernews,
mastodon,
lemmy,
github,
producthunt,
stackoverflow,
rss,
ai_answers,
vinted
mentions
object[]
required
until
string
nextCursor
string