Skip to main content
GET
/
v1
/
reports
/
brand
/
{reportId}
/
recommendations
List recommendations for a brand report
curl --request GET \
  --url https://data.otterly.ai/v1/reports/brand/{reportId}/recommendations \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "1072ee8791164402a29207d96bfb036ca43e85dd1c0678e8899cb0caa96f655c",
      "engine": "chatgpt",
      "type": "content_partnership_opportunities",
      "group": "off_page",
      "priority": 6,
      "score": 261,
      "state": "suggested",
      "data": {
        "url": "https://www.runnersworld.com/gear/a40081820/best-running-shoes-2025/",
        "title": "Best Running Shoes of 2025, Tested & Reviewed",
        "domain": "runnersworld.com",
        "domainCategory": "News/Media",
        "mentionedCompetitors": [
          "Nike",
          "Asics",
          "New Balance"
        ],
        "citations": 7,
        "prompts": [
          {
            "promptId": "01HXP1DRTM5G8Z2N3KQ7VAW4PA",
            "prompt": "best running shoes 2025"
          }
        ],
        "country": "us",
        "service": "chatgpt",
        "type": "content_partnership_opportunities"
      }
    }
  ],
  "paging": {
    "nextCursor": null,
    "hasMore": false
  }
}

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

​
country
string
required

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

Minimum string length: 1
Example:

"us"

​
engine
enum<string>

Optional. Filter results to a single AI engine.

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

"chatgpt"

​
cursor
string

Optional. Pagination cursor — pass back the nextCursor value from a previous response. Omit to fetch the first page.

Minimum string length: 1

Response

A list of recommendations for the brand report.

​
items
object[]
required
​
paging
object
required
Example:
{ "nextCursor": null, "hasMore": false }