Skip to main content
GET
Search competitor mentions

Authorizations

X-API-Key
string
header
required

Team-scoped API key created in the app (Settings → API Keys). Sent as X-API-Key: <key> on every request.

Query Parameters

q
string

Free-text search over titles and content.

competitor
string

Filter by competitor: id or name.

customer_id
string<uuid>

Filter to mentions from one company (customer).

date_from
string<date>

Inclusive start date (ISO 8601).

date_to
string<date>

Inclusive end date (ISO 8601).

limit
integer
default:50

Page size (max 200).

Required range: 1 <= x <= 200
offset
integer
default:0

Number of records to skip.

Required range: x >= 0

Response

200 - application/json

A page of competitor mentions

data
object[]
pagination
object