OTotterly
Brand Reports

List recommendations for a brand report

Changed on
get/v1/reports/brand/{reportId}/recommendations

Request

  • Base URL
    https://data.otterly.ai
  • Auth
    HTTP bearer

Path parameters

reportIdstring required

Brand report identifier.

Example:01HX7K2YV9D3M8N0G6Q5R4S3T2

Query parameters

countrystring required

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

Example:us
engine'chatgpt' | 'google' | 'perplexity' | 'copilot' | 'google_ai_mode' | 'gemini' | 'claude'

Optional. Filter results to a single AI engine.

Example:chatgpt
cursorstring

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

Response

A list of recommendations for the brand report.

Example response

{
  "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"
      },
      "copy": {
        "title": "Find Content Partnership Opportunities",
        "headline": "Get Adidas featured in this article on Best Running Shoes of 2025, Tested & Reviewed",
        "reasoning": "This page [Best Running Shoes of 2025, Tested & Reviewed](https://www.runnersworld.com/gear/a40081820/best-running-shoes-2025/) is cited by AI Search Engines 7 times in the last 7 days \\- and it currently mentions **Nike** but not **Adidas**. That means AI Search Engines already trust this source and use it to answer prompts relevant to you. Getting **Adidas** included here could directly improve your visibility in AI responses.",
        "suggestions": [
          "- Reach out to the site owner or author and pitch Adidas as a relevant addition",
          "- Offer a guest contribution, expert quote, or data point they could include",
          "- Send this to your PR or content team as an outreach target",
          "- Check if the site accepts sponsored or contributed content"
        ]
      }
    }
  ],
  "paging": {
    "nextCursor": null,
    "hasMore": false
  }
}

Changes