Omnia docs
REST APIBrandPerformance

List the Prompts that cite a page

Retrieve the Prompts whose AI answers cite a page or domain over a date range: for each Prompt, how often each engine cited it and the first and last day it did. Use it to find where a page is cited, such as a page newly cited or a competitor's page that keeps appearing.

GET
/api/v1/brands/{brand}/citations/prompts

Authorization

BearerAuth
AuthorizationBearer <token>

API token authentication. Use format: Bearer ot_your-token-here

In: header

Path Parameters

brand*string

Unique identifier for the brand

Formatuuid

Query Parameters

startDate*string

Start date for filtering data (ISO 8601 date format). Range is inclusive.

Formatdate
endDate*string

End date for filtering data (ISO 8601 date format). Range is inclusive.

Formatdate
page?integer

Page number (1-indexed)

Default1
Range1 <= value
pageSize?integer

Number of items per page

Default20
Range1 <= value <= 100
engine?string

Filter by AI engine. If empty, returns results for all engines

Value in"google-ai-overviews" | "google-ai-mode" | "perplexity" | "openai" | "gemini" | "grok" | "copilot" | "claude" | "bing-ai-mode"
locations?string

Comma-separated list of ISO 3166-1 alpha-2 country codes

tags?|

Comma-separated list of tags to filter results

promptType?string

Filter by prompt type

Value in"Branded" | "Non-Branded"
url*string

The cited page, such as https://example.com/blog/post, matched whatever its scheme, a leading www. or a trailing slash. A domain without a scheme or path, such as example.com, covers every page on it and its subdomains.

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://app.useomnia.com/api/v1/brands/550e8400-e29b-41d4-a716-446655440000/citations/prompts?startDate=2026-01-01&endDate=2026-01-31&url=https%3A%2F%2Fexample.com%2Fblog%2Fbest-tools"
{
  "pagination": {
    "page": 1,
    "pageSize": 10,
    "totalItems": 420
  },
  "links": {
    "prev": "https://app.useomnia.com/api/v1/resource?page=1&pageSize=10",
    "next": "https://app.useomnia.com/api/v1/resource?page=3&pageSize=10"
  },
  "data": {
    "citations": [
      {
        "promptId": "550e8400-e29b-41d4-a716-446655440000",
        "prompt": "best project management tools",
        "promptType": "Non-Branded",
        "citations": 30,
        "firstCitedDate": "2026-10-14",
        "lastCitedDate": "2026-10-14",
        "engines": [
          {
            "engine": "openai",
            "citations": 12,
            "firstCitedDate": "2026-10-14",
            "lastCitedDate": "2026-10-14"
          }
        ],
        "pages": [
          "string"
        ],
        "pageCount": 1
      }
    ]
  }
}
{
  "error": {
    "code": 1002,
    "description": "Invalid input parameters"
  }
}
{
  "error": {
    "code": 1004,
    "description": "Invalid or expired API token"
  }
}
{
  "error": {
    "code": 1006,
    "description": "Item not found"
  }
}
{
  "error": {
    "code": 1001,
    "description": "Internal error"
  }
}