{
"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 by prompt
Every prompt this brand tracks, with how often its answers showed an ad, the top advertiser, and how often those answers named your brand. A high ad rate with a low mention rate is a prompt where others pay to appear and you are missing.
{
"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."
}
}
True when total_count exceeds the rows returned, so this is a truncated set and not all of them.
{"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-by-prompt","slug":"/api-reference/ads/ads-by-prompt","pageMetadata":{"title":"Ads by prompt","description":"Every prompt this brand tracks, with how often its answers showed an ad, the top advertiser, and how often those answers named your brand. A high ad rate with a low mention rate is a prompt where others pay to appear and you are missing.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/ads/prompts","href":"/api-reference/ads/ads-by-prompt","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: \"Every prompt this brand tracks, with how often its answers showed an ad, the top advertiser, and how often those answers named your brand. A high ad rate with a low mention rate is a prompt where others pay to appear and you are missing.\"\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 by prompt","description":"Every prompt this brand tracks, with how often its answers showed an ad, the top advertiser, and how often those answers named your brand. A high ad rate with a low mention rate is a prompt where others pay to appear and you are missing.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/ads/prompts","href":"/api-reference/ads/ads-by-prompt","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/geoptie/2140aa35ebe2fded/logo/build-wordmark.js"],"openApiReferenceData":{"operation":{"tags":["Ads"],"summary":"Ads by prompt","description":"Every prompt this brand tracks, with how often its answers showed an ad, the top advertiser, and how often those answers named your brand. A high ad rate with a low mention rate is a prompt where others pay to appear and you are missing.","parameters":["15a358e7-0e8d-472c-a7bc-70c5f6ce8e22","a0f45ad8-eef3-4e12-8a4e-216990e2e2d8","f71f559a-9f90-45ac-8ec4-41abcd57e9cf","72868400-8f3a-4ac6-8870-1399d45ed576","065859d2-ed3a-4aac-8684-7b7e54878bed","77290783-a232-4097-ab29-1879b0d09fc4","2363ed78-4beb-4441-95d7-f6cb3c98e1d4"],"responses":{"200":"fdfb1699-27af-4127-af34-275bbeb134bd","400":"d2ddf672-3e73-43b8-9f06-9f7b8e7fedd7","401":"3f47b4fa-48d0-424b-b9c9-a55d412ab2f9","402":"407fd2dd-0451-4d72-b37d-e96cd2f1b3af","403":"c20f2c5c-224c-4ced-b5ae-35b10010879e","404":"b945907f-b169-471a-a220-cf8fcbebfe50","429":"f3f3c956-5056-4469-a0ec-170f17232238","500":"d1c19287-2ba4-41d3-b083-97baf62d837b"},"operationId":"listAdPrompts","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/prompts","baseUrlOptions":["https://api.geoptie.com"],"title":"Ads by prompt","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"15a358e7-0e8d-472c-a7bc-70c5f6ce8e22":{"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"},"a0f45ad8-eef3-4e12-8a4e-216990e2e2d8":{"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>"}},"f71f559a-9f90-45ac-8ec4-41abcd57e9cf":{"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"},"72868400-8f3a-4ac6-8870-1399d45ed576":{"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"},"065859d2-ed3a-4aac-8684-7b7e54878bed":{"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"},"77290783-a232-4097-ab29-1879b0d09fc4":{"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>[]"}},"2363ed78-4beb-4441-95d7-f6cb3c98e1d4":{"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":{"fdfb1699-27af-4127-af34-275bbeb134bd":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"prompt_id":{"type":"string","format":"uuid","uniqueKey":"data.items.[INDEX].prompt_id","typeLabel":"string\u003cuuid>"},"prompt_text":{"type":"string","uniqueKey":"data.items.[INDEX].prompt_text","typeLabel":"string"},"topic_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"data.items.[INDEX].topic_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"data.items.[INDEX].topic_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].topic_id","typeLabel":"string\u003cuuid> | null"},"topic_name":{"oneOf":[{"type":"string","uniqueKey":"data.items.[INDEX].topic_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.items.[INDEX].topic_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].topic_name","typeLabel":"string | null"},"country":{"oneOf":[{"type":"string","uniqueKey":"data.items.[INDEX].country.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.items.[INDEX].country.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].country","typeLabel":"string | null"},"answers":{"type":"integer","description":"ChatGPT answers checked.","uniqueKey":"data.items.[INDEX].answers","typeLabel":"integer"},"answers_with_ads":{"type":"integer","uniqueKey":"data.items.[INDEX].answers_with_ads","typeLabel":"integer"},"ad_coverage_pct":{"oneOf":[{"type":"number","description":"0-100.","uniqueKey":"data.items.[INDEX].ad_coverage_pct.oneOf.0","typeLabel":"number"},{"type":"null","description":"0-100.","uniqueKey":"data.items.[INDEX].ad_coverage_pct.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].ad_coverage_pct","typeLabel":"number | null"},"ads":{"type":"integer","uniqueKey":"data.items.[INDEX].ads","typeLabel":"integer"},"advertisers":{"type":"integer","uniqueKey":"data.items.[INDEX].advertisers","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.items.[INDEX].top_advertiser.oneOf.0.advertiser_key","typeLabel":"string"},"name":{"oneOf":[{"type":"string","uniqueKey":"data.items.[INDEX].top_advertiser.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.items.[INDEX].top_advertiser.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].top_advertiser.oneOf.0.name","typeLabel":"string | null"},"ads":{"type":"integer","uniqueKey":"data.items.[INDEX].top_advertiser.oneOf.0.ads","typeLabel":"integer"},"is_competitor":{"type":"boolean","uniqueKey":"data.items.[INDEX].top_advertiser.oneOf.0.is_competitor","typeLabel":"boolean"}},"uniqueKey":"data.items.[INDEX].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"}]},"ads":{"type":"integer"},"is_competitor":{"type":"boolean"}},"uniqueKey":"data.items.[INDEX].top_advertiser.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].top_advertiser","typeLabel":"object | null"},"mentioned_pct":{"oneOf":[{"type":"number","description":"0-100. Share of this prompt's answers with an ad that also named your brand. Low values are prompts where others advertise and the answer leaves you out.","uniqueKey":"data.items.[INDEX].mentioned_pct.oneOf.0","typeLabel":"number"},{"type":"null","description":"0-100. Share of this prompt's answers with an ad that also named your brand. Low values are prompts where others advertise and the answer leaves you out.","uniqueKey":"data.items.[INDEX].mentioned_pct.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].mentioned_pct","typeLabel":"number | null"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"has_more":{"type":"boolean","description":"Always false: this grain does not page.","uniqueKey":"has_more","typeLabel":"boolean"},"next_cursor":{"oneOf":[{"type":"string","description":"Always null: this grain does not page.","uniqueKey":"next_cursor.oneOf.0","typeLabel":"string"},{"type":"null","description":"Always null: this grain does not page.","uniqueKey":"next_cursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_cursor","typeLabel":"string | null"},"total_count":{"type":"integer","description":"How many rows matched in total, before `limit`.","uniqueKey":"total_count","typeLabel":"integer"},"capped":{"type":"boolean","description":"True when `total_count` exceeds the rows returned, so this is a truncated set and not all of them.","uniqueKey":"capped","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":[{"prompt_id":"3f9a2c14-8b7e-4d61-a052-c7e4b9138265","prompt_text":"best project management software for small teams","topic_id":"5d2e8f31-9a4c-4b78-8e13-6f0a7c25d894","topic_name":"Project management","country":"US","answers":30,"answers_with_ads":24,"ad_coverage_pct":80,"ads":24,"advertisers":9,"top_advertiser":{"advertiser_key":"globex.com","name":"Globex","ads":7,"is_competitor":true},"mentioned_pct":12.5},{"prompt_id":"c2d85f3a-6e19-4b07-8a4c-5f9e1d3b7a20","prompt_text":"project management tool with time tracking","topic_id":"5d2e8f31-9a4c-4b78-8e13-6f0a7c25d894","topic_name":"Project management","country":"US","answers":30,"answers_with_ads":6,"ad_coverage_pct":20,"ads":6,"advertisers":4,"top_advertiser":{"advertiser_key":"initech.com","name":"Initech","ads":3,"is_competitor":false},"mentioned_pct":83.3}],"has_more":false,"next_cursor":null,"total_count":2,"capped":false},"examples":{"Example":{"title":"Example","value":{"data":[{"prompt_id":"3f9a2c14-8b7e-4d61-a052-c7e4b9138265","prompt_text":"best project management software for small teams","topic_id":"5d2e8f31-9a4c-4b78-8e13-6f0a7c25d894","topic_name":"Project management","country":"US","answers":30,"answers_with_ads":24,"ad_coverage_pct":80,"ads":24,"advertisers":9,"top_advertiser":{"advertiser_key":"globex.com","name":"Globex","ads":7,"is_competitor":true},"mentioned_pct":12.5},{"prompt_id":"c2d85f3a-6e19-4b07-8a4c-5f9e1d3b7a20","prompt_text":"project management tool with time tracking","topic_id":"5d2e8f31-9a4c-4b78-8e13-6f0a7c25d894","topic_name":"Project management","country":"US","answers":30,"answers_with_ads":6,"ad_coverage_pct":20,"ads":6,"advertisers":4,"top_advertiser":{"advertiser_key":"initech.com","name":"Initech","ads":3,"is_competitor":false},"mentioned_pct":83.3}],"has_more":false,"next_cursor":null,"total_count":2,"capped":false}}},"exampleType":"examples"}},"exampleType":"examples"},"d2ddf672-3e73-43b8-9f06-9f7b8e7fedd7":{"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"},"3f47b4fa-48d0-424b-b9c9-a55d412ab2f9":{"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"},"407fd2dd-0451-4d72-b37d-e96cd2f1b3af":{"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"},"c20f2c5c-224c-4ced-b5ae-35b10010879e":{"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"},"b945907f-b169-471a-a220-cf8fcbebfe50":{"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"},"f3f3c956-5056-4469-a0ec-170f17232238":{"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"},"d1c19287-2ba4-41d3-b083-97baf62d837b":{"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 by prompt - Geoptie Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T11:13:15.298Z","originalFileLocation":"api-reference/ads/ads-by-prompt.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=\"Every prompt this brand tracks, with how often its answers showed an ad, the top advertiser, and how often those answers named your brand. A high ad rate with a low mention rate is a prompt where others pay to appear and you are missing.\">\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 by prompt - Geoptie Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Every prompt this brand tracks, with how often its answers showed an ad, the top advertiser, and how often those answers named your brand. A high ad rate with a low mention rate is a prompt where others pay to appear and you are missing.\">\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-by-prompt\">\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+by+prompt\u0026amp;description=Every+prompt+this+brand+tracks%2C+with+how+often+its+answers+showed+an+ad%2C+the+top+advertiser%2C+and+how+often+those+answers+named+your+brand.+A+high+ad+rate+with+a\u0026amp;theme=7601e87fdf07654df26d6c19\u0026amp;signature=8e5a9cf825d2939c77b3519795b52e7762efc4aa91b9a930714fb6fc82ad6e37\">\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 by prompt - Geoptie Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Every prompt this brand tracks, with how often its answers showed an ad, the top advertiser, and how often those answers named your brand. A high ad rate with a low mention rate is a prompt where others pay to appear and you are missing.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://geoptie.mintlify.site/docs/_mintlify/api/og/v2?division=Ads\u0026amp;title=Ads+by+prompt\u0026amp;description=Every+prompt+this+brand+tracks%2C+with+how+often+its+answers+showed+an+ad%2C+the+top+advertiser%2C+and+how+often+those+answers+named+your+brand.+A+high+ad+rate+with+a\u0026amp;theme=7601e87fdf07654df26d6c19\u0026amp;signature=8e5a9cf825d2939c77b3519795b52e7762efc4aa91b9a930714fb6fc82ad6e37\">\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-by-prompt\">\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-by-prompt.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-by-prompt#webpage\",\"url\":\"https://geoptie.com/docs/api-reference/ads/ads-by-prompt\",\"name\":\"Ads by prompt\",\"description\":\"Every prompt this brand tracks, with how often its answers showed an ad, the top advertiser, and how often those answers named your brand. A high ad rate with a low mention rate is a prompt where others pay to appear and you are missing.\",\"dateModified\":\"2026-11-12T11:13:15.298Z\",\"isPartOf\":{\"@id\":\"https://geoptie.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://geoptie.com/docs/api-reference/ads/ads-by-prompt#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://geoptie.com/docs/api-reference/ads/ads-by-prompt#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\",\"item\":\"https://geoptie.com/docs/api-reference/ads/ads-summary\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Ads by prompt\",\"item\":\"https://geoptie.com/docs/api-reference/ads/ads-by-prompt\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://geoptie.com/docs/api-reference/ads/ads-by-prompt#apireference\",\"headline\":\"Ads by prompt\",\"name\":\"Ads by prompt\",\"description\":\"Every prompt this brand tracks, with how often its answers showed an ad, the top advertiser, and how often those answers named your brand. A high ad rate with a low mention rate is a prompt where others pay to appear and you are missing.\",\"url\":\"https://geoptie.com/docs/api-reference/ads/ads-by-prompt\",\"mainEntityOfPage\":{\"@id\":\"https://geoptie.com/docs/api-reference/ads/ads-by-prompt#webpage\"},\"dateModified\":\"2026-11-12T11:13:15.298Z\",\"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-by-prompt.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","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","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","description":"The ads themselves: headline, text, image and landing link, with how often each appeared, most first. Narrow to one advertiser or prompt.","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","description":"The answers that showed an ad, newest first, with a short excerpt and whether your brand was named. Narrow to one advertiser, ad or prompt to see where it ran.","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 by prompt - 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"]}