{
"error": {
"code": "invalid_date",
"message": "Dates must be ISO 8601, e.g. 2026-08-01."
}
}
{
"error": {
"code": "invalid_api_key",
"message": "This API key is not valid or has been revoked."
}
}
{
"error": {
"code": "subscription_required",
"message": "This workspace does not have an active subscription. API access requires an active or trialing plan."
}
}
{
"error": {
"code": "not_found",
"message": "No such brand in this workspace."
}
}
{
"error": {
"code": "rate_limited",
"message": "Rate limit of 120 requests per minute exceeded."
}
}
{
"error": {
"code": "internal_error",
"message": "Something went wrong on our side."
}
}
Ads
Ads summary
An overview of the sponsored ads ChatGPT showed in answers to this brand’s prompts: how often an ad appeared, how many advertisers and ads, and the top advertiser. Start here, then open advertisers, creatives or prompts.
{
"error": {
"code": "invalid_date",
"message": "Dates must be ISO 8601, e.g. 2026-08-01."
}
}
{
"error": {
"code": "invalid_api_key",
"message": "This API key is not valid or has been revoked."
}
}
{
"error": {
"code": "subscription_required",
"message": "This workspace does not have an active subscription. API access requires an active or trialing plan."
}
}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Geoptie Docs","description":"Read and manage your AI-search visibility data: the REST API, and the MCP server that lets an AI assistant use it. Visibility across engines, the prompts you track, citations, competitors, recommendations and content.","colors":{"primary":"#0F172A","light":"#F8FAFC","dark":"#0F172A"},"logo":{"light":"https://mintcdn.com/geoptie/FVHhiPrfPwJ4Jq1e/logo/wordmark-light.svg?fit=max\u0026auto=format\u0026n=FVHhiPrfPwJ4Jq1e\u0026q=85\u0026s=687512131d54c6fdb747acf773024939","dark":"https://mintcdn.com/geoptie/FVHhiPrfPwJ4Jq1e/logo/wordmark-dark.svg?fit=max\u0026auto=format\u0026n=FVHhiPrfPwJ4Jq1e\u0026q=85\u0026s=8e257a37cdf1ea98d9b952f0c7234995"},"favicon":"https://mintcdn.com/geoptie/k7tyOlIAShXmlQhS/favicon.png?fit=max\u0026auto=format\u0026n=k7tyOlIAShXmlQhS\u0026q=85\u0026s=a3d1708c9209a5cfaa26bbbbaef21482","appearance":{"default":"system"},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://geoptie.com/app"}},"footer":{"socials":{"website":"https://geoptie.com"},"links":[{"header":"Product","items":[{"label":"Dashboard","href":"https://geoptie.com/app"},{"label":"Pricing","href":"https://geoptie.com/pricing"},{"label":"Blog","href":"https://geoptie.com/blog"}]},{"header":"Free tools","items":[{"label":"Free GEO audit","href":"https://geoptie.com/free-geo-audit"},{"label":"AI visibility checker","href":"https://geoptie.com/ai-visibility-checker"},{"label":"GEO rank tracker","href":"https://geoptie.com/geo-rank-tracker"}]},{"header":"Company","items":[{"label":"Support","href":"mailto:support@geoptie.com"},{"label":"Terms of service","href":"https://geoptie.com/terms-of-service"},{"label":"Privacy policy","href":"https://geoptie.com/privacy-policy"}]}]},"contextual":{"options":["copy","view","download-spec","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"geoptie","hasAudioNarration":false,"actualSubdomain":"geoptie","customDomains":["geoptie.com"],"gitSource":{"type":"github","owner":"omerfcelikk","repo":"geoptie-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af59f40c7a2465f288603f9","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Documentation","count":62},{"language":"default","tag":"API reference","count":55},{"language":"default","tag":"Competitors","count":10},{"language":"default","tag":"Ads","count":7},{"language":"default","tag":"Prompts","count":7},{"language":"default","tag":"Content generations","count":6},{"language":"default","tag":"Core concepts","count":5},{"language":"default","tag":"Content optimizations","count":5},{"language":"default","tag":"MCP Documentation","count":4},{"language":"default","tag":"Audit reports","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html.dark #topbar-cta-button a>span.absolute{background-color:#f8fafc}html.dark #topbar-cta-button a span:not(.absolute),html.dark #topbar-cta-button a svg{color:#0f172a!important}"}],"page":{"pagePath":"api-reference/ads/ads-summary","slug":"/api-reference/ads/ads-summary","pageMetadata":{"title":"Ads summary","description":"An overview of the sponsored ads ChatGPT showed in answers to this brand's prompts: how often an ad appeared, how many advertisers and ads, and the top advertiser. Start here, then open advertisers, creatives or prompts.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/ads","href":"/api-reference/ads/ads-summary","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"An overview of the sponsored ads ChatGPT showed in answers to this brand’s prompts: how often an ad appeared, how many advertisers and ads, and the top advertiser. Start here, then open advertisers, creatives or prompts.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Ads summary","description":"An overview of the sponsored ads ChatGPT showed in answers to this brand's prompts: how often an ad appeared, how many advertisers and ads, and the top advertiser. Start here, then open advertisers, creatives or prompts.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/ads","href":"/api-reference/ads/ads-summary","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/geoptie/2140aa35ebe2fded/logo/build-wordmark.js"],"openApiReferenceData":{"operation":{"tags":["Ads"],"summary":"Ads summary","description":"An overview of the sponsored ads ChatGPT showed in answers to this brand's prompts: how often an ad appeared, how many advertisers and ads, and the top advertiser. Start here, then open advertisers, creatives or prompts.","parameters":["2d477cfd-4681-45f8-9264-737b4e1979a4","02ffb528-1339-4351-8f22-c6c9c86976f9","34fd1890-ac03-4623-ae23-29d04d4748c2","1487fc7a-72c8-4e13-bce4-b767d3647523","c0a65316-6f8c-4c95-b148-31ef968a6a02","8ae923c3-009d-4614-a72e-903b2d28e375","1df2021b-c774-4299-ab69-d1e30af24490"],"responses":{"200":"87b4919f-1b34-4e6b-acbf-eae04247cf60","400":"092eb359-f51d-4141-9b92-14d1fa82ae59","401":"4cbfb7ce-daaa-4559-a1a0-c2834af62bf1","402":"e29a6b02-2991-44a2-a0e1-06bde8ccf0a9","403":"0ea8d7e5-3d62-4991-8246-e760954a470c","404":"5ccfd1e5-f2bf-4d40-a418-2ea099f3d11b","429":"cf6ec4e3-a0eb-4f8f-94a8-38fb0bd29039","500":"bb884b5e-78f0-4a47-82e3-8677d3b640b7"},"operationId":"getAdsSummary","x-geoptie-limits":{"rate_per_min":120,"per_min":null,"per_hour":null,"max_concurrent":null,"spends_model_budget":false},"method":"get","type":"path","servers":["8230649d-2e24-4154-a820-e8aee703d645"],"security":["11a82c72-e783-4f85-baa9-58d7a0fe7b4f"],"path":"/v1/brands/{id}/ads","baseUrlOptions":["https://api.geoptie.com"],"title":"Ads summary","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2d477cfd-4681-45f8-9264-737b4e1979a4":{"name":"id","in":"path","required":true,"description":"Brand id.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"Brand id.","uniqueKey":"","typeLabel":"string\u003cuuid>"},"example":"b7c1e5a0-4f3d-42a8-9c6b-1e8d5a2f7043"},"02ffb528-1339-4351-8f22-c6c9c86976f9":{"name":"engine","in":"query","required":false,"description":"Ads are tracked on ChatGPT only, so this is `chatgpt` or omitted.","schema":{"type":"string","enum":["chatgpt"],"isRequired":false,"description":"Ads are tracked on ChatGPT only, so this is `chatgpt` or omitted.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"34fd1890-ac03-4623-ae23-29d04d4748c2":{"name":"from","in":"query","required":false,"description":"Inclusive start date. Defaults to 30 days before `to`.","schema":{"type":"string","format":"date","isRequired":false,"description":"Inclusive start date. Defaults to 30 days before `to`.","uniqueKey":"","typeLabel":"string\u003cdate>"},"example":"2026-11-08"},"1487fc7a-72c8-4e13-bce4-b767d3647523":{"name":"to","in":"query","required":false,"description":"Exclusive end date. Defaults to tomorrow.","schema":{"type":"string","format":"date","isRequired":false,"description":"Exclusive end date. Defaults to tomorrow.","uniqueKey":"","typeLabel":"string\u003cdate>"},"example":"2026-11-11"},"c0a65316-6f8c-4c95-b148-31ef968a6a02":{"name":"country","in":"query","required":false,"description":"Restrict to one market: a two-letter code, or `global` for checks run without a market. The summary's `markets` lists the values this brand has.","schema":{"type":"string","isRequired":false,"description":"Restrict to one market: a two-letter code, or `global` for checks run without a market. The summary's `markets` lists the values this brand has.","uniqueKey":"","typeLabel":"string"},"example":"US"},"8ae923c3-009d-4614-a72e-903b2d28e375":{"name":"topic_id","in":"query","required":false,"explode":true,"description":"Repeatable. Restrict to prompts in these topics.","schema":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":false,"description":"Repeatable. Restrict to prompts in these topics.","uniqueKey":"","typeLabel":"string\u003cuuid>[]"}},"1df2021b-c774-4299-ab69-d1e30af24490":{"name":"branding","in":"query","required":false,"description":"Restrict to prompts that name this brand (`branded`) or to those that do not (`non_branded`). Omit, or `all`, for every prompt.","schema":{"type":"string","enum":["all","branded","non_branded"],"default":"all","isRequired":false,"description":"Restrict to prompts that name this brand (`branded`) or to those that do not (`non_branded`). Omit, or `all`, for every prompt.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"87b4919f-1b34-4e6b-acbf-eae04247cf60":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"from":{"type":"string","format":"date","uniqueKey":"data.from","typeLabel":"string\u003cdate>"},"to":{"type":"string","format":"date","uniqueKey":"data.to","typeLabel":"string\u003cdate>"},"engine":{"type":"string","enum":["chatgpt"],"uniqueKey":"data.engine","typeLabel":"enum\u003cstring>"},"filters":{"type":"object","properties":{"country":{"oneOf":[{"type":"string","uniqueKey":"data.filters.country.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.filters.country.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.filters.country","typeLabel":"string | null"},"topic_ids":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"data.filters.topic_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"data.filters.topic_ids","typeLabel":"string\u003cuuid>[]"},"branding":{"type":"string","enum":["all","branded","non_branded"],"uniqueKey":"data.filters.branding","typeLabel":"enum\u003cstring>"}},"uniqueKey":"data.filters","typeLabel":"object"},"data_from":{"oneOf":[{"type":"string","format":"date","description":"First day with ads data for this brand. Nothing exists before it.","uniqueKey":"data.data_from.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"First day with ads data for this brand. Nothing exists before it.","uniqueKey":"data.data_from.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.data_from","typeLabel":"string\u003cdate> | null"},"answers":{"type":"integer","description":"ChatGPT answers checked for this brand's prompts.","uniqueKey":"data.answers","typeLabel":"integer"},"answers_with_ads":{"type":"integer","uniqueKey":"data.answers_with_ads","typeLabel":"integer"},"ad_coverage_pct":{"oneOf":[{"type":"number","description":"0-100. Share of the answers checked that showed an ad.","uniqueKey":"data.ad_coverage_pct.oneOf.0","typeLabel":"number"},{"type":"null","description":"0-100. Share of the answers checked that showed an ad.","uniqueKey":"data.ad_coverage_pct.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.ad_coverage_pct","typeLabel":"number | null"},"ads":{"type":"integer","description":"Ads seen across those answers.","uniqueKey":"data.ads","typeLabel":"integer"},"advertisers":{"type":"integer","uniqueKey":"data.advertisers","typeLabel":"integer"},"creatives":{"type":"integer","description":"Distinct ad creatives.","uniqueKey":"data.creatives","typeLabel":"integer"},"prompts":{"type":"integer","description":"Prompts checked.","uniqueKey":"data.prompts","typeLabel":"integer"},"prompts_with_ads":{"type":"integer","uniqueKey":"data.prompts_with_ads","typeLabel":"integer"},"top_advertiser":{"oneOf":[{"type":"object","properties":{"advertiser_key":{"type":"string","description":"Stable advertiser id. Usually the advertiser's domain (`globex.com`); `name:` plus a folded name when the ad links through a redirect or a marketplace. Treat it as opaque and pass it back unchanged, percent-encoded in a path.","example":"globex.com","uniqueKey":"data.top_advertiser.oneOf.0.advertiser_key","typeLabel":"string"},"name":{"oneOf":[{"type":"string","uniqueKey":"data.top_advertiser.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.top_advertiser.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.top_advertiser.oneOf.0.name","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","uniqueKey":"data.top_advertiser.oneOf.0.domain.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.top_advertiser.oneOf.0.domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.top_advertiser.oneOf.0.domain","typeLabel":"string | null"},"ads":{"type":"integer","uniqueKey":"data.top_advertiser.oneOf.0.ads","typeLabel":"integer"},"share_pct":{"oneOf":[{"type":"number","description":"0-100. Share of all ads.","uniqueKey":"data.top_advertiser.oneOf.0.share_pct.oneOf.0","typeLabel":"number"},{"type":"null","description":"0-100. Share of all ads.","uniqueKey":"data.top_advertiser.oneOf.0.share_pct.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.top_advertiser.oneOf.0.share_pct","typeLabel":"number | null"},"is_competitor":{"type":"boolean","uniqueKey":"data.top_advertiser.oneOf.0.is_competitor","typeLabel":"boolean"},"is_own":{"type":"boolean","uniqueKey":"data.top_advertiser.oneOf.0.is_own","typeLabel":"boolean"}},"uniqueKey":"data.top_advertiser.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"advertiser_key":{"type":"string","description":"Stable advertiser id. Usually the advertiser's domain (`globex.com`); `name:` plus a folded name when the ad links through a redirect or a marketplace. Treat it as opaque and pass it back unchanged, percent-encoded in a path.","example":"globex.com"},"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"domain":{"oneOf":[{"type":"string"},{"type":"null"}]},"ads":{"type":"integer"},"share_pct":{"oneOf":[{"type":"number","description":"0-100. Share of all ads."},{"type":"null","description":"0-100. Share of all ads."}]},"is_competitor":{"type":"boolean"},"is_own":{"type":"boolean"}},"uniqueKey":"data.top_advertiser.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.top_advertiser","typeLabel":"object | null"},"markets":{"type":"array","description":"Every market this brand is checked in, whatever `country` is set to. `global` is checks run without a market.","items":{"type":"object","properties":{"country":{"type":"string","uniqueKey":"data.markets.items.[INDEX].country","typeLabel":"string"},"answers":{"type":"integer","uniqueKey":"data.markets.items.[INDEX].answers","typeLabel":"integer"},"answers_with_ads":{"type":"integer","uniqueKey":"data.markets.items.[INDEX].answers_with_ads","typeLabel":"integer"}},"uniqueKey":"data.markets.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.markets","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":{"from":"2026-10-15","to":"2026-11-14","engine":"chatgpt","filters":{"country":null,"topic_ids":[],"branding":"all"},"data_from":"2026-10-12","answers":620,"answers_with_ads":283,"ad_coverage_pct":45.6,"ads":283,"advertisers":41,"creatives":96,"prompts":30,"prompts_with_ads":27,"top_advertiser":{"advertiser_key":"globex.com","name":"Globex","domain":"globex.com","ads":52,"share_pct":18.4,"is_competitor":true,"is_own":false},"markets":[{"country":"US","answers":620,"answers_with_ads":283}]}},"examples":{"Example":{"title":"Example","value":{"data":{"from":"2026-10-15","to":"2026-11-14","engine":"chatgpt","filters":{"country":null,"topic_ids":[],"branding":"all"},"data_from":"2026-10-12","answers":620,"answers_with_ads":283,"ad_coverage_pct":45.6,"ads":283,"advertisers":41,"creatives":96,"prompts":30,"prompts_with_ads":27,"top_advertiser":{"advertiser_key":"globex.com","name":"Globex","domain":"globex.com","ads":52,"share_pct":18.4,"is_competitor":true,"is_own":false},"markets":[{"country":"US","answers":620,"answers_with_ads":283}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"092eb359-f51d-4141-9b92-14d1fa82ae59":{"description":"Bad request. `missing_parameter`, `invalid_parameter`, `invalid_request`, `invalid_engine` or `invalid_date`.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine code. Match on this, not the message.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"example":{"error":{"code":"not_found","message":"No such brand in this workspace."}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"invalid_date","message":"Dates must be ISO 8601, e.g. 2026-08-01."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_date","message":"Dates must be ISO 8601, e.g. 2026-08-01."}}}},"exampleType":"examples"}},"exampleType":"examples"},"4cbfb7ce-daaa-4559-a1a0-c2834af62bf1":{"description":"`missing_api_key` or `invalid_api_key`.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine code. Match on this, not the message.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"example":{"error":{"code":"not_found","message":"No such brand in this workspace."}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"invalid_api_key","message":"This API key is not valid or has been revoked."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_api_key","message":"This API key is not valid or has been revoked."}}}},"exampleType":"examples"}},"exampleType":"examples"},"e29a6b02-2991-44a2-a0e1-06bde8ccf0a9":{"description":"`subscription_required`. The workspace has no active or trialing subscription.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine code. Match on this, not the message.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"example":{"error":{"code":"not_found","message":"No such brand in this workspace."}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"subscription_required","message":"This workspace does not have an active subscription. API access requires an active or trialing plan."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"subscription_required","message":"This workspace does not have an active subscription. API access requires an active or trialing plan."}}}},"exampleType":"examples"}},"exampleType":"examples"},"0ea8d7e5-3d62-4991-8246-e760954a470c":{"description":"`plan_not_eligible` or `forbidden`.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine code. Match on this, not the message.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"example":{"error":{"code":"not_found","message":"No such brand in this workspace."}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"forbidden","message":"This workspace cannot perform that action."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"forbidden","message":"This workspace cannot perform that action."}}}},"exampleType":"examples"}},"exampleType":"examples"},"5ccfd1e5-f2bf-4d40-a418-2ea099f3d11b":{"description":"`not_found`. Also returned for records belonging to another workspace.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine code. Match on this, not the message.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"example":{"error":{"code":"not_found","message":"No such brand in this workspace."}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"not_found","message":"No such brand in this workspace."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"not_found","message":"No such brand in this workspace."}}}},"exampleType":"examples"}},"exampleType":"examples"},"cf6ec4e3-a0eb-4f8f-94a8-38fb0bd29039":{"description":"`rate_limited`, `quota_exceeded`, `endpoint_rate_limited` or `concurrency_limited`.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine code. Match on this, not the message.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"example":{"error":{"code":"not_found","message":"No such brand in this workspace."}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"rate_limited","message":"Rate limit of 120 requests per minute exceeded."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"rate_limited","message":"Rate limit of 120 requests per minute exceeded."}}}},"exampleType":"examples"}},"exampleType":"examples"},"bb884b5e-78f0-4a47-82e3-8677d3b640b7":{"description":"`internal_error`. Quote the `X-Request-Id` when reporting it.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine code. Match on this, not the message.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"example":{"error":{"code":"not_found","message":"No such brand in this workspace."}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"internal_error","message":"Something went wrong on our side."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"internal_error","message":"Something went wrong on our side."}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"11a82c72-e783-4f85-baa9-58d7a0fe7b4f":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Your API key, e.g. `Authorization: Bearer gp_live_...`.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"8230649d-2e24-4154-a820-e8aee703d645":{"url":"https://api.geoptie.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your API key, e.g. `Authorization: Bearer gp_live_...`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your API key, e.g. `Authorization: Bearer gp_live_...`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"geoptie","siteName":"Geoptie Docs","title":"Ads summary - Geoptie Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T11:13:15.237Z","originalFileLocation":"api-reference/ads/ads-summary.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"An overview of the sponsored ads ChatGPT showed in answers to this brand\u0026#x27;s prompts: how often an ad appeared, how many advertisers and ads, and the top advertiser. Start here, then open advertisers, creatives or prompts.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Geoptie Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/geoptie/_8TzJvcgBWG1xlPF/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/geoptie/_8TzJvcgBWG1xlPF/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/geoptie/_8TzJvcgBWG1xlPF/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/geoptie/_8TzJvcgBWG1xlPF/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/geoptie/_8TzJvcgBWG1xlPF/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/geoptie/_8TzJvcgBWG1xlPF/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/geoptie/_8TzJvcgBWG1xlPF/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/geoptie/_8TzJvcgBWG1xlPF/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/geoptie/_8TzJvcgBWG1xlPF/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Ads summary - Geoptie Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"An overview of the sponsored ads ChatGPT showed in answers to this brand\u0026#x27;s prompts: how often an ad appeared, how many advertisers and ads, and the top advertiser. Start here, then open advertisers, creatives or prompts.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Geoptie Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://geoptie.com/docs/api-reference/ads/ads-summary\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://geoptie.mintlify.site/docs/_mintlify/api/og/v2?division=Ads\u0026amp;title=Ads+summary\u0026amp;description=An+overview+of+the+sponsored+ads+ChatGPT+showed+in+answers+to+this+brand%27s+prompts%3A+how+often+an+ad+appeared%2C+how+many+advertisers+and+ads%2C+and+the+top+advertis\u0026amp;theme=7601e87fdf07654df26d6c19\u0026amp;signature=076503ebd7431fffa6c2a35050ebacbb9001c0561ba420e3f0ed33c550edaa61\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Ads summary - Geoptie Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"An overview of the sponsored ads ChatGPT showed in answers to this brand\u0026#x27;s prompts: how often an ad appeared, how many advertisers and ads, and the top advertiser. Start here, then open advertisers, creatives or prompts.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://geoptie.mintlify.site/docs/_mintlify/api/og/v2?division=Ads\u0026amp;title=Ads+summary\u0026amp;description=An+overview+of+the+sponsored+ads+ChatGPT+showed+in+answers+to+this+brand%27s+prompts%3A+how+often+an+ad+appeared%2C+how+many+advertisers+and+ads%2C+and+the+top+advertis\u0026amp;theme=7601e87fdf07654df26d6c19\u0026amp;signature=076503ebd7431fffa6c2a35050ebacbb9001c0561ba420e3f0ed33c550edaa61\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/geoptie/_8TzJvcgBWG1xlPF/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Geoptie Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F172A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://geoptie.com/docs/api-reference/ads/ads-summary\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/ads/ads-summary.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://geoptie.com/#organization\",\"name\":\"Geoptie Docs\",\"url\":\"https://geoptie.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/geoptie/FVHhiPrfPwJ4Jq1e/logo/wordmark-light.svg?fit=max\u0026auto=format\u0026n=FVHhiPrfPwJ4Jq1e\u0026q=85\u0026s=687512131d54c6fdb747acf773024939\"}},{\"@type\":\"WebSite\",\"@id\":\"https://geoptie.com/docs#website\",\"name\":\"Geoptie Docs\",\"url\":\"https://geoptie.com/docs\",\"publisher\":{\"@id\":\"https://geoptie.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://geoptie.com/docs/api-reference/ads/ads-summary#webpage\",\"url\":\"https://geoptie.com/docs/api-reference/ads/ads-summary\",\"name\":\"Ads summary\",\"description\":\"An overview of the sponsored ads ChatGPT showed in answers to this brand's prompts: how often an ad appeared, how many advertisers and ads, and the top advertiser. Start here, then open advertisers, creatives or prompts.\",\"dateModified\":\"2026-11-12T11:13:15.237Z\",\"isPartOf\":{\"@id\":\"https://geoptie.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://geoptie.com/docs/api-reference/ads/ads-summary#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://geoptie.com/docs/api-reference/ads/ads-summary#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://geoptie.com/docs/api-reference/brands/list-brands\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Ads summary\",\"item\":\"https://geoptie.com/docs/api-reference/ads/ads-summary\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://geoptie.com/docs/api-reference/ads/ads-summary#apireference\",\"headline\":\"Ads summary\",\"name\":\"Ads summary\",\"description\":\"An overview of the sponsored ads ChatGPT showed in answers to this brand's prompts: how often an ad appeared, how many advertisers and ads, and the top advertiser. Start here, then open advertisers, creatives or prompts.\",\"url\":\"https://geoptie.com/docs/api-reference/ads/ads-summary\",\"mainEntityOfPage\":{\"@id\":\"https://geoptie.com/docs/api-reference/ads/ads-summary#webpage\"},\"dateModified\":\"2026-11-12T11:13:15.237Z\",\"publisher\":{\"@id\":\"https://geoptie.com/#organization\"},\"isPartOf\":{\"@id\":\"https://geoptie.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Geoptie Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Geoptie Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/ads/ads-summary.md","siteName":"Geoptie Docs","nav":{"global":null,"tabs":[{"tab":"API Documentation","groups":[{"group":"Get started","icon":"rocket","pages":[{"title":"Introduction","href":""},{"title":"Quickstart","href":"/quickstart"}]},{"group":"Core concepts","icon":"book","pages":[{"title":"Authentication","href":"/authentication"},{"title":"Pagination and dates","sidebarTitle":"Pagination \u0026 dates","href":"/pagination"},{"title":"Long-running operations","sidebarTitle":"Long-running operations","href":"/long-running"},{"title":"Rate limits","href":"/rate-limits"},{"title":"Errors","href":"/errors"}]},{"group":"API reference","icon":"code","pages":[{"group":"Brands","pages":[{"title":"List brands","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands","href":"/api-reference/brands/list-brands"},{"title":"Create a brand","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/brands","href":"/api-reference/brands/create-a-brand"},{"title":"Get a brand","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}","href":"/api-reference/brands/get-a-brand"}]},{"group":"Visibility","pages":[{"title":"Brand visibility","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/visibility","href":"/api-reference/visibility/brand-visibility"}]},{"group":"Prompts","pages":[{"title":"List a brand's prompts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/prompts","href":"/api-reference/prompts/list-a-brands-prompts"},{"title":"Start tracking prompts","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/brands/{id}/prompts","href":"/api-reference/prompts/start-tracking-prompts"},{"title":"Stop tracking a prompt","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/brands/{id}/prompts/{promptId}","href":"/api-reference/prompts/stop-tracking-a-prompt"},{"title":"Update a prompt's topic or type","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/brands/{id}/prompts/{promptId}","href":"/api-reference/prompts/update-a-prompts-topic-or-type"},{"title":"Get a prompt","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/prompts/{id}","href":"/api-reference/prompts/get-a-prompt"},{"title":"Answers for a prompt","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/prompts/{id}/responses","href":"/api-reference/prompts/answers-for-a-prompt"},{"title":"Brands mentioned in a prompt's answers","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/prompts/{id}/mentions","href":"/api-reference/prompts/brands-mentioned-in-a-prompts-answers"}]},{"group":"Topics","pages":[{"title":"List topics","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/topics","href":"/api-reference/topics/list-topics"},{"title":"Create a topic","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/brands/{id}/topics","href":"/api-reference/topics/create-a-topic"},{"title":"Delete a topic","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/brands/{id}/topics/{topicId}","href":"/api-reference/topics/delete-a-topic"},{"title":"Rename a topic","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/brands/{id}/topics/{topicId}","href":"/api-reference/topics/rename-a-topic"}]},{"group":"Citations","pages":[{"title":"Citations for a brand","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/citations","href":"/api-reference/citations/citations-for-a-brand"},{"title":"Most-cited domains","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/citations/domains","href":"/api-reference/citations/most-cited-domains"},{"title":"Most-cited pages","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/citations/urls","href":"/api-reference/citations/most-cited-pages"},{"title":"Citation trend for one domain or page","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/citations/trends","href":"/api-reference/citations/citation-trend-for-one-domain-or-page"}]},{"group":"Competitors","pages":[{"title":"Your brand versus its competitors","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/competitors","href":"/api-reference/competitors/your-brand-versus-its-competitors"},{"title":"Tracked competitors over time","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/competitors/trends","href":"/api-reference/competitors/tracked-competitors-over-time"},{"title":"One tracked competitor in detail","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/competitors/{competitorId}","href":"/api-reference/competitors/one-tracked-competitor-in-detail"},{"title":"List tracked competitors","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/tracked-competitors","href":"/api-reference/competitors/list-tracked-competitors"},{"title":"Track competitors","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/brands/{id}/tracked-competitors","href":"/api-reference/competitors/track-competitors"},{"title":"Untrack a competitor","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/brands/{id}/tracked-competitors/{competitorId}","href":"/api-reference/competitors/untrack-a-competitor"},{"title":"Edit a tracked competitor","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/brands/{id}/tracked-competitors/{competitorId}","href":"/api-reference/competitors/edit-a-tracked-competitor"},{"title":"List ignored competitors","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/ignored-competitors","href":"/api-reference/competitors/list-ignored-competitors"},{"title":"Ignore competitors","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/brands/{id}/ignored-competitors","href":"/api-reference/competitors/ignore-competitors"},{"title":"Stop ignoring a competitor","description":"Remove a name from the ignore list. It shows on the discovered list again.","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/brands/{id}/ignored-competitors/{competitorId}","href":"/api-reference/competitors/stop-ignoring-a-competitor"}]},{"group":"Ads","pages":[{"title":"Ads summary","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/ads","href":"/api-reference/ads/ads-summary"},{"title":"Advertisers","description":"Who advertises on this brand's prompts, most ads first, with each one's share of all ads and whether it is a tracked competitor. Pass `tracked=true` to see only your competitors.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/ads/advertisers","href":"/api-reference/ads/advertisers"},{"title":"One advertiser in detail","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/ads/advertisers/{advertiserKey}","href":"/api-reference/ads/one-advertiser-in-detail"},{"title":"Ads over time","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/ads/trends","href":"/api-reference/ads/ads-over-time"},{"title":"Ad creatives","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/ads/creatives","href":"/api-reference/ads/ad-creatives"},{"title":"Ads by prompt","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/ads/prompts","href":"/api-reference/ads/ads-by-prompt"},{"title":"Answers with an ad","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/ads/answers","href":"/api-reference/ads/answers-with-an-ad"}]},{"group":"Recommendations","pages":[{"title":"List recommendations","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/recommendations","href":"/api-reference/recommendations/list-recommendations"},{"title":"Update recommendations","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/brands/{id}/recommendations/generate","href":"/api-reference/recommendations/update-recommendations"},{"title":"Delete a recommendation","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/brands/{id}/recommendations/{recId}","href":"/api-reference/recommendations/delete-a-recommendation"},{"title":"Complete, dismiss or restore","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/brands/{id}/recommendations/{recId}","href":"/api-reference/recommendations/complete-dismiss-or-restore"}]},{"group":"Audit reports","pages":[{"title":"List audit reports","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/audit-reports","href":"/api-reference/audit-reports/list-audit-reports"},{"title":"Run an audit","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/audit-reports","href":"/api-reference/audit-reports/run-an-audit"},{"title":"Get an audit report","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/audit-reports/{id}","href":"/api-reference/audit-reports/get-an-audit-report"},{"title":"Delete an audit report","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/audit-reports/{id}","href":"/api-reference/audit-reports/delete-an-audit-report"}]},{"group":"Content generations","pages":[{"title":"List generations","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/generations","href":"/api-reference/content-generations/list-generations"},{"title":"Generate a brief","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/brands/{id}/generations","href":"/api-reference/content-generations/generate-a-brief"},{"title":"Get a generation","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/generations/{generationId}","href":"/api-reference/content-generations/get-a-generation"},{"title":"Delete a generation","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/brands/{id}/generations/{generationId}","href":"/api-reference/content-generations/delete-a-generation"},{"title":"Update a generation","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/brands/{id}/generations/{generationId}","href":"/api-reference/content-generations/update-a-generation"},{"title":"Write the article from its brief","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/brands/{id}/generations/{generationId}/draft","href":"/api-reference/content-generations/write-the-article-from-its-brief"}]},{"group":"Content optimizations","pages":[{"title":"List optimizations","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/optimizations","href":"/api-reference/content-optimizations/list-optimizations"},{"title":"Analyse a page or pasted content","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/brands/{id}/optimizations","href":"/api-reference/content-optimizations/analyse-a-page-or-pasted-content"},{"title":"Get an optimization","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/optimizations/{optId}","href":"/api-reference/content-optimizations/get-an-optimization"},{"title":"Delete an optimization","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/brands/{id}/optimizations/{optId}","href":"/api-reference/content-optimizations/delete-an-optimization"},{"title":"Re-score an optimization","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/brands/{id}/optimizations/{optId}/rescore","href":"/api-reference/content-optimizations/re-score-an-optimization"}]}]}]},{"tab":"MCP Documentation","pages":[{"title":"MCP Documentation","href":"/mcp/introduction"}]}]},"basePath":"","title":"Ads summary - Geoptie Docs","buildId":"dpl_6PxPD4Fj1JDU9BJxEHvfdUmxKThw","deploymentId":"dpl_6PxPD4Fj1JDU9BJxEHvfdUmxKThw","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CASS2Vpq.js","utils-4k9fyWRu.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-UU-UueZb.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BgJ0LOYq.js","snippetPresets-CMgzlMR-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BzEJegkK.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CZuQIZdk.js","shallow-Bw5arfMA.js","getApiPlaygroundDisplay-Ds834aVN.js","CodeSnippet-CKzmjw9L.js","CodeSnippets-BRpgomdp.js","Page-DvEUoD2H.js","getPastedJson-B0N-Tn76.js","icon-DASMs9nC.js","MethodPill-BA6DBLqx.js","DuplicateIcon-BMT5qfbJ.js","createIcon-CNfwVWPx.js","DynamicMarkdown-JYyBNlrJ.js","SectionHeading-BbZnmz8a.js","axios-vUo_bRtp.js","Markdown-LUU0YLpA.js","clsx-Di4ek5Ae.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-VEVWQCR4.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CPszyu99.js"]}