Skip to main content
GET
List a query'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
engagement_min
integer
Required range: x >= 0
engagement
Required string length: 1 - 120

Response

Mentions

since
string
required
query
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