Returns the opportunities with the highest score. Use limit to set the number of rows. Use date_range to select the period (7g, 1a, 3a, 6a, 1y or custom with since and until). Use llm to limit the data to some AI assistants.
GET
/
v1
/
sites
/
{site_uuid}
/
opportunities
/
top
List top opportunities
curl --request GET \ --url https://perquery.ai/api/v1/sites/{site_uuid}/opportunities/top \ --header 'Authorization: <api-key>'
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Perquery","colors":{"primary":"#4a55e1","light":"#7c85ee","dark":"#3b46c4"},"logo":{"light":"https://mintcdn.com/perquery/lzicSskf0BZQrf9m/logo/light.png?fit=max\u0026auto=format\u0026n=lzicSskf0BZQrf9m\u0026q=85\u0026s=184d07b356b701815d28a40a2697da04","dark":"https://mintcdn.com/perquery/iQmOA9v8ReUuZQ8b/logo/dark.png?fit=max\u0026auto=format\u0026n=iQmOA9v8ReUuZQ8b\u0026q=85\u0026s=555f9a2d9a2b479cc0309641079b47ff","href":"https://perquery.ai"},"favicon":"https://mintcdn.com/perquery/lzicSskf0BZQrf9m/favicon.png?fit=max\u0026auto=format\u0026n=lzicSskf0BZQrf9m\u0026q=85\u0026s=85d76eb64923fdb8606bde0c03eec95e","api":{"playground":{"display":"simple"},"mdx":{"auth":{"method":"key","name":"Authorization"}}},"navbar":{"links":[{"href":"https://peaksense.com.tr/iletisim","label":"Support"}],"primary":{"type":"button","label":"Open Perquery","href":"https://perquery.ai"}},"footer":{"socials":{"website":"https://perquery.ai"}},"seo":{"metatags":{"canonical":"https://docs.perquery.ai"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":"en/introduction"},{"language":"tr","href":"tr/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"perquery","hasAudioNarration":false,"actualSubdomain":"perquery","customDomains":["docs.perquery.ai"],"gitSource":{"type":"github","owner":"the-geo-tool","repo":"perquery-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6aeb622a199e565ca90e6dc2"},"chroma":{"latestBuiltDeploymentHistoryId":"6aeb6e86f6249e50191c5ac7","collectionId":"cde04cdc-1315-4b11-b912-36bea904f1a0","liveDeploymentHistoryId":"6aeb6e86f6249e50191c5ac7","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeb7ed44c72931646ce3d77","clientVersion":"0.0.4064","searchFilterCounts":[{"language":"default","tag":"API reference","count":49},{"language":"default","tag":"Endpoints","count":49},{"language":"en","tag":"Guides","count":39},{"language":"tr","tag":"Kılavuzlar","count":39},{"language":"en","tag":"Monitor","count":8},{"language":"tr","tag":"İzleme","count":8},{"language":"default","tag":"Technical analysis","count":8},{"language":"en","tag":"Tools","count":7},{"language":"tr","tag":"Araçlar","count":7},{"language":"en","tag":"Account and team","count":6},{"language":"tr","tag":"Hesap ve ekip","count":6},{"language":"default","tag":"Content analysis","count":6},{"language":"default","tag":"Visibility","count":6},{"language":"en","tag":"Get started","count":5},{"language":"tr","tag":"Başlangıç","count":5},{"language":"en","tag":"AI assistants","count":4},{"language":"en","tag":"Analyze","count":4},{"language":"en","tag":"Integrations","count":4},{"language":"tr","tag":"AI asistanları","count":4},{"language":"tr","tag":"Analiz","count":4},{"language":"tr","tag":"Entegrasyonlar","count":4},{"language":"default","tag":"Authority","count":4},{"language":"default","tag":"Prompts","count":4},{"language":"en","tag":"API reference","count":3},{"language":"en","tag":"API","count":3},{"language":"tr","tag":"API referansı","count":3},{"language":"tr","tag":"API","count":3},{"language":"default","tag":"Bot logs","count":3},{"language":"default","tag":"Competitors","count":3},{"language":"default","tag":"Integrations","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"vite-origin","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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/opportunities/list-top-opportunities","slug":"/api-reference/opportunities/list-top-opportunities","pageMetadata":{"title":"List top opportunities","description":"Returns the opportunities with the highest score. Use `limit` to set the number of rows. Use `date_range` to select the period (`7g`, `1a`, `3a`, `6a`, `1y` or `custom` with `since` and `until`). Use `llm` to limit the data to some AI assistants.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/opportunities/top","href":"/api-reference/opportunities/list-top-opportunities","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {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(_components.p, {\n children: [\"Returns the opportunities with the highest score. Use \", _jsx(_components.code, {\n children: \"limit\"\n }), \" to set the number of rows. Use \", _jsx(_components.code, {\n children: \"date_range\"\n }), \" to select the period (\", _jsx(_components.code, {\n children: \"7g\"\n }), \", \", _jsx(_components.code, {\n children: \"1a\"\n }), \", \", _jsx(_components.code, {\n children: \"3a\"\n }), \", \", _jsx(_components.code, {\n children: \"6a\"\n }), \", \", _jsx(_components.code, {\n children: \"1y\"\n }), \" or \", _jsx(_components.code, {\n children: \"custom\"\n }), \" with \", _jsx(_components.code, {\n children: \"since\"\n }), \" and \", _jsx(_components.code, {\n children: \"until\"\n }), \"). Use \", _jsx(_components.code, {\n children: \"llm\"\n }), \" to limit the data to some AI assistants.\"]\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":"List top opportunities","description":"Returns the opportunities with the highest score. Use `limit` to set the number of rows. Use `date_range` to select the period (`7g`, `1a`, `3a`, `6a`, `1y` or `custom` with `since` and `until`). Use `llm` to limit the data to some AI assistants.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/opportunities/top","href":"/api-reference/opportunities/list-top-opportunities","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"top_opportunities","parameters":["25dbdb73-9130-4b41-819f-0428da3131fc","989787e6-bd8e-4c8c-b711-f15d16254754","97ae9737-5c48-45fe-bd39-0b75928b2961","4c0e2dbb-bd41-4b16-8b47-9aceeaf0554e","0bfd98f4-1fda-4a36-a674-a6d1f25f9d02","17ed95f3-7395-4a39-bf01-7325fb45dff3"],"tags":["Opportunities"],"responses":{"200":"65df18a2-d74f-4c34-9346-de09e4d8fe70"},"summary":"List top opportunities","description":"Returns the opportunities with the highest score. Use `limit` to set the number of rows. Use `date_range` to select the period (`7g`, `1a`, `3a`, `6a`, `1y` or `custom` with `since` and `until`). Use `llm` to limit the data to some AI assistants.","security":["73800163-4cf2-4049-a891-dfa6c132c760"],"method":"get","type":"path","servers":["f697ccb9-abcf-4aae-ad6c-eea6db36cf76"],"path":"/v1/sites/{site_uuid}/opportunities/top","baseUrlOptions":["https://perquery.ai/api"],"title":"List top opportunities","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"25dbdb73-9130-4b41-819f-0428da3131fc":{"in":"query","name":"date_range","schema":{"enum":["7g","1a","3a","6a","1y","custom"],"type":"string","default":"1a","minLength":1,"description":"* `7g` - 7g\n* `1a` - 1a\n* `3a` - 3a\n* `6a` - 6a\n* `1y` - 1y\n* `custom` - custom","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"* `7g` - 7g\n* `1a` - 1a\n* `3a` - 3a\n* `6a` - 6a\n* `1y` - 1y\n* `custom` - custom"},"989787e6-bd8e-4c8c-b711-f15d16254754":{"in":"query","name":"limit","schema":{"type":"integer","maximum":20,"minimum":1,"default":4,"uniqueKey":"","typeLabel":"integer"}},"97ae9737-5c48-45fe-bd39-0b75928b2961":{"in":"query","name":"llm","schema":{"type":"array","items":{"enum":["chatgpt","gemini","claude","perplexity","googleai","grok","deepseek"],"type":"string","description":"* `chatgpt` - chatgpt\n* `gemini` - gemini\n* `claude` - claude\n* `perplexity` - perplexity\n* `googleai` - googleai\n* `grok` - grok\n* `deepseek` - deepseek","uniqueKey":"items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"","typeLabel":"enum\u003cstring>[]"}},"4c0e2dbb-bd41-4b16-8b47-9aceeaf0554e":{"in":"query","name":"since","schema":{"type":"string","format":"date","description":"The first day of a `custom` range.","uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"The first day of a `custom` range."},"0bfd98f4-1fda-4a36-a674-a6d1f25f9d02":{"in":"path","name":"site_uuid","schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"},"required":true},"17ed95f3-7395-4a39-bf01-7325fb45dff3":{"in":"query","name":"until","schema":{"type":"string","format":"date","description":"The last day of a `custom` range.","uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"The last day of a `custom` range."}},"responses":{"65df18a2-d74f-4c34-9346-de09e4d8fe70":{"content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","properties":{"identity":{"type":"string","isRequired":true,"uniqueKey":"rows.items.[INDEX].identity","typeLabel":"string"},"type":{"enum":["technical","content","offpage"],"type":"string","description":"* `technical` - technical\n* `content` - content\n* `offpage` - offpage","isRequired":true,"uniqueKey":"rows.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"subject_kind":{"enum":["site","page","prompt","domain"],"type":"string","description":"* `site` - site\n* `page` - page\n* `prompt` - prompt\n* `domain` - domain","isRequired":true,"uniqueKey":"rows.items.[INDEX].subject_kind","typeLabel":"enum\u003cstring>"},"subject_ref":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"rows.items.[INDEX].subject_ref.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"rows.items.[INDEX].subject_ref.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"rows.items.[INDEX].subject_ref","typeLabel":"string | null"},"subject_label":{"type":"string","isRequired":true,"uniqueKey":"rows.items.[INDEX].subject_label","typeLabel":"string"},"score":{"type":"integer","isRequired":true,"uniqueKey":"rows.items.[INDEX].score","typeLabel":"integer"},"effort":{"type":"integer","isRequired":true,"uniqueKey":"rows.items.[INDEX].effort","typeLabel":"integer"},"effort_band":{"enum":["high","medium","low"],"type":"string","description":"* `high` - high\n* `medium` - medium\n* `low` - low","isRequired":true,"uniqueKey":"rows.items.[INDEX].effort_band","typeLabel":"enum\u003cstring>"},"tier":{"enum":["now","plan","quick","watch"],"type":"string","description":"* `now` - now\n* `plan` - plan\n* `quick` - quick\n* `watch` - watch","isRequired":true,"uniqueKey":"rows.items.[INDEX].tier","typeLabel":"enum\u003cstring>"},"volume":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"rows.items.[INDEX].volume.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"rows.items.[INDEX].volume.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"rows.items.[INDEX].volume","typeLabel":"integer | null"},"demand_known":{"type":"boolean","isRequired":true,"uniqueKey":"rows.items.[INDEX].demand_known","typeLabel":"boolean"},"persona":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"rows.items.[INDEX].persona.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"rows.items.[INDEX].persona.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"rows.items.[INDEX].persona","typeLabel":"string | null"},"page":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"rows.items.[INDEX].page.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"rows.items.[INDEX].page.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"rows.items.[INDEX].page","typeLabel":"string | null"},"acted_on_at":{"oneOf":[{"type":"string","format":"date","isRequired":true,"uniqueKey":"rows.items.[INDEX].acted_on_at.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","isRequired":true,"uniqueKey":"rows.items.[INDEX].acted_on_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"rows.items.[INDEX].acted_on_at","typeLabel":"string\u003cdate> | null"},"dismissed":{"type":"boolean","isRequired":true,"uniqueKey":"rows.items.[INDEX].dismissed","typeLabel":"boolean"},"reasons":{"type":"array","items":{"type":"object","properties":{"code":{"enum":["brand_absent","competitor_leads","no_page_serves","weak_match","bot_blocked","missing_structured_data","missing_llms_txt","renders_client_side","broken_pages","missing_sitemap","orphan_pages","thin_metadata","cited_competitor_not_brand","no_backlink_from_source","target_page_broken"],"type":"string","description":"* `brand_absent` - brand_absent\n* `competitor_leads` - competitor_leads\n* `no_page_serves` - no_page_serves\n* `weak_match` - weak_match\n* `bot_blocked` - bot_blocked\n* `missing_structured_data` - missing_structured_data\n* `missing_llms_txt` - missing_llms_txt\n* `renders_client_side` - renders_client_side\n* `broken_pages` - broken_pages\n* `missing_sitemap` - missing_sitemap\n* `orphan_pages` - orphan_pages\n* `thin_metadata` - thin_metadata\n* `cited_competitor_not_brand` - cited_competitor_not_brand\n* `no_backlink_from_source` - no_backlink_from_source\n* `target_page_broken` - target_page_broken","isRequired":true,"uniqueKey":"rows.items.[INDEX].reasons.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"identity":{"type":"string","isRequired":true,"uniqueKey":"rows.items.[INDEX].reasons.items.[INDEX].identity","typeLabel":"string"},"facts":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"rows.items.[INDEX].reasons.items.[INDEX].facts.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"rows.items.[INDEX].reasons.items.[INDEX].facts","typeLabel":"object"},"suggested_tool":{"oneOf":[{"type":"string","description":"* `content_brief` - content_brief\n* `content_draft` - content_draft\n* `schema` - schema\n* `robots` - robots\n* `llms_txt` - llms_txt\n* `inspect` - inspect\n* `meta_tags` - meta_tags","enum":["content_brief","content_draft","schema","robots","llms_txt","inspect","meta_tags"],"isRequired":true,"uniqueKey":"rows.items.[INDEX].reasons.items.[INDEX].suggested_tool.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"rows.items.[INDEX].reasons.items.[INDEX].suggested_tool.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"rows.items.[INDEX].reasons.items.[INDEX].suggested_tool","typeLabel":"enum\u003cstring> | null"},"acted_on_at":{"oneOf":[{"type":"string","format":"date","uniqueKey":"rows.items.[INDEX].reasons.items.[INDEX].acted_on_at.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","uniqueKey":"rows.items.[INDEX].reasons.items.[INDEX].acted_on_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"rows.items.[INDEX].reasons.items.[INDEX].acted_on_at","typeLabel":"string\u003cdate> | null"}},"required":["code","facts","identity","suggested_tool"],"uniqueKey":"rows.items.[INDEX].reasons.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"rows.items.[INDEX].reasons","typeLabel":"object[]"},"suggested_tool":{"oneOf":[{"type":"string","description":"* `content_brief` - content_brief\n* `content_draft` - content_draft\n* `schema` - schema\n* `robots` - robots\n* `llms_txt` - llms_txt\n* `inspect` - inspect\n* `meta_tags` - meta_tags","enum":["content_brief","content_draft","schema","robots","llms_txt","inspect","meta_tags"],"isRequired":true,"uniqueKey":"rows.items.[INDEX].suggested_tool.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"rows.items.[INDEX].suggested_tool.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"rows.items.[INDEX].suggested_tool","typeLabel":"enum\u003cstring> | null"}},"required":["acted_on_at","demand_known","dismissed","effort","effort_band","identity","page","persona","reasons","score","subject_kind","subject_label","subject_ref","suggested_tool","tier","type","volume"],"uniqueKey":"rows.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"rows","typeLabel":"object[]"}},"required":["rows"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"rows":[{"identity":"\u003cstring>","type":"technical","subject_kind":"site","subject_ref":"\u003cstring>","subject_label":"\u003cstring>","score":123,"effort":123,"effort_band":"high","tier":"now","volume":123,"demand_known":true,"persona":"\u003cstring>","page":"\u003cstring>","acted_on_at":"2023-12-25","dismissed":true,"reasons":[{"code":"brand_absent","identity":"\u003cstring>","facts":{},"suggested_tool":"content_brief","acted_on_at":"2023-12-25"}],"suggested_tool":"content_brief"}]}}},"exampleType":"generated"}},"description":"","exampleType":"generated"}},"security":{"73800163-4cf2-4049-a891-dfa6c132c760":{"apiKey":{"type":"apiKey","in":"header","name":"Authorization","description":"`ApiKey pq_\u003cprefix>_\u003csecret>`. An API key gives read-only access.","scopes":[],"schemeName":"apiKey"}}},"servers":{"f697ccb9-abcf-4aae-ad6c-eea6db36cf76":{"url":"https://perquery.ai/api"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"`ApiKey pq_\u003cprefix>_\u003csecret>`. An API key gives read-only access.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Authorization","type":"string","description":"`ApiKey pq_\u003cprefix>_\u003csecret>`. An API key gives read-only access.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"perquery","siteName":"Perquery","title":"List top opportunities - Perquery","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/opportunities/list-top-opportunities","matchLevel":0},"tr":{"href":"/api-reference/opportunities/list-top-opportunities","matchLevel":0}}},"lastModified":"2026-11-04T17:42:55.961Z","originalFileLocation":"api-reference/opportunities/list-top-opportunities.mdx","locale":"en"},"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=\"Returns the opportunities with the highest score. Use limit to set the number of rows. Use date_range to select the period (7g, 1a, 3a, 6a, 1y or custom with since and until). Use llm to limit the data to some AI assistants.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Perquery\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/perquery/zT_jyd4ccjnsQVsw/_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=\"/mintlify-assets/_mintlify/favicons/perquery/zT_jyd4ccjnsQVsw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/perquery/zT_jyd4ccjnsQVsw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/perquery/zT_jyd4ccjnsQVsw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/perquery/zT_jyd4ccjnsQVsw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/perquery/zT_jyd4ccjnsQVsw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/perquery/zT_jyd4ccjnsQVsw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/perquery/zT_jyd4ccjnsQVsw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/perquery/zT_jyd4ccjnsQVsw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List top opportunities - Perquery\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the opportunities with the highest score. Use limit to set the number of rows. Use date_range to select the period (7g, 1a, 3a, 6a, 1y or custom with since and until). Use llm to limit the data to some AI assistants.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Perquery\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.perquery.ai/api-reference/opportunities/list-top-opportunities\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://perquery.mintlify.app/_mintlify/api/og/v2?division=Opportunities\u0026amp;title=List+top+opportunities\u0026amp;description=Returns+the+opportunities+with+the+highest+score.+Use+%60limit%60+to+set+the+number+of+rows.+Use+%60date_range%60+to+select+the+period+%28%607g%60%2C+%601a%60%2C+%603a%60%2C+%606a%60%2C+%601y%60+or+\u0026amp;theme=1d23d881d32e1681caf25c0d\u0026amp;signature=2ab57e11c5abc2353a9e0f1d35a9899c9dbcf332c3fd74e3cae46fad55a648fe\">\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=\"List top opportunities - Perquery\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the opportunities with the highest score. Use limit to set the number of rows. Use date_range to select the period (7g, 1a, 3a, 6a, 1y or custom with since and until). Use llm to limit the data to some AI assistants.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://perquery.mintlify.app/_mintlify/api/og/v2?division=Opportunities\u0026amp;title=List+top+opportunities\u0026amp;description=Returns+the+opportunities+with+the+highest+score.+Use+%60limit%60+to+set+the+number+of+rows.+Use+%60date_range%60+to+select+the+period+%28%607g%60%2C+%601a%60%2C+%603a%60%2C+%606a%60%2C+%601y%60+or+\u0026amp;theme=1d23d881d32e1681caf25c0d\u0026amp;signature=2ab57e11c5abc2353a9e0f1d35a9899c9dbcf332c3fd74e3cae46fad55a648fe\">\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=\"/mintlify-assets/_mintlify/favicons/perquery/zT_jyd4ccjnsQVsw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Perquery\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4a55e1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.perquery.ai/api-reference/opportunities/list-top-opportunities\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/opportunities/list-top-opportunities.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.perquery.ai/#organization\",\"name\":\"Perquery\",\"url\":\"https://docs.perquery.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/perquery/lzicSskf0BZQrf9m/logo/light.png?fit=max\u0026auto=format\u0026n=lzicSskf0BZQrf9m\u0026q=85\u0026s=184d07b356b701815d28a40a2697da04\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.perquery.ai#website\",\"name\":\"Perquery\",\"url\":\"https://docs.perquery.ai\",\"publisher\":{\"@id\":\"https://docs.perquery.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.perquery.ai/api-reference/opportunities/list-top-opportunities#webpage\",\"url\":\"https://docs.perquery.ai/api-reference/opportunities/list-top-opportunities\",\"name\":\"List top opportunities\",\"description\":\"Returns the opportunities with the highest score. Use limit to set the number of rows. Use date_range to select the period (7g, 1a, 3a, 6a, 1y or custom with since and until). Use llm to limit the data to some AI assistants.\",\"dateModified\":\"2026-11-04T17:42:55.961Z\",\"isPartOf\":{\"@id\":\"https://docs.perquery.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.perquery.ai/api-reference/opportunities/list-top-opportunities#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.perquery.ai/api-reference/opportunities/list-top-opportunities#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.perquery.ai/api-reference/sites/list-sites\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Opportunities\",\"item\":\"https://docs.perquery.ai/api-reference/opportunities/list-opportunities\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List top opportunities\",\"item\":\"https://docs.perquery.ai/api-reference/opportunities/list-top-opportunities\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.perquery.ai/api-reference/opportunities/list-top-opportunities#apireference\",\"headline\":\"List top opportunities\",\"name\":\"List top opportunities\",\"description\":\"Returns the opportunities with the highest score. Use limit to set the number of rows. Use date_range to select the period (7g, 1a, 3a, 6a, 1y or custom with since and until). Use llm to limit the data to some AI assistants.\",\"url\":\"https://docs.perquery.ai/api-reference/opportunities/list-top-opportunities\",\"mainEntityOfPage\":{\"@id\":\"https://docs.perquery.ai/api-reference/opportunities/list-top-opportunities#webpage\"},\"dateModified\":\"2026-11-04T17:42:55.961Z\",\"publisher\":{\"@id\":\"https://docs.perquery.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.perquery.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Perquery\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Perquery","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/en/introduction"}]},{"tab":"AI assistants","pages":[{"title":"AI assistants","href":"/en/ai/mcp"}]},{"tab":"API reference","groups":[{"group":"API","pages":[{"title":"API introduction","href":"/en/api/introduction"},{"title":"Authentication","href":"/en/api/authentication"},{"title":"Errors and limits","href":"/en/api/errors-and-limits"}]},{"group":"Endpoints","pages":[{"group":"Sites","pages":[{"title":"List sites","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites","href":"/api-reference/sites/list-sites"},{"title":"Get a site","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}","href":"/api-reference/sites/get-a-site"}]},{"group":"Authority","pages":[{"title":"Get the authority summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/authority","href":"/api-reference/authority/get-the-authority-summary"},{"title":"List backlink gaps","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/authority/backlink-gaps","href":"/api-reference/authority/list-backlink-gaps"},{"title":"List citation gaps","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/authority/gaps","href":"/api-reference/authority/list-citation-gaps"},{"title":"List citation sources","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/authority/sources","href":"/api-reference/authority/list-citation-sources"}]},{"group":"Bot logs","pages":[{"title":"Get the bot log report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/bot-logs","href":"/api-reference/bot-logs/get-the-bot-log-report"},{"title":"List bot log pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/bot-logs/pages","href":"/api-reference/bot-logs/list-bot-log-pages"},{"title":"List log uploads","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/bot-logs/uploads","href":"/api-reference/bot-logs/list-log-uploads"}]},{"group":"Competitors","pages":[{"title":"List competitors","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/competitors","href":"/api-reference/competitors/list-competitors"},{"title":"Get the competitor analysis","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/competitors/analysis","href":"/api-reference/competitors/get-the-competitor-analysis"},{"title":"List competitor domain ratings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/competitors/domain-ratings","href":"/api-reference/competitors/list-competitor-domain-ratings"}]},{"group":"Content analysis","pages":[{"title":"Get the latest crawl","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/content/crawls","href":"/api-reference/content-analysis/get-the-latest-crawl"},{"title":"Get the format distribution","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/content/format-distribution","href":"/api-reference/content-analysis/get-the-format-distribution"},{"title":"List prompt matches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/content/matches","href":"/api-reference/content-analysis/list-prompt-matches"},{"title":"List page readiness","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/content/page-readiness","href":"/api-reference/content-analysis/list-page-readiness"},{"title":"List crawled pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/content/pages","href":"/api-reference/content-analysis/list-crawled-pages"},{"title":"Get the content summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/content/summary","href":"/api-reference/content-analysis/get-the-content-summary"}]},{"group":"Impact","pages":[{"title":"List impact results","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/impact","href":"/api-reference/impact/list-impact-results"}]},{"group":"Integrations","pages":[{"title":"List integrations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/integrations","href":"/api-reference/integrations/list-integrations"},{"title":"List integration properties","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/integrations/{provider}/properties","href":"/api-reference/integrations/list-integration-properties"},{"title":"List sync history","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/integrations/{provider}/syncs","href":"/api-reference/integrations/list-sync-history"}]},{"group":"Opportunities","pages":[{"title":"List opportunities","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/opportunities","href":"/api-reference/opportunities/list-opportunities"},{"title":"Get the opportunity matrix","description":"Returns the top opportunities for the priority matrix and the count of opportunities that the matrix does not show. Use `date_range` to select the period (`7g`, `1a`, `3a`, `6a`, `1y` or `custom` with `since` and `until`). Use `llm` to limit the data to some AI assistants.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/opportunities/matrix","href":"/api-reference/opportunities/get-the-opportunity-matrix"},{"title":"List top opportunities","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/opportunities/top","href":"/api-reference/opportunities/list-top-opportunities"}]},{"group":"Visibility","pages":[{"title":"Get the site overview","description":"Returns the main visibility metrics of the site: visibility, share of voice, rank, sentiment and authority, with a trend and the result of each AI assistant. Use `date_range` to select the period (`7g`, `1a`, `3a`, `6a`, `1y` or `custom` with `since` and `until`). Use `compare` to select the comparison period (`previous`, `previous_year` or `custom` with `compare_since` and `compare_until`). Use `persona` and `llm` to limit the data to one persona and to some AI assistants.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/overview","href":"/api-reference/visibility/get-the-site-overview"},{"title":"Get the metrics version","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/visibility/metrics-version","href":"/api-reference/visibility/get-the-metrics-version"},{"title":"List runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/visibility/runs","href":"/api-reference/visibility/list-runs"},{"title":"Estimate a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/visibility/runs/estimate","href":"/api-reference/visibility/estimate-a-run"},{"title":"Get a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/visibility/runs/{run_uuid}","href":"/api-reference/visibility/get-a-run"},{"title":"List run answers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/visibility/runs/{run_uuid}/answers","href":"/api-reference/visibility/list-run-answers"}]},{"group":"Personas","pages":[{"title":"List personas","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/personas","href":"/api-reference/personas/list-personas"},{"title":"Get the persona board","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/personas/board","href":"/api-reference/personas/get-the-persona-board"},{"title":"List persona signals","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/personas/signals","href":"/api-reference/personas/list-persona-signals"}]},{"group":"Prompts","pages":[{"title":"Get prompt group performance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/prompt-groups/performance","href":"/api-reference/prompts/get-prompt-group-performance"},{"title":"List prompts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/prompts","href":"/api-reference/prompts/list-prompts"},{"title":"Get a prompt","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/prompts/{prompt_uuid}","href":"/api-reference/prompts/get-a-prompt"},{"title":"List prompt groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/tracking-groups","href":"/api-reference/prompts/list-prompt-groups"}]},{"group":"Search performance","pages":[{"title":"List ad terms","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/search-performance/ad-terms","href":"/api-reference/search-performance/list-ad-terms"},{"title":"List search queries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/search-performance/queries","href":"/api-reference/search-performance/list-search-queries"},{"title":"Get the referral report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/search-performance/referrals","href":"/api-reference/search-performance/get-the-referral-report"}]},{"group":"Technical analysis","pages":[{"title":"Get the latest audit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/audit","href":"/api-reference/technical-analysis/get-the-latest-audit"},{"title":"List bot access","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/bot-access","href":"/api-reference/technical-analysis/list-bot-access"},{"title":"Get the crawl budget","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/crawl-budget","href":"/api-reference/technical-analysis/get-the-crawl-budget"},{"title":"List audit findings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/findings","href":"/api-reference/technical-analysis/list-audit-findings"},{"title":"Get the score history","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/history","href":"/api-reference/technical-analysis/get-the-score-history"},{"title":"List page inspections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/inspections","href":"/api-reference/technical-analysis/list-page-inspections"},{"title":"Get a page inspection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/inspections/{inspection_uuid}","href":"/api-reference/technical-analysis/get-a-page-inspection"},{"title":"Get an inspection screenshot","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/inspections/{inspection_uuid}/screenshot","href":"/api-reference/technical-analysis/get-an-inspection-screenshot"}]}]}]}]},{"language":"tr","tabs":[{"tab":"Kılavuzlar","pages":[{"title":"Kılavuzlar","href":"/tr/introduction"}]},{"tab":"AI asistanları","pages":[{"title":"AI asistanları","href":"/tr/ai/mcp"}]},{"tab":"API referansı","groups":[{"group":"API","pages":[{"title":"API'ye giriş","href":"/tr/api/introduction"},{"title":"Kimlik doğrulama","href":"/tr/api/authentication"},{"title":"Hatalar ve limitler","href":"/tr/api/errors-and-limits"}]},{"group":"Endpoints","pages":[{"group":"Sites","pages":[{"title":"List sites","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites","href":"/api-reference/sites/list-sites"},{"title":"Get a site","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}","href":"/api-reference/sites/get-a-site"}]},{"group":"Authority","pages":[{"title":"Get the authority summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/authority","href":"/api-reference/authority/get-the-authority-summary"},{"title":"List backlink gaps","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/authority/backlink-gaps","href":"/api-reference/authority/list-backlink-gaps"},{"title":"List citation gaps","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/authority/gaps","href":"/api-reference/authority/list-citation-gaps"},{"title":"List citation sources","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/authority/sources","href":"/api-reference/authority/list-citation-sources"}]},{"group":"Bot logs","pages":[{"title":"Get the bot log report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/bot-logs","href":"/api-reference/bot-logs/get-the-bot-log-report"},{"title":"List bot log pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/bot-logs/pages","href":"/api-reference/bot-logs/list-bot-log-pages"},{"title":"List log uploads","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/bot-logs/uploads","href":"/api-reference/bot-logs/list-log-uploads"}]},{"group":"Competitors","pages":[{"title":"List competitors","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/competitors","href":"/api-reference/competitors/list-competitors"},{"title":"Get the competitor analysis","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/competitors/analysis","href":"/api-reference/competitors/get-the-competitor-analysis"},{"title":"List competitor domain ratings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/competitors/domain-ratings","href":"/api-reference/competitors/list-competitor-domain-ratings"}]},{"group":"Content analysis","pages":[{"title":"Get the latest crawl","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/content/crawls","href":"/api-reference/content-analysis/get-the-latest-crawl"},{"title":"Get the format distribution","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/content/format-distribution","href":"/api-reference/content-analysis/get-the-format-distribution"},{"title":"List prompt matches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/content/matches","href":"/api-reference/content-analysis/list-prompt-matches"},{"title":"List page readiness","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/content/page-readiness","href":"/api-reference/content-analysis/list-page-readiness"},{"title":"List crawled pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/content/pages","href":"/api-reference/content-analysis/list-crawled-pages"},{"title":"Get the content summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/content/summary","href":"/api-reference/content-analysis/get-the-content-summary"}]},{"group":"Impact","pages":[{"title":"List impact results","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/impact","href":"/api-reference/impact/list-impact-results"}]},{"group":"Integrations","pages":[{"title":"List integrations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/integrations","href":"/api-reference/integrations/list-integrations"},{"title":"List integration properties","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/integrations/{provider}/properties","href":"/api-reference/integrations/list-integration-properties"},{"title":"List sync history","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/integrations/{provider}/syncs","href":"/api-reference/integrations/list-sync-history"}]},{"group":"Opportunities","pages":[{"title":"List opportunities","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/opportunities","href":"/api-reference/opportunities/list-opportunities"},{"title":"Get the opportunity matrix","description":"Returns the top opportunities for the priority matrix and the count of opportunities that the matrix does not show. Use `date_range` to select the period (`7g`, `1a`, `3a`, `6a`, `1y` or `custom` with `since` and `until`). Use `llm` to limit the data to some AI assistants.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/opportunities/matrix","href":"/api-reference/opportunities/get-the-opportunity-matrix"},{"title":"List top opportunities","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/opportunities/top","href":"/api-reference/opportunities/list-top-opportunities"}]},{"group":"Visibility","pages":[{"title":"Get the site overview","description":"Returns the main visibility metrics of the site: visibility, share of voice, rank, sentiment and authority, with a trend and the result of each AI assistant. Use `date_range` to select the period (`7g`, `1a`, `3a`, `6a`, `1y` or `custom` with `since` and `until`). Use `compare` to select the comparison period (`previous`, `previous_year` or `custom` with `compare_since` and `compare_until`). Use `persona` and `llm` to limit the data to one persona and to some AI assistants.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/overview","href":"/api-reference/visibility/get-the-site-overview"},{"title":"Get the metrics version","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/visibility/metrics-version","href":"/api-reference/visibility/get-the-metrics-version"},{"title":"List runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/visibility/runs","href":"/api-reference/visibility/list-runs"},{"title":"Estimate a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/visibility/runs/estimate","href":"/api-reference/visibility/estimate-a-run"},{"title":"Get a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/visibility/runs/{run_uuid}","href":"/api-reference/visibility/get-a-run"},{"title":"List run answers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/visibility/runs/{run_uuid}/answers","href":"/api-reference/visibility/list-run-answers"}]},{"group":"Personas","pages":[{"title":"List personas","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/personas","href":"/api-reference/personas/list-personas"},{"title":"Get the persona board","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/personas/board","href":"/api-reference/personas/get-the-persona-board"},{"title":"List persona signals","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/personas/signals","href":"/api-reference/personas/list-persona-signals"}]},{"group":"Prompts","pages":[{"title":"Get prompt group performance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/prompt-groups/performance","href":"/api-reference/prompts/get-prompt-group-performance"},{"title":"List prompts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/prompts","href":"/api-reference/prompts/list-prompts"},{"title":"Get a prompt","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/prompts/{prompt_uuid}","href":"/api-reference/prompts/get-a-prompt"},{"title":"List prompt groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/tracking-groups","href":"/api-reference/prompts/list-prompt-groups"}]},{"group":"Search performance","pages":[{"title":"List ad terms","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/search-performance/ad-terms","href":"/api-reference/search-performance/list-ad-terms"},{"title":"List search queries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/search-performance/queries","href":"/api-reference/search-performance/list-search-queries"},{"title":"Get the referral report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/search-performance/referrals","href":"/api-reference/search-performance/get-the-referral-report"}]},{"group":"Technical analysis","pages":[{"title":"Get the latest audit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/audit","href":"/api-reference/technical-analysis/get-the-latest-audit"},{"title":"List bot access","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/bot-access","href":"/api-reference/technical-analysis/list-bot-access"},{"title":"Get the crawl budget","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/crawl-budget","href":"/api-reference/technical-analysis/get-the-crawl-budget"},{"title":"List audit findings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/findings","href":"/api-reference/technical-analysis/list-audit-findings"},{"title":"Get the score history","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/history","href":"/api-reference/technical-analysis/get-the-score-history"},{"title":"List page inspections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/inspections","href":"/api-reference/technical-analysis/list-page-inspections"},{"title":"Get a page inspection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/inspections/{inspection_uuid}","href":"/api-reference/technical-analysis/get-a-page-inspection"},{"title":"Get an inspection screenshot","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sites/{site_uuid}/technical/inspections/{inspection_uuid}/screenshot","href":"/api-reference/technical-analysis/get-an-inspection-screenshot"}]}]}]}]}]},"basePath":"","title":"List top opportunities - Perquery","buildId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","deploymentId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-hfTk6MZX.js","utils-Bfp7HcY4.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D8dSW7yV.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CFgQXcZO.js","snippetPresets-dMW1-pV3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-DyrCOido.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Bwwdcyh3.js","shallow-drVXTg79.js","getApiPlaygroundDisplay-GMPxUzWV.js","CodeSnippet-wTmV0wP6.js","CodeSnippets-D_QxCJEq.js","Page-BsZAA8xk.js","getPastedJson-Dev-X0Xy.js","icon-7L2WL0jD.js","MethodPill-Ble59Dl_.js","DuplicateIcon-r-98uLGh.js","createIcon-DaFzipjW.js","DynamicMarkdown-Jk8YAWGN.js","SectionHeading-nLgrCDOg.js","axios-vUo_bRtp.js","Markdown-_QGow1Wo.js","clsx-v8ssfMzu.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CjboTi0T.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DkAyo-p5.js"]}