Sign in

v1

latestOpenAPI 3.0.02026-07-222980136.7 KB
Brand Reports

List citations for a brand report

get/v1/reports/brand/{reportId}/citations

Path parameters

reportIdstring required

Brand report identifier.

Example:01HX7K2YV9D3M8N0G6Q5R4S3T2

Brand report identifier.

Query parameters

startDatestring required

Start date for the citations window (inclusive).

Example:2025-01-01

Start date for the citations window (inclusive).

endDatestring required

End date for the citations window (inclusive).

Example:2025-01-31

End date for the citations window (inclusive).

countrystring required

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

Example:us

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

'chatgpt' | 'google' | 'perplexity' | 'copilot' | 'google_ai_mode' | 'gemini' | 'claude'

AI engine identifier.

OR
string[]
Example:chatgpt

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

tagIdstring

Optional. Filter citations by tag id.

Optional. Filter citations by tag id.

string
OR
string[]

Optional. Filter citations to specific domains.

searchstring

Optional. Free-text search.

Optional. Free-text search.

offsetinteger

Optional. Zero-based offset for pagination.

Optional. Zero-based offset for pagination.

limitinteger

Optional. Maximum number of items to return.

Optional. Maximum number of items to return.

sortBystring

Optional. Field to sort by.

Optional. Field to sort by.

sortOrder'asc' | 'desc'

Optional. Sort direction.

Optional. Sort direction.

brandMentionedboolean

Optional. Filter citations where the brand is mentioned.

Optional. Filter citations where the brand is mentioned.

string
OR
string[]

Optional. Filter by one or more competitor brand names.

'Social Media' | 'Community/Forum' | 'Brand' | 'Encyclopedia' | 'News/Media' | 'Blogs/Personal Sites' | 'Government/NGO' | 'Education' | 'Video' | 'Competitor' | 'Others' | 'Unclassified'

Domain classification.

OR
string[]
Example:News/Media

Optional. Domain category/categories to filter by. Repeat the param or pass a single value.

Response

A page of citations for the brand report.

Example response

{
  "items": [
    {
      "url": "https://www.adidas.com/us/running",
      "domain": "adidas.com",
      "title": "Adidas Running Shoes & Apparel",
      "citations": 7469,
      "prompts": [
        {
          "id": "01HXP1DRTM5G8Z2N3KQ7VAW4PA",
          "brandMentioned": 1,
          "engines": [
            "chatgpt",
            "gemini"
          ]
        }
      ],
      "isMyBrandDomain": true,
      "competitors": [
        {
          "brand": "Nike"
        },
        {
          "brand": "Asics"
        },
        {
          "brand": "New Balance"
        }
      ],
      "brandMentioned": 1,
      "domainCategory": "Brand"
    }
  ],
  "paging": {
    "limit": 25,
    "offset": 0
  }
}