Skip to main content
GET
List Responses

Authorizations

Authorization
string
header
required

Team API key created in Team Settings. Use it with URLs for the same team.

Path Parameters

project
string<uuid>
required

Project UUID.

Query Parameters

start_date
string<date>
required
end_date
string<date>
required

Must be on or after start_date.

tags
string[]

Tag UUID or name filters. Repeat as tags[]=<uuid-or-name>. Discover tags with GET /api/v1/projects/{project}/tags.

services
string[]

AI platform provider filters such as chatgpt or perplexity. Repeat as services[]=<provider>. Discover providers with GET /api/v1/platforms.

countries
string[]

Country code filters such as US or GB. Repeat as countries[]=<code>. Discover codes with GET /api/v1/countries.

topics
string[]

Topic UUID or name filters. Use no_topic for prompts without a topic. Repeat as topics[]=<uuid-or-name>. Discover topics with GET /api/v1/projects/{project}/topics.

prompt
string<uuid>

Prompt UUID filter.

brand
string<uuid>

Brand UUID to scope the reputation data to. Must belong to the project. Defaults to the project's primary brand; when the project has no primary brand an explicit brand is required. Discover brand UUIDs with GET /api/v1/projects/{project}/brands.

scope_type
enum<string>
required

The entity the listing is scoped to: narrative or theme (a theme expands to its narratives' mentions).

Available options:
narrative,
theme
scope_uuid
string<uuid>
required

The UUID of the narrative or theme named by scope_type.

per_page
integer

Results per page, 1-100. Defaults to 10.

Required range: 1 <= x <= 100
page
integer

Page number. Defaults to 1.

Required range: x >= 1

Response

Paginated response mentions.

data
object[]
required
meta
object
required