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.
Authorization
BearerAuth API token authentication. Use format: Bearer ot_your-token-here
In: header
Path Parameters
Unique identifier for the brand
uuidQuery Parameters
Start date for filtering data (ISO 8601 date format). Range is inclusive.
dateEnd date for filtering data (ISO 8601 date format). Range is inclusive.
datePage number (1-indexed)
11 <= valueNumber of items per page
201 <= value <= 100Filter by AI engine. If empty, returns results for all engines
"google-ai-overviews" | "google-ai-mode" | "perplexity" | "openai" | "gemini" | "grok" | "copilot" | "claude" | "bing-ai-mode"Comma-separated list of ISO 3166-1 alpha-2 country codes
Comma-separated list of tags to filter results
Filter by prompt type
"Branded" | "Non-Branded"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.
1 <= lengthResponse 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"
}
}