{
"error": "Usage limit reached for keyword_research"
}
Keywords
Trigger keyword research
Generates keyword ideas using AI plus DataForSEO enrichment.
This is a long-running job. By default the endpoint returns a job handle immediately (202 Accepted) — poll GET /keywords/research/{jobId} with the returned job_id until status is completed. Pass "sync": true to wait inline, but this is not recommended as it is subject to gateway timeouts.
Pass your Keupera API key as a Bearer token: Authorization: Bearer YOUR_KEUPERA_API_KEY. Generate keys from Account → API Keys in your Keupera dashboard.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Keupera Docs","colors":{"primary":"#0062fb","light":"#3d8bff","dark":"#004bbd"},"logo":{"light":"https://mintcdn.com/keupera/lZpWL3J0-hZm9sgA/logo/light.svg?fit=max\u0026auto=format\u0026n=lZpWL3J0-hZm9sgA\u0026q=85\u0026s=a82c2b1d1cddd65db77cfd68e9056e52","dark":"https://mintcdn.com/keupera/lZpWL3J0-hZm9sgA/logo/dark.svg?fit=max\u0026auto=format\u0026n=lZpWL3J0-hZm9sgA\u0026q=85\u0026s=44bf8c941a4ab6c90b1ba1e8663be93f"},"favicon":"https://mintcdn.com/keupera/ZC_w7ZrvFEjsiseA/favicon.svg?fit=max\u0026auto=format\u0026n=ZC_w7ZrvFEjsiseA\u0026q=85\u0026s=164b4c375a4e1185cac1ad54a641e9fd","navbar":{"links":[{"href":"mailto:ask@support.keupera.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.keupera.com"}},"footer":{"socials":{"x":"https://x.com/keuperacom","linkedin":"https://linkedin.com/company/keupera"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://app.keupera.com"},{"anchor":"Website","icon":"globe","href":"https://keupera.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"keupera","hasAudioNarration":false,"actualSubdomain":"keupera","customDomains":["docs.keupera.com"],"gitSource":{"type":"github","owner":"keupera","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a4d0eac65e72e4bce5904aa","collectionId":"b268d319-95c5-4476-ad3e-021f5ba98246","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a4d0eac65e72e4bce5904aa:success","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API reference","count":59},{"language":"default","tag":"Guides","count":24},{"language":"default","tag":"MCP Server","count":19},{"language":"default","tag":"Content","count":15},{"language":"default","tag":"Connect","count":15},{"language":"default","tag":"Analytics","count":14},{"language":"default","tag":"AI Visibility","count":10},{"language":"default","tag":"Backlinks","count":10},{"language":"default","tag":"Keywords","count":9},{"language":"default","tag":"Integrations","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/keywords/trigger-keyword-research","slug":"/api-reference/keywords/trigger-keyword-research","pageMetadata":{"title":"Trigger keyword research","description":"Generates keyword ideas using AI plus DataForSEO enrichment.\n\nThis is a **long-running job**. By default the endpoint returns a job handle immediately (`202 Accepted`) — poll `GET /keywords/research/{jobId}` with the returned `job_id` until `status` is `completed`. Pass `\"sync\": true` to wait inline, but this is not recommended as it is subject to gateway timeouts.\n\nConsumes keyword research credits.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /keywords/research","href":"/api-reference/keywords/trigger-keyword-research","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 strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Generates keyword ideas using AI plus DataForSEO enrichment.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"This is a \", _jsx(_components.strong, {\n children: \"long-running job\"\n }), \". By default the endpoint returns a job handle immediately (\", _jsx(_components.code, {\n children: \"202 Accepted\"\n }), \") — poll \", _jsx(_components.code, {\n children: \"GET /keywords/research/{jobId}\"\n }), \" with the returned \", _jsx(_components.code, {\n children: \"job_id\"\n }), \" until \", _jsx(_components.code, {\n children: \"status\"\n }), \" is \", _jsx(_components.code, {\n children: \"completed\"\n }), \". Pass \", _jsx(_components.code, {\n children: \"\\\"sync\\\": true\"\n }), \" to wait inline, but this is not recommended as it is subject to gateway timeouts.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Consumes keyword research credits.\"\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":"Trigger keyword research","description":"Generates keyword ideas using AI plus DataForSEO enrichment.\n\nThis is a **long-running job**. By default the endpoint returns a job handle immediately (`202 Accepted`) — poll `GET /keywords/research/{jobId}` with the returned `job_id` until `status` is `completed`. Pass `\"sync\": true` to wait inline, but this is not recommended as it is subject to gateway timeouts.\n\nConsumes keyword research credits.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /keywords/research","href":"/api-reference/keywords/trigger-keyword-research","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Keywords"],"summary":"Trigger keyword research","operationId":"triggerKeywordResearch","description":"Generates keyword ideas using AI plus DataForSEO enrichment.\n\nThis is a **long-running job**. By default the endpoint returns a job handle immediately (`202 Accepted`) — poll `GET /keywords/research/{jobId}` with the returned `job_id` until `status` is `completed`. Pass `\"sync\": true` to wait inline, but this is not recommended as it is subject to gateway timeouts.\n\nConsumes keyword research credits.","requestBody":"0bfb57f4-e8bd-443b-b0d3-dcea56a8ed26","responses":{"202":"e34cbff3-2aa1-4901-86fb-e9b82f1be56a","400":"f834e8a6-e569-47c3-9d8f-23b2b5936af8","401":"bc3dec67-1636-4603-92dd-e1b5c6ab89e2","402":"912cb2d3-256a-4845-914c-5f305452528a"},"method":"post","type":"path","servers":["efb4ba8b-f378-4d46-87f2-9acfbb12911e"],"security":["306996e1-f7ed-4273-b252-d246081a36db"],"path":"/keywords/research","baseUrlOptions":["https://app.keupera.com/api/v1"],"title":"Trigger keyword research","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["seed_keywords"],"properties":{"seed_keywords":{"type":"array","items":{"type":"string","uniqueKey":"seed_keywords.items.[INDEX]","typeLabel":"string"},"description":"Seed terms to expand from.","isRequired":true,"uniqueKey":"seed_keywords","typeLabel":"string[]"},"website_id":{"type":"string","format":"uuid","uniqueKey":"website_id","typeLabel":"string\u003cuuid>"},"language":{"type":"string","description":"Language code, e.g. `en`.","uniqueKey":"language","typeLabel":"string"},"country":{"type":"string","description":"Country code, e.g. `US`.","uniqueKey":"country","typeLabel":"string"},"sync":{"type":"boolean","default":false,"description":"Set `true` to wait for the inline result (not recommended).","uniqueKey":"sync","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"example":{"website_id":"b3f1...","seed_keywords":["seo tools","content marketing"],"language":"en","country":"US","sync":false},"examples":{"Example":{"title":"Example","value":{"website_id":"b3f1...","seed_keywords":["seo tools","content marketing"],"language":"en","country":"US","sync":false}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"e34cbff3-2aa1-4901-86fb-e9b82f1be56a":{"description":"Research job accepted.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","uniqueKey":"data.job_id","typeLabel":"string"},"status":{"type":"string","example":"pending","uniqueKey":"data.status","typeLabel":"string"},"poll_url":{"type":"string","uniqueKey":"data.poll_url","typeLabel":"string"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":{"job_id":"abc-uuid","status":"pending","poll_url":"/keywords/research/abc-uuid"}},"examples":{"Example":{"title":"Example","value":{"data":{"job_id":"abc-uuid","status":"pending","poll_url":"/keywords/research/abc-uuid"}}}},"exampleType":"examples"}},"exampleType":"examples"},"f834e8a6-e569-47c3-9d8f-23b2b5936af8":{"description":"Bad request — missing or invalid parameters.","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope.","properties":{"error":{"type":"string","description":"Descriptive error message.","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Missing required field: keywords"},"examples":{"Example":{"title":"Example","value":{"error":"Missing required field: keywords"}}},"exampleType":"examples"}},"exampleType":"examples"},"bc3dec67-1636-4603-92dd-e1b5c6ab89e2":{"description":"Unauthorized — missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope.","properties":{"error":{"type":"string","description":"Descriptive error message.","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Invalid or missing API key"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid or missing API key"}}},"exampleType":"examples"}},"exampleType":"examples"},"912cb2d3-256a-4845-914c-5f305452528a":{"description":"Usage limit reached — crawl credits, AI credits, or other quota exhausted. Enable metered billing to allow overage.","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope.","properties":{"error":{"type":"string","description":"Descriptive error message.","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Usage limit reached for keyword_research"},"examples":{"Example":{"title":"Example","value":{"error":"Usage limit reached for keyword_research"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"306996e1-f7ed-4273-b252-d246081a36db":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Pass your Keupera API key as a Bearer token: `Authorization: Bearer YOUR_KEUPERA_API_KEY`. Generate keys from **Account → API Keys** in your Keupera dashboard.","scopes":[]}}},"servers":{"efb4ba8b-f378-4d46-87f2-9acfbb12911e":{"url":"https://app.keupera.com/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Pass your Keupera API key as a Bearer token: `Authorization: Bearer YOUR_KEUPERA_API_KEY`. Generate keys from **Account → API Keys** in your Keupera dashboard.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Pass your Keupera API key as a Bearer token: `Authorization: Bearer YOUR_KEUPERA_API_KEY`. Generate keys from **Account → API Keys** in your Keupera dashboard.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"keupera","siteName":"Keupera Docs","title":"Trigger keyword research - Keupera Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-07T14:35:44.394Z","originalFileLocation":"api-reference/keywords/trigger-keyword-research.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=\"Generates keyword ideas using AI plus DataForSEO enrichment. This is a long-running job. By default the endpoint returns a job handle immediately (202 Accepted) — poll GET /keywords/research/{jobId} with the returned job_id until status is completed. Pass \u0026quot;sync\u0026quot;: true to wait inline, but this is not recommended as it is subject to gateway timeouts. Consumes keyword research credits.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Keupera Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/keupera/pPgLW2rzXX3O569-/_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/keupera/pPgLW2rzXX3O569-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/keupera/pPgLW2rzXX3O569-/_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/keupera/pPgLW2rzXX3O569-/_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/keupera/pPgLW2rzXX3O569-/_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/keupera/pPgLW2rzXX3O569-/_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/keupera/pPgLW2rzXX3O569-/_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/keupera/pPgLW2rzXX3O569-/_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/keupera/pPgLW2rzXX3O569-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Trigger keyword research - Keupera Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Generates keyword ideas using AI plus DataForSEO enrichment. This is a long-running job. By default the endpoint returns a job handle immediately (202 Accepted) — poll GET /keywords/research/{jobId} with the returned job_id until status is completed. Pass \u0026quot;sync\u0026quot;: true to wait inline, but this is not recommended as it is subject to gateway timeouts. Consumes keyword research credits.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Keupera Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.keupera.com/api-reference/keywords/trigger-keyword-research\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://keupera.mintlify.app/_mintlify/api/og/v2?division=Keywords\u0026amp;title=Trigger+keyword+research\u0026amp;description=Generates+keyword+ideas+using+AI+plus+DataForSEO+enrichment.%0A%0AThis+is+a+**long-running+job**.+By+default+the+endpoint+returns+a+job+handle+immediately+%28%60202+Acc\u0026amp;theme=bcbc2ac2fffc559d69cfdc37\u0026amp;signature=b10524671fa4e6aa4a7d44a255f62f5bda5282e545fa6222a05d3ab57874d8bc\">\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=\"Trigger keyword research - Keupera Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Generates keyword ideas using AI plus DataForSEO enrichment. This is a long-running job. By default the endpoint returns a job handle immediately (202 Accepted) — poll GET /keywords/research/{jobId} with the returned job_id until status is completed. Pass \u0026quot;sync\u0026quot;: true to wait inline, but this is not recommended as it is subject to gateway timeouts. Consumes keyword research credits.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://keupera.mintlify.app/_mintlify/api/og/v2?division=Keywords\u0026amp;title=Trigger+keyword+research\u0026amp;description=Generates+keyword+ideas+using+AI+plus+DataForSEO+enrichment.%0A%0AThis+is+a+**long-running+job**.+By+default+the+endpoint+returns+a+job+handle+immediately+%28%60202+Acc\u0026amp;theme=bcbc2ac2fffc559d69cfdc37\u0026amp;signature=b10524671fa4e6aa4a7d44a255f62f5bda5282e545fa6222a05d3ab57874d8bc\">\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/keupera/pPgLW2rzXX3O569-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Keupera Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0062fb\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.keupera.com/api-reference/keywords/trigger-keyword-research\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/keywords/trigger-keyword-research.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.keupera.com/#organization\",\"name\":\"Keupera Docs\",\"url\":\"https://docs.keupera.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/keupera/lZpWL3J0-hZm9sgA/logo/light.svg?fit=max\u0026auto=format\u0026n=lZpWL3J0-hZm9sgA\u0026q=85\u0026s=a82c2b1d1cddd65db77cfd68e9056e52\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.keupera.com#website\",\"name\":\"Keupera Docs\",\"url\":\"https://docs.keupera.com\",\"publisher\":{\"@id\":\"https://docs.keupera.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.keupera.com/api-reference/keywords/trigger-keyword-research#webpage\",\"url\":\"https://docs.keupera.com/api-reference/keywords/trigger-keyword-research\",\"name\":\"Trigger keyword research\",\"description\":\"Generates keyword ideas using AI plus DataForSEO enrichment. This is a long-running job. By default the endpoint returns a job handle immediately (202 Accepted) — poll GET /keywords/research/{jobId} with the returned job_id until status is completed. Pass \\\"sync\\\": true to wait inline, but this is not recommended as it is subject to gateway timeouts. Consumes keyword research credits.\",\"dateModified\":\"2026-07-07T14:35:44.394Z\",\"isPartOf\":{\"@id\":\"https://docs.keupera.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.keupera.com/api-reference/keywords/trigger-keyword-research#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.keupera.com/api-reference/keywords/trigger-keyword-research#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Keywords\",\"item\":\"https://docs.keupera.com/api-reference/keywords\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Trigger keyword research\",\"item\":\"https://docs.keupera.com/api-reference/keywords/trigger-keyword-research\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.keupera.com/api-reference/keywords/trigger-keyword-research#apireference\",\"headline\":\"Trigger keyword research\",\"name\":\"Trigger keyword research\",\"description\":\"Generates keyword ideas using AI plus DataForSEO enrichment. This is a long-running job. By default the endpoint returns a job handle immediately (202 Accepted) — poll GET /keywords/research/{jobId} with the returned job_id until status is completed. Pass \\\"sync\\\": true to wait inline, but this is not recommended as it is subject to gateway timeouts. Consumes keyword research credits.\",\"url\":\"https://docs.keupera.com/api-reference/keywords/trigger-keyword-research\",\"mainEntityOfPage\":{\"@id\":\"https://docs.keupera.com/api-reference/keywords/trigger-keyword-research#webpage\"},\"dateModified\":\"2026-07-07T14:35:44.394Z\",\"publisher\":{\"@id\":\"https://docs.keupera.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.keupera.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Keupera Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Keupera Docs","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://app.keupera.com"},{"anchor":"Website","icon":"globe","href":"https://keupera.com"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API Overview","icon":"book-open","href":"/api-reference/introduction"}]},{"group":"Keywords","pages":[{"title":"Keywords","icon":"magnifying-glass","href":"/api-reference/keywords"},{"title":"List keywords","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /keywords","href":"/api-reference/keywords/list-keywords"},{"title":"Add keywords","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /keywords","href":"/api-reference/keywords/add-keywords"},{"title":"Delete keywords","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /keywords","href":"/api-reference/keywords/delete-keywords"},{"title":"Toggle keyword star","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /keywords/{id}/star","href":"/api-reference/keywords/toggle-keyword-star"},{"title":"Bulk update keyword status","description":"Updates the status of multiple keywords in a single request.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /keywords/status","href":"/api-reference/keywords/bulk-update-keyword-status"},{"title":"Trigger keyword research","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /keywords/research","href":"/api-reference/keywords/trigger-keyword-research"},{"title":"Poll a research job","description":"Returns the current state of a keyword research job. Poll until `status` is `completed` or `failed`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /keywords/research/{jobId}","href":"/api-reference/keywords/poll-a-research-job"},{"title":"List keyword groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /keywords/groups","href":"/api-reference/keywords/list-keyword-groups"}]},{"group":"Backlinks","pages":[{"title":"Backlinks","icon":"link","href":"/api-reference/backlinks"},{"title":"List campaigns","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /campaigns","href":"/api-reference/backlinks/list-campaigns"},{"title":"Create campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /campaigns","href":"/api-reference/backlinks/create-campaign"},{"title":"Get campaign details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /campaigns/{id}","href":"/api-reference/backlinks/get-campaign-details"},{"title":"List campaign opportunities","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /campaigns/{id}/opportunities","href":"/api-reference/backlinks/list-campaign-opportunities"},{"title":"Get strategic recommendations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /campaigns/{id}/recommendations","href":"/api-reference/backlinks/get-strategic-recommendations"},{"title":"Get an opportunity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /opportunities/{id}","href":"/api-reference/backlinks/get-an-opportunity"},{"title":"Update an opportunity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /opportunities/{id}","href":"/api-reference/backlinks/update-an-opportunity"},{"title":"Generate an outreach email","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /opportunities/{id}/generate-email","href":"/api-reference/backlinks/generate-an-outreach-email"},{"title":"Send an outreach email","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /opportunities/{id}/send-email","href":"/api-reference/backlinks/send-an-outreach-email"}]},{"group":"Content","pages":[{"title":"Content","icon":"pen-nib","href":"/api-reference/content"},{"title":"List articles","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /articles","href":"/api-reference/content/list-articles"},{"title":"Create an article","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /articles","href":"/api-reference/content/create-an-article"},{"title":"Get an article","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /articles/{id}","href":"/api-reference/content/get-an-article"},{"title":"Update an article","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /articles/{id}","href":"/api-reference/content/update-an-article"},{"title":"Delete an article","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /articles/{id}","href":"/api-reference/content/delete-an-article"},{"title":"Trigger article generation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /articles/{id}/generate","href":"/api-reference/content/trigger-article-generation"},{"title":"Get calendar events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /articles/calendar","href":"/api-reference/content/get-calendar-events"},{"title":"Get automation settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /automation","href":"/api-reference/content/get-automation-settings"},{"title":"Update automation settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /automation","href":"/api-reference/content/update-automation-settings"},{"title":"List blog posts (legacy)","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /blog-posts","href":"/api-reference/content/list-blog-posts-legacy"},{"title":"Get a blog post (legacy)","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /blog-posts/{id}","href":"/api-reference/content/get-a-blog-post-legacy"}]},{"group":"AI Visibility","pages":[{"title":"AI Visibility","icon":"robot","href":"/api-reference/ai-visibility"},{"title":"List Brand Radar campaigns","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /brand-radar/campaigns","href":"/api-reference/ai-visibility/list-brand-radar-campaigns"},{"title":"Create a Brand Radar campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /brand-radar/campaigns","href":"/api-reference/ai-visibility/create-a-brand-radar-campaign"},{"title":"Update a Brand Radar campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /brand-radar/campaigns/{id}","href":"/api-reference/ai-visibility/update-a-brand-radar-campaign"},{"title":"Delete a Brand Radar campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /brand-radar/campaigns/{id}","href":"/api-reference/ai-visibility/delete-a-brand-radar-campaign"},{"title":"Get Brand Radar results","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /brand-radar/campaigns/{id}/results","href":"/api-reference/ai-visibility/get-brand-radar-results"},{"title":"List Prompt Research campaigns","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /prompt-research/campaigns","href":"/api-reference/ai-visibility/list-prompt-research-campaigns"},{"title":"Create a Prompt Research campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /prompt-research/campaigns","href":"/api-reference/ai-visibility/create-a-prompt-research-campaign"},{"title":"Get Prompt Research campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /prompt-research/campaigns/{id}","href":"/api-reference/ai-visibility/get-prompt-research-campaign"},{"title":"Get AI Visibility Score","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /score","href":"/api-reference/ai-visibility/get-ai-visibility-score"}]},{"group":"Analytics","pages":[{"title":"Analytics","icon":"chart-line","href":"/api-reference/analytics"},{"title":"Website summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /website/summary","href":"/api-reference/analytics/website-summary"},{"title":"Daily traffic","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /website/daily","href":"/api-reference/analytics/daily-traffic"},{"title":"Top pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /website/top-pages","href":"/api-reference/analytics/top-pages"},{"title":"Referrers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /website/referrers","href":"/api-reference/analytics/referrers"},{"title":"Device breakdown","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /website/devices","href":"/api-reference/analytics/device-breakdown"},{"title":"Browser breakdown","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /website/browsers","href":"/api-reference/analytics/browser-breakdown"},{"title":"Geographic traffic","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /website/geo","href":"/api-reference/analytics/geographic-traffic"},{"title":"Search Console daily stats","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /search-console/daily","href":"/api-reference/analytics/search-console-daily-stats"},{"title":"Search Console top keywords","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /search-console/keywords","href":"/api-reference/analytics/search-console-top-keywords"},{"title":"Search Console top pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /search-console/pages","href":"/api-reference/analytics/search-console-top-pages"},{"title":"Bot traffic summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /bot-traffic/summary","href":"/api-reference/analytics/bot-traffic-summary"},{"title":"Daily bot traffic","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /bot-traffic/daily","href":"/api-reference/analytics/daily-bot-traffic"},{"title":"Top crawled pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /bot-traffic/top-pages","href":"/api-reference/analytics/top-crawled-pages"}]},{"group":"Account \u0026 Utilities","pages":[{"title":"Account \u0026 Utilities","icon":"user","href":"/api-reference/utilities"},{"title":"Verify credentials","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /me","href":"/api-reference/account-\u0026-utilities/verify-credentials"},{"title":"Connect a CMS integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /connect","href":"/api-reference/account-\u0026-utilities/connect-a-cms-integration"}]}]},{"tab":"MCP Server","pages":[{"title":"MCP Server","href":"/mcp/introduction"}]}]},"title":"Trigger keyword research - Keupera Docs","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}