{
"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."
}
}
Competitors
Tracked competitors over time
Daily or weekly series for the brand and each tracked competitor: visibility, share of voice, mentions, position, sentiment, win rate and citations of their own website, over the brand’s tracked prompts. Fast at any window length. A competitor tracked recently may have history_from null until its history is ready.
Pass competitor_id for one competitor’s trend (or a few). It only narrows which competitors are returned: share of voice is still computed over the whole tracked set, so the numbers match the unfiltered response. Narrow the prompts with topic_id or prompt_id, and add compare=true for the previous period and the change.
{
"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.4270","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":"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":"site-roles","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},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","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/competitors/tracked-competitors-over-time","slug":"/api-reference/competitors/tracked-competitors-over-time","pageMetadata":{"title":"Tracked competitors over time","description":"Daily or weekly series for the brand and each tracked competitor: visibility, share of voice, mentions, position, sentiment, win rate and citations of their own website, over the brand's tracked prompts. Fast at any window length. A competitor tracked recently may have `history_from` null until its history is ready.\n\nPass `competitor_id` for one competitor's trend (or a few). It only narrows which competitors are returned: share of voice is still computed over the whole tracked set, so the numbers match the unfiltered response. Narrow the prompts with `topic_id` or `prompt_id`, and add `compare=true` for the previous period and the change.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/competitors/trends","href":"/api-reference/competitors/tracked-competitors-over-time","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Daily or weekly series for the brand and each tracked competitor: visibility, share of voice, mentions, position, sentiment, win rate and citations of their own website, over the brand’s tracked prompts. Fast at any window length. A competitor tracked recently may have \", _jsx(_components.code, {\n children: \"history_from\"\n }), \" null until its history is ready.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Pass \", _jsx(_components.code, {\n children: \"competitor_id\"\n }), \" for one competitor’s trend (or a few). It only narrows which competitors are returned: share of voice is still computed over the whole tracked set, so the numbers match the unfiltered response. Narrow the prompts with \", _jsx(_components.code, {\n children: \"topic_id\"\n }), \" or \", _jsx(_components.code, {\n children: \"prompt_id\"\n }), \", and add \", _jsx(_components.code, {\n children: \"compare=true\"\n }), \" for the previous period and the change.\"]\n })]\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":"Tracked competitors over time","description":"Daily or weekly series for the brand and each tracked competitor: visibility, share of voice, mentions, position, sentiment, win rate and citations of their own website, over the brand's tracked prompts. Fast at any window length. A competitor tracked recently may have `history_from` null until its history is ready.\n\nPass `competitor_id` for one competitor's trend (or a few). It only narrows which competitors are returned: share of voice is still computed over the whole tracked set, so the numbers match the unfiltered response. Narrow the prompts with `topic_id` or `prompt_id`, and add `compare=true` for the previous period and the change.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/brands/{id}/competitors/trends","href":"/api-reference/competitors/tracked-competitors-over-time","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/geoptie/2140aa35ebe2fded/logo/build-wordmark.js"],"openApiReferenceData":{"operation":{"tags":["Competitors"],"summary":"Tracked competitors over time","description":"Daily or weekly series for the brand and each tracked competitor: visibility, share of voice, mentions, position, sentiment, win rate and citations of their own website, over the brand's tracked prompts. Fast at any window length. A competitor tracked recently may have `history_from` null until its history is ready.\n\nPass `competitor_id` for one competitor's trend (or a few). It only narrows which competitors are returned: share of voice is still computed over the whole tracked set, so the numbers match the unfiltered response. Narrow the prompts with `topic_id` or `prompt_id`, and add `compare=true` for the previous period and the change.","parameters":["a416c337-c352-45ce-9b0c-17248b65de42","4f8ad13a-e853-4cb9-b0f9-3ccef68c1ebc","0eb7bcbb-d511-42dd-b47d-c27ff8d32de9","12945176-664d-404c-8068-9c3abd6b49b1","a2b95c9b-48df-4177-954d-d3655b61c94d","608b15ff-9ed4-41e0-83d0-5b87fd100425","7fac406a-90c4-42c6-a877-2805235a498a","a3c310cb-2132-44e4-bb5f-9a0e32562782","9f1ec4d5-6a82-47c1-8d71-a01786a22aa1","30373063-579e-4cf0-8eca-58ab26131f7a"],"responses":{"200":"d80f0d27-752d-465a-afe9-d1c4e91e9165","400":"4ac24408-a8d6-4faf-82a0-bd938b988a32","401":"f758f513-fb20-44e0-8899-2136c1ec396f","402":"d2762e47-eec8-49f8-9473-73e371c3a4f8","403":"cdb40e1c-e05c-4e1b-ab5f-bd41771307d0","404":"86bbe11e-f41c-4084-a141-5c9e24250c56","429":"e9559d87-0527-4d73-ba70-41bb02ac0b72","500":"a6756940-45b9-4282-ab67-cb7081b2a217"},"operationId":"getCompetitorTrends","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}/competitors/trends","baseUrlOptions":["https://api.geoptie.com"],"title":"Tracked competitors over time","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"a416c337-c352-45ce-9b0c-17248b65de42":{"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"},"4f8ad13a-e853-4cb9-b0f9-3ccef68c1ebc":{"name":"engine","in":"query","required":false,"description":"Restrict to one engine. Omit for the all-engine rollup.","schema":{"type":"string","description":"Restrict to one engine. Omit for the all-engine rollup.\nStable public engine identifier. Internal model names are never exposed.","enum":["chatgpt","claude","perplexity","gemini","google_ai_overviews","google_ai_mode","copilot"],"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"example":"chatgpt"},"0eb7bcbb-d511-42dd-b47d-c27ff8d32de9":{"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"},"12945176-664d-404c-8068-9c3abd6b49b1":{"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"},"a2b95c9b-48df-4177-954d-d3655b61c94d":{"name":"granularity","in":"query","required":false,"description":"Bucket size.","schema":{"type":"string","enum":["day","week"],"default":"day","isRequired":false,"description":"Bucket size.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"example":"day"},"608b15ff-9ed4-41e0-83d0-5b87fd100425":{"name":"competitor_id","in":"query","required":false,"explode":true,"description":"Repeatable. Return only these tracked competitors (plus the brand). Ids from `/tracked-competitors`, or `competitor_id` on `/competitors` rows.","schema":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":false,"description":"Repeatable. Return only these tracked competitors (plus the brand). Ids from `/tracked-competitors`, or `competitor_id` on `/competitors` rows.","uniqueKey":"","typeLabel":"string\u003cuuid>[]"}},"7fac406a-90c4-42c6-a877-2805235a498a":{"name":"topic_id","in":"query","required":false,"explode":true,"description":"Repeatable. Restrict to prompts in these topics. Cannot be combined with `prompt_id`.","schema":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":false,"description":"Repeatable. Restrict to prompts in these topics. Cannot be combined with `prompt_id`.","uniqueKey":"","typeLabel":"string\u003cuuid>[]"}},"a3c310cb-2132-44e4-bb5f-9a0e32562782":{"name":"prompt_id","in":"query","required":false,"description":"Restrict to one prompt this brand tracks: who beats you on that question.","schema":{"type":"string","format":"uuid","isRequired":false,"description":"Restrict to one prompt this brand tracks: who beats you on that question.","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"9f1ec4d5-6a82-47c1-8d71-a01786a22aa1":{"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>"}},"30373063-579e-4cf0-8eca-58ab26131f7a":{"name":"compare","in":"query","required":false,"description":"Adds `previous` and `changes` to the brand and each competitor, for the same-length window before this one.","schema":{"type":"boolean","default":false,"isRequired":false,"description":"Adds `previous` and `changes` to the brand and each competitor, for the same-length window before this one.","uniqueKey":"","typeLabel":"boolean"}}},"responses":{"d80f0d27-752d-465a-afe9-d1c4e91e9165":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"granularity":{"type":"string","enum":["day","week"],"uniqueKey":"data.granularity","typeLabel":"enum\u003cstring>"},"from":{"type":"string","format":"date","uniqueKey":"data.from","typeLabel":"string\u003cdate>"},"to":{"type":"string","format":"date","uniqueKey":"data.to","typeLabel":"string\u003cdate>"},"previous_from":{"type":"string","format":"date","description":"Only with `compare=true`.","uniqueKey":"data.previous_from","typeLabel":"string\u003cdate>"},"previous_to":{"type":"string","format":"date","description":"Only with `compare=true`.","uniqueKey":"data.previous_to","typeLabel":"string\u003cdate>"},"engine":{"oneOf":[{"type":"string","uniqueKey":"data.engine.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.engine.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.engine","typeLabel":"string | null"},"filters":{"type":"object","description":"The filters this response was computed under.","properties":{"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>[]"},"prompt_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"data.filters.prompt_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"data.filters.prompt_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.filters.prompt_id","typeLabel":"string\u003cuuid> | null"},"branding":{"type":"string","enum":["all","branded","non_branded"],"uniqueKey":"data.filters.branding","typeLabel":"enum\u003cstring>"},"competitor_ids":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"data.filters.competitor_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"description":"Trends only. Empty means every tracked competitor.","uniqueKey":"data.filters.competitor_ids","typeLabel":"string\u003cuuid>[]"}},"example":{"topic_ids":[],"prompt_id":null,"branding":"all","competitor_ids":["a4d29e71-5c83-4b16-9f0e-6b3c8d17e254"]},"uniqueKey":"data.filters","typeLabel":"object"},"brand":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"uuid","description":"Tracked competitor id; null for the brand itself.","uniqueKey":"data.brand.id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Tracked competitor id; null for the brand itself.","uniqueKey":"data.brand.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.brand.id","typeLabel":"string\u003cuuid> | null"},"brand_name":{"type":"string","uniqueKey":"data.brand.brand_name","typeLabel":"string"},"is_your_brand":{"type":"boolean","uniqueKey":"data.brand.is_your_brand","typeLabel":"boolean"},"domains":{"type":"array","items":{"type":"string","uniqueKey":"data.brand.domains.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.brand.domains","typeLabel":"string[]"},"history_from":{"oneOf":[{"type":"string","format":"date","description":"Earliest date with complete history. Null until its history is ready after the competitor is tracked.","uniqueKey":"data.brand.history_from.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Earliest date with complete history. Null until its history is ready after the competitor is tracked.","uniqueKey":"data.brand.history_from.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.brand.history_from","typeLabel":"string\u003cdate> | null"},"totals":{"type":"object","description":"The brand's answered responses are the denominator for visibility and detection; own plus tracked mentions are the denominator for share of voice.","properties":{"responses_answered":{"type":"integer","uniqueKey":"data.brand.totals.responses_answered","typeLabel":"integer"},"responses_with_brand":{"type":"integer","uniqueKey":"data.brand.totals.responses_with_brand","typeLabel":"integer"},"mention_count":{"type":"integer","uniqueKey":"data.brand.totals.mention_count","typeLabel":"integer"},"citation_count":{"type":"integer","description":"Citations of this brand's own website in the same answers.","uniqueKey":"data.brand.totals.citation_count","typeLabel":"integer"},"detection_rate":{"type":"number","description":"0-100: share of answers that mention the brand.","uniqueKey":"data.brand.totals.detection_rate","typeLabel":"number"},"visibility_score":{"type":"number","description":"0-100: detection weighted by position and top-3 share.","uniqueKey":"data.brand.totals.visibility_score","typeLabel":"number"},"avg_position":{"oneOf":[{"type":"number","uniqueKey":"data.brand.totals.avg_position.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.brand.totals.avg_position.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.brand.totals.avg_position","typeLabel":"number | null"},"avg_sentiment":{"oneOf":[{"type":"number","uniqueKey":"data.brand.totals.avg_sentiment.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.brand.totals.avg_sentiment.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.brand.totals.avg_sentiment","typeLabel":"number | null"},"top3_visibility":{"oneOf":[{"type":"number","uniqueKey":"data.brand.totals.top3_visibility.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.brand.totals.top3_visibility.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.brand.totals.top3_visibility","typeLabel":"number | null"},"win_rate":{"type":"number","description":"0-100: share of answers where the brand is named first.","uniqueKey":"data.brand.totals.win_rate","typeLabel":"number"},"share_of_voice":{"type":"number","description":"0-100, over the brand plus its tracked competitors.","uniqueKey":"data.brand.totals.share_of_voice","typeLabel":"number"}},"example":{"responses_answered":180,"responses_with_brand":51,"mention_count":51,"citation_count":19,"detection_rate":28.33,"visibility_score":29.5,"avg_position":2.4,"avg_sentiment":0.406,"top3_visibility":70.59,"win_rate":8.33,"share_of_voice":36.69},"uniqueKey":"data.brand.totals","typeLabel":"object"},"previous":{"type":"object","description":"Only with `compare=true`: totals for the same-length window before this one.","example":{"responses_answered":180,"responses_with_brand":51,"mention_count":51,"citation_count":19,"detection_rate":28.33,"visibility_score":29.5,"avg_position":2.4,"avg_sentiment":0.406,"top3_visibility":70.59,"win_rate":8.33,"share_of_voice":36.69},"properties":{"responses_answered":{"type":"integer","uniqueKey":"data.brand.previous.responses_answered","typeLabel":"integer"},"responses_with_brand":{"type":"integer","uniqueKey":"data.brand.previous.responses_with_brand","typeLabel":"integer"},"mention_count":{"type":"integer","uniqueKey":"data.brand.previous.mention_count","typeLabel":"integer"},"citation_count":{"type":"integer","description":"Citations of this brand's own website in the same answers.","uniqueKey":"data.brand.previous.citation_count","typeLabel":"integer"},"detection_rate":{"type":"number","description":"0-100: share of answers that mention the brand.","uniqueKey":"data.brand.previous.detection_rate","typeLabel":"number"},"visibility_score":{"type":"number","description":"0-100: detection weighted by position and top-3 share.","uniqueKey":"data.brand.previous.visibility_score","typeLabel":"number"},"avg_position":{"oneOf":[{"type":"number","uniqueKey":"data.brand.previous.avg_position.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.brand.previous.avg_position.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.brand.previous.avg_position","typeLabel":"number | null"},"avg_sentiment":{"oneOf":[{"type":"number","uniqueKey":"data.brand.previous.avg_sentiment.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.brand.previous.avg_sentiment.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.brand.previous.avg_sentiment","typeLabel":"number | null"},"top3_visibility":{"oneOf":[{"type":"number","uniqueKey":"data.brand.previous.top3_visibility.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.brand.previous.top3_visibility.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.brand.previous.top3_visibility","typeLabel":"number | null"},"win_rate":{"type":"number","description":"0-100: share of answers where the brand is named first.","uniqueKey":"data.brand.previous.win_rate","typeLabel":"number"},"share_of_voice":{"type":"number","description":"0-100, over the brand plus its tracked competitors.","uniqueKey":"data.brand.previous.share_of_voice","typeLabel":"number"}},"uniqueKey":"data.brand.previous","typeLabel":"object"},"changes":{"type":"object","additionalProperties":{"oneOf":[{"type":"number","uniqueKey":"data.brand.changes.additionalProperties.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.brand.changes.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.brand.changes.additionalProperties","typeLabel":"number | null"},"description":"Only with `compare=true`: `totals` minus `previous` for visibility_score, share_of_voice, detection_rate, avg_position, avg_sentiment, top3_visibility, win_rate, mention_count and citation_count. Null where either side is null.","uniqueKey":"data.brand.changes","typeLabel":"object"},"series":{"type":"array","items":{"type":"object","description":"The brand's answered responses are the denominator for visibility and detection; own plus tracked mentions are the denominator for share of voice.","example":{"responses_answered":60,"responses_with_brand":17,"mention_count":17,"citation_count":6,"detection_rate":28.33,"visibility_score":29.5,"avg_position":2.4,"avg_sentiment":0.404,"top3_visibility":70.59,"win_rate":8.33,"share_of_voice":37.78,"date":"2026-11-08"},"properties":{"responses_answered":{"type":"integer","uniqueKey":"data.brand.series.items.[INDEX].responses_answered","typeLabel":"integer"},"responses_with_brand":{"type":"integer","uniqueKey":"data.brand.series.items.[INDEX].responses_with_brand","typeLabel":"integer"},"mention_count":{"type":"integer","uniqueKey":"data.brand.series.items.[INDEX].mention_count","typeLabel":"integer"},"citation_count":{"type":"integer","description":"Citations of this brand's own website in the same answers.","uniqueKey":"data.brand.series.items.[INDEX].citation_count","typeLabel":"integer"},"detection_rate":{"type":"number","description":"0-100: share of answers that mention the brand.","uniqueKey":"data.brand.series.items.[INDEX].detection_rate","typeLabel":"number"},"visibility_score":{"type":"number","description":"0-100: detection weighted by position and top-3 share.","uniqueKey":"data.brand.series.items.[INDEX].visibility_score","typeLabel":"number"},"avg_position":{"oneOf":[{"type":"number","uniqueKey":"data.brand.series.items.[INDEX].avg_position.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.brand.series.items.[INDEX].avg_position.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.brand.series.items.[INDEX].avg_position","typeLabel":"number | null"},"avg_sentiment":{"oneOf":[{"type":"number","uniqueKey":"data.brand.series.items.[INDEX].avg_sentiment.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.brand.series.items.[INDEX].avg_sentiment.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.brand.series.items.[INDEX].avg_sentiment","typeLabel":"number | null"},"top3_visibility":{"oneOf":[{"type":"number","uniqueKey":"data.brand.series.items.[INDEX].top3_visibility.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.brand.series.items.[INDEX].top3_visibility.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.brand.series.items.[INDEX].top3_visibility","typeLabel":"number | null"},"win_rate":{"type":"number","description":"0-100: share of answers where the brand is named first.","uniqueKey":"data.brand.series.items.[INDEX].win_rate","typeLabel":"number"},"share_of_voice":{"type":"number","description":"0-100, over the brand plus its tracked competitors.","uniqueKey":"data.brand.series.items.[INDEX].share_of_voice","typeLabel":"number"},"date":{"type":"string","format":"date","description":"Bucket start: the day, or the Monday of the week.","uniqueKey":"data.brand.series.items.[INDEX].date","typeLabel":"string\u003cdate>"}},"uniqueKey":"data.brand.series.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.brand.series","typeLabel":"object[]"}},"example":{"id":"a4d29e71-5c83-4b16-9f0e-6b3c8d17e254","brand_name":"Globex","is_your_brand":false,"domains":["globex.com"],"history_from":"2025-12-05","totals":{"responses_answered":180,"responses_with_brand":60,"mention_count":60,"citation_count":17,"detection_rate":33.33,"visibility_score":35.67,"avg_position":1.8,"avg_sentiment":0.376,"top3_visibility":85,"win_rate":15.56,"share_of_voice":43.17},"series":[{"date":"2026-11-08","responses_answered":60,"responses_with_brand":19,"mention_count":19,"citation_count":5,"detection_rate":31.67,"visibility_score":33.83,"avg_position":1.7,"avg_sentiment":0.376,"top3_visibility":84.21,"win_rate":15,"share_of_voice":42.22},{"date":"2026-11-09","responses_answered":60,"responses_with_brand":20,"mention_count":20,"citation_count":6,"detection_rate":33.33,"visibility_score":35.67,"avg_position":1.9,"avg_sentiment":0.381,"top3_visibility":85,"win_rate":15,"share_of_voice":42.55},{"date":"2026-11-10","responses_answered":60,"responses_with_brand":21,"mention_count":21,"citation_count":6,"detection_rate":35,"visibility_score":37.5,"avg_position":1.8,"avg_sentiment":0.372,"top3_visibility":85.71,"win_rate":16.67,"share_of_voice":44.68}]},"uniqueKey":"data.brand","typeLabel":"object"},"competitors":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"uuid","description":"Tracked competitor id; null for the brand itself.","uniqueKey":"data.competitors.items.[INDEX].id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Tracked competitor id; null for the brand itself.","uniqueKey":"data.competitors.items.[INDEX].id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.competitors.items.[INDEX].id","typeLabel":"string\u003cuuid> | null"},"brand_name":{"type":"string","uniqueKey":"data.competitors.items.[INDEX].brand_name","typeLabel":"string"},"is_your_brand":{"type":"boolean","uniqueKey":"data.competitors.items.[INDEX].is_your_brand","typeLabel":"boolean"},"domains":{"type":"array","items":{"type":"string","uniqueKey":"data.competitors.items.[INDEX].domains.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.competitors.items.[INDEX].domains","typeLabel":"string[]"},"history_from":{"oneOf":[{"type":"string","format":"date","description":"Earliest date with complete history. Null until its history is ready after the competitor is tracked.","uniqueKey":"data.competitors.items.[INDEX].history_from.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Earliest date with complete history. Null until its history is ready after the competitor is tracked.","uniqueKey":"data.competitors.items.[INDEX].history_from.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.competitors.items.[INDEX].history_from","typeLabel":"string\u003cdate> | null"},"totals":{"type":"object","description":"The brand's answered responses are the denominator for visibility and detection; own plus tracked mentions are the denominator for share of voice.","properties":{"responses_answered":{"type":"integer","uniqueKey":"data.competitors.items.[INDEX].totals.responses_answered","typeLabel":"integer"},"responses_with_brand":{"type":"integer","uniqueKey":"data.competitors.items.[INDEX].totals.responses_with_brand","typeLabel":"integer"},"mention_count":{"type":"integer","uniqueKey":"data.competitors.items.[INDEX].totals.mention_count","typeLabel":"integer"},"citation_count":{"type":"integer","description":"Citations of this brand's own website in the same answers.","uniqueKey":"data.competitors.items.[INDEX].totals.citation_count","typeLabel":"integer"},"detection_rate":{"type":"number","description":"0-100: share of answers that mention the brand.","uniqueKey":"data.competitors.items.[INDEX].totals.detection_rate","typeLabel":"number"},"visibility_score":{"type":"number","description":"0-100: detection weighted by position and top-3 share.","uniqueKey":"data.competitors.items.[INDEX].totals.visibility_score","typeLabel":"number"},"avg_position":{"oneOf":[{"type":"number","uniqueKey":"data.competitors.items.[INDEX].totals.avg_position.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.competitors.items.[INDEX].totals.avg_position.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.competitors.items.[INDEX].totals.avg_position","typeLabel":"number | null"},"avg_sentiment":{"oneOf":[{"type":"number","uniqueKey":"data.competitors.items.[INDEX].totals.avg_sentiment.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.competitors.items.[INDEX].totals.avg_sentiment.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.competitors.items.[INDEX].totals.avg_sentiment","typeLabel":"number | null"},"top3_visibility":{"oneOf":[{"type":"number","uniqueKey":"data.competitors.items.[INDEX].totals.top3_visibility.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.competitors.items.[INDEX].totals.top3_visibility.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.competitors.items.[INDEX].totals.top3_visibility","typeLabel":"number | null"},"win_rate":{"type":"number","description":"0-100: share of answers where the brand is named first.","uniqueKey":"data.competitors.items.[INDEX].totals.win_rate","typeLabel":"number"},"share_of_voice":{"type":"number","description":"0-100, over the brand plus its tracked competitors.","uniqueKey":"data.competitors.items.[INDEX].totals.share_of_voice","typeLabel":"number"}},"example":{"responses_answered":180,"responses_with_brand":51,"mention_count":51,"citation_count":19,"detection_rate":28.33,"visibility_score":29.5,"avg_position":2.4,"avg_sentiment":0.406,"top3_visibility":70.59,"win_rate":8.33,"share_of_voice":36.69},"uniqueKey":"data.competitors.items.[INDEX].totals","typeLabel":"object"},"previous":{"type":"object","description":"Only with `compare=true`: totals for the same-length window before this one.","example":{"responses_answered":180,"responses_with_brand":51,"mention_count":51,"citation_count":19,"detection_rate":28.33,"visibility_score":29.5,"avg_position":2.4,"avg_sentiment":0.406,"top3_visibility":70.59,"win_rate":8.33,"share_of_voice":36.69},"properties":{"responses_answered":{"type":"integer","uniqueKey":"data.competitors.items.[INDEX].previous.responses_answered","typeLabel":"integer"},"responses_with_brand":{"type":"integer","uniqueKey":"data.competitors.items.[INDEX].previous.responses_with_brand","typeLabel":"integer"},"mention_count":{"type":"integer","uniqueKey":"data.competitors.items.[INDEX].previous.mention_count","typeLabel":"integer"},"citation_count":{"type":"integer","description":"Citations of this brand's own website in the same answers.","uniqueKey":"data.competitors.items.[INDEX].previous.citation_count","typeLabel":"integer"},"detection_rate":{"type":"number","description":"0-100: share of answers that mention the brand.","uniqueKey":"data.competitors.items.[INDEX].previous.detection_rate","typeLabel":"number"},"visibility_score":{"type":"number","description":"0-100: detection weighted by position and top-3 share.","uniqueKey":"data.competitors.items.[INDEX].previous.visibility_score","typeLabel":"number"},"avg_position":{"oneOf":[{"type":"number","uniqueKey":"data.competitors.items.[INDEX].previous.avg_position.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.competitors.items.[INDEX].previous.avg_position.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.competitors.items.[INDEX].previous.avg_position","typeLabel":"number | null"},"avg_sentiment":{"oneOf":[{"type":"number","uniqueKey":"data.competitors.items.[INDEX].previous.avg_sentiment.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.competitors.items.[INDEX].previous.avg_sentiment.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.competitors.items.[INDEX].previous.avg_sentiment","typeLabel":"number | null"},"top3_visibility":{"oneOf":[{"type":"number","uniqueKey":"data.competitors.items.[INDEX].previous.top3_visibility.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.competitors.items.[INDEX].previous.top3_visibility.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.competitors.items.[INDEX].previous.top3_visibility","typeLabel":"number | null"},"win_rate":{"type":"number","description":"0-100: share of answers where the brand is named first.","uniqueKey":"data.competitors.items.[INDEX].previous.win_rate","typeLabel":"number"},"share_of_voice":{"type":"number","description":"0-100, over the brand plus its tracked competitors.","uniqueKey":"data.competitors.items.[INDEX].previous.share_of_voice","typeLabel":"number"}},"uniqueKey":"data.competitors.items.[INDEX].previous","typeLabel":"object"},"changes":{"type":"object","additionalProperties":{"oneOf":[{"type":"number","uniqueKey":"data.competitors.items.[INDEX].changes.additionalProperties.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.competitors.items.[INDEX].changes.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.competitors.items.[INDEX].changes.additionalProperties","typeLabel":"number | null"},"description":"Only with `compare=true`: `totals` minus `previous` for visibility_score, share_of_voice, detection_rate, avg_position, avg_sentiment, top3_visibility, win_rate, mention_count and citation_count. Null where either side is null.","uniqueKey":"data.competitors.items.[INDEX].changes","typeLabel":"object"},"series":{"type":"array","items":{"type":"object","description":"The brand's answered responses are the denominator for visibility and detection; own plus tracked mentions are the denominator for share of voice.","example":{"responses_answered":60,"responses_with_brand":17,"mention_count":17,"citation_count":6,"detection_rate":28.33,"visibility_score":29.5,"avg_position":2.4,"avg_sentiment":0.404,"top3_visibility":70.59,"win_rate":8.33,"share_of_voice":37.78,"date":"2026-11-08"},"properties":{"responses_answered":{"type":"integer","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].responses_answered","typeLabel":"integer"},"responses_with_brand":{"type":"integer","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].responses_with_brand","typeLabel":"integer"},"mention_count":{"type":"integer","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].mention_count","typeLabel":"integer"},"citation_count":{"type":"integer","description":"Citations of this brand's own website in the same answers.","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].citation_count","typeLabel":"integer"},"detection_rate":{"type":"number","description":"0-100: share of answers that mention the brand.","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].detection_rate","typeLabel":"number"},"visibility_score":{"type":"number","description":"0-100: detection weighted by position and top-3 share.","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].visibility_score","typeLabel":"number"},"avg_position":{"oneOf":[{"type":"number","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].avg_position.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].avg_position.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].avg_position","typeLabel":"number | null"},"avg_sentiment":{"oneOf":[{"type":"number","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].avg_sentiment.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].avg_sentiment.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].avg_sentiment","typeLabel":"number | null"},"top3_visibility":{"oneOf":[{"type":"number","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].top3_visibility.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].top3_visibility.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].top3_visibility","typeLabel":"number | null"},"win_rate":{"type":"number","description":"0-100: share of answers where the brand is named first.","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].win_rate","typeLabel":"number"},"share_of_voice":{"type":"number","description":"0-100, over the brand plus its tracked competitors.","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].share_of_voice","typeLabel":"number"},"date":{"type":"string","format":"date","description":"Bucket start: the day, or the Monday of the week.","uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX].date","typeLabel":"string\u003cdate>"}},"uniqueKey":"data.competitors.items.[INDEX].series.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.competitors.items.[INDEX].series","typeLabel":"object[]"}},"example":{"id":"a4d29e71-5c83-4b16-9f0e-6b3c8d17e254","brand_name":"Globex","is_your_brand":false,"domains":["globex.com"],"history_from":"2025-12-05","totals":{"responses_answered":180,"responses_with_brand":60,"mention_count":60,"citation_count":17,"detection_rate":33.33,"visibility_score":35.67,"avg_position":1.8,"avg_sentiment":0.376,"top3_visibility":85,"win_rate":15.56,"share_of_voice":43.17},"series":[{"date":"2026-11-08","responses_answered":60,"responses_with_brand":19,"mention_count":19,"citation_count":5,"detection_rate":31.67,"visibility_score":33.83,"avg_position":1.7,"avg_sentiment":0.376,"top3_visibility":84.21,"win_rate":15,"share_of_voice":42.22},{"date":"2026-11-09","responses_answered":60,"responses_with_brand":20,"mention_count":20,"citation_count":6,"detection_rate":33.33,"visibility_score":35.67,"avg_position":1.9,"avg_sentiment":0.381,"top3_visibility":85,"win_rate":15,"share_of_voice":42.55},{"date":"2026-11-10","responses_answered":60,"responses_with_brand":21,"mention_count":21,"citation_count":6,"detection_rate":35,"visibility_score":37.5,"avg_position":1.8,"avg_sentiment":0.372,"top3_visibility":85.71,"win_rate":16.67,"share_of_voice":44.68}]},"uniqueKey":"data.competitors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.competitors","typeLabel":"object[]"}},"example":{"granularity":"day","from":"2026-11-08","to":"2026-11-11","engine":null,"filters":{"topic_ids":[],"prompt_id":null,"branding":"all","competitor_ids":["a4d29e71-5c83-4b16-9f0e-6b3c8d17e254"]},"brand":{"id":null,"brand_name":"Acme","is_your_brand":true,"domains":["acme.com"],"history_from":null,"totals":{"responses_answered":180,"responses_with_brand":51,"mention_count":51,"citation_count":19,"detection_rate":28.33,"visibility_score":29.5,"avg_position":2.4,"avg_sentiment":0.406,"top3_visibility":70.59,"win_rate":8.33,"share_of_voice":36.69},"series":[{"date":"2026-11-08","responses_answered":60,"responses_with_brand":17,"mention_count":17,"citation_count":6,"detection_rate":28.33,"visibility_score":29.5,"avg_position":2.4,"avg_sentiment":0.404,"top3_visibility":70.59,"win_rate":8.33,"share_of_voice":37.78},{"date":"2026-11-09","responses_answered":60,"responses_with_brand":19,"mention_count":19,"citation_count":8,"detection_rate":31.67,"visibility_score":33.17,"avg_position":2.2,"avg_sentiment":0.422,"top3_visibility":73.68,"win_rate":10,"share_of_voice":40.43},{"date":"2026-11-10","responses_answered":60,"responses_with_brand":15,"mention_count":15,"citation_count":5,"detection_rate":25,"visibility_score":25.83,"avg_position":2.6,"avg_sentiment":0.389,"top3_visibility":66.67,"win_rate":6.67,"share_of_voice":31.91}]},"competitors":[{"id":"a4d29e71-5c83-4b16-9f0e-6b3c8d17e254","brand_name":"Globex","is_your_brand":false,"domains":["globex.com"],"history_from":"2025-12-05","totals":{"responses_answered":180,"responses_with_brand":60,"mention_count":60,"citation_count":17,"detection_rate":33.33,"visibility_score":35.67,"avg_position":1.8,"avg_sentiment":0.376,"top3_visibility":85,"win_rate":15.56,"share_of_voice":43.17},"series":[{"date":"2026-11-08","responses_answered":60,"responses_with_brand":19,"mention_count":19,"citation_count":5,"detection_rate":31.67,"visibility_score":33.83,"avg_position":1.7,"avg_sentiment":0.376,"top3_visibility":84.21,"win_rate":15,"share_of_voice":42.22},{"date":"2026-11-09","responses_answered":60,"responses_with_brand":20,"mention_count":20,"citation_count":6,"detection_rate":33.33,"visibility_score":35.67,"avg_position":1.9,"avg_sentiment":0.381,"top3_visibility":85,"win_rate":15,"share_of_voice":42.55},{"date":"2026-11-10","responses_answered":60,"responses_with_brand":21,"mention_count":21,"citation_count":6,"detection_rate":35,"visibility_score":37.5,"avg_position":1.8,"avg_sentiment":0.372,"top3_visibility":85.71,"win_rate":16.67,"share_of_voice":44.68}]}]},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"granularity":"day","from":"2026-11-08","to":"2026-11-11","engine":null,"filters":{"topic_ids":[],"prompt_id":null,"branding":"all","competitor_ids":["a4d29e71-5c83-4b16-9f0e-6b3c8d17e254"]},"brand":{"id":null,"brand_name":"Acme","is_your_brand":true,"domains":["acme.com"],"history_from":null,"totals":{"responses_answered":180,"responses_with_brand":51,"mention_count":51,"citation_count":19,"detection_rate":28.33,"visibility_score":29.5,"avg_position":2.4,"avg_sentiment":0.406,"top3_visibility":70.59,"win_rate":8.33,"share_of_voice":36.69},"series":[{"date":"2026-11-08","responses_answered":60,"responses_with_brand":17,"mention_count":17,"citation_count":6,"detection_rate":28.33,"visibility_score":29.5,"avg_position":2.4,"avg_sentiment":0.404,"top3_visibility":70.59,"win_rate":8.33,"share_of_voice":37.78},{"date":"2026-11-09","responses_answered":60,"responses_with_brand":19,"mention_count":19,"citation_count":8,"detection_rate":31.67,"visibility_score":33.17,"avg_position":2.2,"avg_sentiment":0.422,"top3_visibility":73.68,"win_rate":10,"share_of_voice":40.43},{"date":"2026-11-10","responses_answered":60,"responses_with_brand":15,"mention_count":15,"citation_count":5,"detection_rate":25,"visibility_score":25.83,"avg_position":2.6,"avg_sentiment":0.389,"top3_visibility":66.67,"win_rate":6.67,"share_of_voice":31.91}]},"competitors":[{"id":"a4d29e71-5c83-4b16-9f0e-6b3c8d17e254","brand_name":"Globex","is_your_brand":false,"domains":["globex.com"],"history_from":"2025-12-05","totals":{"responses_answered":180,"responses_with_brand":60,"mention_count":60,"citation_count":17,"detection_rate":33.33,"visibility_score":35.67,"avg_position":1.8,"avg_sentiment":0.376,"top3_visibility":85,"win_rate":15.56,"share_of_voice":43.17},"series":[{"date":"2026-11-08","responses_answered":60,"responses_with_brand":19,"mention_count":19,"citation_count":5,"detection_rate":31.67,"visibility_score":33.83,"avg_position":1.7,"avg_sentiment":0.376,"top3_visibility":84.21,"win_rate":15,"share_of_voice":42.22},{"date":"2026-11-09","responses_answered":60,"responses_with_brand":20,"mention_count":20,"citation_count":6,"detection_rate":33.33,"visibility_score":35.67,"avg_position":1.9,"avg_sentiment":0.381,"top3_visibility":85,"win_rate":15,"share_of_voice":42.55},{"date":"2026-11-10","responses_answered":60,"responses_with_brand":21,"mention_count":21,"citation_count":6,"detection_rate":35,"visibility_score":37.5,"avg_position":1.8,"avg_sentiment":0.372,"top3_visibility":85.71,"win_rate":16.67,"share_of_voice":44.68}]}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"4ac24408-a8d6-4faf-82a0-bd938b988a32":{"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"},"f758f513-fb20-44e0-8899-2136c1ec396f":{"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"},"d2762e47-eec8-49f8-9473-73e371c3a4f8":{"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"},"cdb40e1c-e05c-4e1b-ab5f-bd41771307d0":{"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"},"86bbe11e-f41c-4084-a141-5c9e24250c56":{"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"},"e9559d87-0527-4d73-ba70-41bb02ac0b72":{"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"},"a6756940-45b9-4282-ab67-cb7081b2a217":{"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":"Tracked competitors over time - Geoptie Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T11:13:15.129Z","originalFileLocation":"api-reference/competitors/tracked-competitors-over-time.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=\"Daily or weekly series for the brand and each tracked competitor: visibility, share of voice, mentions, position, sentiment, win rate and citations of their own website, over the brand\u0026#x27;s tracked prompts. Fast at any window length. A competitor tracked recently may have history_from null until its history is ready. Pass competitor_id for one competitor\u0026#x27;s trend (or a few). It only narrows which competitors are returned: share of voice is still computed over the whole tracked set, so the numbers match the unfiltered response. Narrow the prompts with topic_id or prompt_id, and add compare=true for the previous period and the change.\">\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=\"Tracked competitors over time - Geoptie Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Daily or weekly series for the brand and each tracked competitor: visibility, share of voice, mentions, position, sentiment, win rate and citations of their own website, over the brand\u0026#x27;s tracked prompts. Fast at any window length. A competitor tracked recently may have history_from null until its history is ready. Pass competitor_id for one competitor\u0026#x27;s trend (or a few). It only narrows which competitors are returned: share of voice is still computed over the whole tracked set, so the numbers match the unfiltered response. Narrow the prompts with topic_id or prompt_id, and add compare=true for the previous period and the change.\">\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/competitors/tracked-competitors-over-time\">\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=Competitors\u0026amp;title=Tracked+competitors+over+time\u0026amp;description=Daily+or+weekly+series+for+the+brand+and+each+tracked+competitor%3A+visibility%2C+share+of+voice%2C+mentions%2C+position%2C+sentiment%2C+win+rate+and+citations+of+their+own\u0026amp;theme=7601e87fdf07654df26d6c19\u0026amp;signature=5d9ba79bcaea05daf5aa4b4ef13f02c8a6f9b4cbc4cf0562c778a2f0ed592953\">\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=\"Tracked competitors over time - Geoptie Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Daily or weekly series for the brand and each tracked competitor: visibility, share of voice, mentions, position, sentiment, win rate and citations of their own website, over the brand\u0026#x27;s tracked prompts. Fast at any window length. A competitor tracked recently may have history_from null until its history is ready. Pass competitor_id for one competitor\u0026#x27;s trend (or a few). It only narrows which competitors are returned: share of voice is still computed over the whole tracked set, so the numbers match the unfiltered response. Narrow the prompts with topic_id or prompt_id, and add compare=true for the previous period and the change.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://geoptie.mintlify.site/docs/_mintlify/api/og/v2?division=Competitors\u0026amp;title=Tracked+competitors+over+time\u0026amp;description=Daily+or+weekly+series+for+the+brand+and+each+tracked+competitor%3A+visibility%2C+share+of+voice%2C+mentions%2C+position%2C+sentiment%2C+win+rate+and+citations+of+their+own\u0026amp;theme=7601e87fdf07654df26d6c19\u0026amp;signature=5d9ba79bcaea05daf5aa4b4ef13f02c8a6f9b4cbc4cf0562c778a2f0ed592953\">\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/competitors/tracked-competitors-over-time\">\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/competitors/tracked-competitors-over-time.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/competitors/tracked-competitors-over-time#webpage\",\"url\":\"https://geoptie.com/docs/api-reference/competitors/tracked-competitors-over-time\",\"name\":\"Tracked competitors over time\",\"description\":\"Daily or weekly series for the brand and each tracked competitor: visibility, share of voice, mentions, position, sentiment, win rate and citations of their own website, over the brand's tracked prompts. Fast at any window length. A competitor tracked recently may have history_from null until its history is ready. Pass competitor_id for one competitor's trend (or a few). It only narrows which competitors are returned: share of voice is still computed over the whole tracked set, so the numbers match the unfiltered response. Narrow the prompts with topic_id or prompt_id, and add compare=true for the previous period and the change.\",\"dateModified\":\"2026-11-12T11:13:15.129Z\",\"isPartOf\":{\"@id\":\"https://geoptie.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://geoptie.com/docs/api-reference/competitors/tracked-competitors-over-time#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://geoptie.com/docs/api-reference/competitors/tracked-competitors-over-time#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://geoptie.com/docs/api-reference/brands/list-brands\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Competitors\",\"item\":\"https://geoptie.com/docs/api-reference/competitors/your-brand-versus-its-competitors\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Tracked competitors over time\",\"item\":\"https://geoptie.com/docs/api-reference/competitors/tracked-competitors-over-time\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://geoptie.com/docs/api-reference/competitors/tracked-competitors-over-time#apireference\",\"headline\":\"Tracked competitors over time\",\"name\":\"Tracked competitors over time\",\"description\":\"Daily or weekly series for the brand and each tracked competitor: visibility, share of voice, mentions, position, sentiment, win rate and citations of their own website, over the brand's tracked prompts. Fast at any window length. A competitor tracked recently may have history_from null until its history is ready. Pass competitor_id for one competitor's trend (or a few). It only narrows which competitors are returned: share of voice is still computed over the whole tracked set, so the numbers match the unfiltered response. Narrow the prompts with topic_id or prompt_id, and add compare=true for the previous period and the change.\",\"url\":\"https://geoptie.com/docs/api-reference/competitors/tracked-competitors-over-time\",\"mainEntityOfPage\":{\"@id\":\"https://geoptie.com/docs/api-reference/competitors/tracked-competitors-over-time#webpage\"},\"dateModified\":\"2026-11-12T11:13:15.129Z\",\"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/competitors/tracked-competitors-over-time.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","description":"Which other brands appear alongside yours in the same answers, and your share of voice against them. Every row says whether it is in the brand's tracked set; pass `tracked=true` for just that set, which is the list share of voice is computed over, zero-mention competitors included.\n\nOn a large brand this is the slowest read. For tracked competitors, `/competitors/trends` (over time) and `/competitors/{competitorId}` (one competitor in detail) are much faster.","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","description":"A tracked competitor against your brand: totals for the window and for the window of the same length before it, plus one breakdown by engine, topic or prompt. The same numbers as the competitor view in the dashboard.","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","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":"Tracked competitors over time - Geoptie Docs","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","CodeSnippet-CTZvgJfu.js","getApiPlaygroundDisplay-BK2o1XYu.js","Page--B9YZ09u.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js","Markdown-CH4mv0N8.js","AssistantPageLink-BHjmqccN.js","dist-DYCPzQwJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}