Skip to main content
GET
List mentions

Authorizations

x-api-key
string
header
required

API key created from the Nephia dashboard for your Account.

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
type
enum<string>
Available options:
listing.created,
listing.delisted,
listing.price_changed,
tweet.created,
post.created,
reddit_comment.created,
video.created,
bluesky_post.created,
hn_item.created,
article.created,
answer.created,
answer.changed,
term.cited,
term.uncited,
status.created,
lemmy_post.created,
github_item.created,
launch.created,
stack_item.created,
tiktok_video.created
kind
enum<string>
Available options:
polling,
runs
q
string
Required string length: 1 - 120
mode
enum<string>
Available options:
text,
semantic
intent
Available options:
purchase_intent,
comparison,
question,
complaint,
praise,
other,
unread
sentiment
Available options:
positive,
neutral,
negative,
question,
mixed,
unread
author
Required string length: 1 - 200
engagement_min
integer
Required range: x >= 0
engagement
Required string length: 1 - 120

Response

Mentions

since
string
required
mentions
object[]
required
until
string
nextCursor
string