Skip to main content
GET
List narratives

Authorizations

Authorization
string
header
required

An API key created in Settings → Account → API Keys.

Path Parameters

siteId
string
required

Query Parameters

promptId
string<uuid>[]

Repeat to limit to these prompts (promptIds).

tag
string[]

Repeat to limit to prompts with these tags.

Example:
category
string[]

Repeat to limit to prompts in these categories.

Example:
product
string[]

Repeat to limit to prompts about these products.

Example:
persona
string[]

Repeat to limit to prompts targeting these personas.

Example:
stage
string[]

Repeat to limit to prompts in these journey stages.

Example:
brandMention
enum<string>

Limit to prompts that do, or do not, mention the tracked brand.

Available options:
mentions_tracked_brand,
does_not_mention_tracked_brand
scanId
string<uuid>

Scan to read. Omit for the latest completed Scan; the response echoes the resolved scanId and scanDate.

platform
enum<string>[]

Repeat to select AI platforms. Omit for every platform.

Available options:
claude_api,
chatgpt_api,
gemini_api,
perplexity_sonar_pro,
chatgpt_app,
gemini_app,
google_ai_summaries_app,
google_ai_mode_app,
microsoft_copilot_app,
perplexity_app
region
string[]

Repeat to select region codes. Omit for all regions.

Example:

Response

scanId
string<uuid> | null
required
scanDate
string | null
required

The UTC calendar day of the Scan. Use scanCompletedAt for the exact time, to show the day in your user's time zone.

Example:

"2026-09-10"

data
object[]
required
scanCompletedAt
string<date-time> | null

When the Scan finished, as an ISO 8601 UTC timestamp. Format it in your user's time zone to show the day. Null when not known.

Example:

"2026-09-10T09:42:00.000Z"