Skip to main content
GET
/
v1
/
reports
/
brand
/
{reportId}
/
citations
/
prompts
List prompts for a cited URL
curl --request GET \
  --url https://data.otterly.ai/v1/reports/brand/{reportId}/citations/prompts \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "01HXP1DRTM5G8Z2N3KQ7VAW4PA",
      "prompt": "best running shoes for flat feet",
      "engines": [
        "chatgpt",
        "perplexity"
      ],
      "brandMentioned": 1
    }
  ],
  "paging": {
    "limit": 1,
    "offset": 0
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.otterly.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Provide your API key as a Bearer token: Authorization: Bearer YOUR_API_KEY.

Path Parameters

​
reportId
string
required

Brand report identifier.

Minimum string length: 1
Example:

"01HX7K2YV9D3M8N0G6Q5R4S3T2"

Query Parameters

​
url
string
required

Cited URL to fetch prompts for. URL-encoded.

Minimum string length: 1
Example:

"https://example.com/guides/best-flat-feet-running-shoes"

​
startDate
string
required

Start date for the lookup window (inclusive).

Minimum string length: 1
Example:

"2025-01-01"

​
endDate
string
required

End date for the lookup window (inclusive).

Minimum string length: 1
Example:

"2025-01-31"

​
country
string
required

Country code to filter by. Lowercase ISO 3166-1 alpha-2; use uk for the United Kingdom.

Minimum string length: 1
Example:

"us"

​
engines

Optional. AI engine(s) to filter by. Repeat the param or pass a single value.

Available options:
chatgpt,
google,
perplexity,
copilot,
google_ai_mode,
gemini
Example:

"chatgpt"

​
tagId
string

Optional. Filter prompts by tag id.

Response

A list of prompts that cited the given URL.

​
items
object[]
required
​
paging
object
required
Example:
{ "limit": 25, "offset": 0 }