Start estimating a list of up to 200 keywords. The list runs in the background: poll Get Keyword List for each keyword’s weekly volume, Demand Score and Commercial Intent score as they finish. Repeated keywords are counted once.
Each keyword that hasn’t been estimated recently uses one of the brand’s weekly lookups. When the list needs more than the brand has left, the keywords past the limit are skipped (status skipped_weekly_limit) rather than the list being refused; recently estimated keywords always run, and use no lookup. A keyword that fails gives its lookup back.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Scrunch API Docs","colors":{"primary":"#84A027","light":"#D8FC3B","dark":"#434E0D"},"logo":{"light":"https://mintcdn.com/scrunchai/wmS3vnEYkMiks-uo/logo/scrunch-dark.svg?fit=max\u0026auto=format\u0026n=wmS3vnEYkMiks-uo\u0026q=85\u0026s=1ea209cf21e43eae27a79f766cb2cd31","dark":"https://mintcdn.com/scrunchai/wmS3vnEYkMiks-uo/logo/scrunch-light.svg?fit=max\u0026auto=format\u0026n=wmS3vnEYkMiks-uo\u0026q=85\u0026s=f34563ac089933acd9bc841be78f0869","href":"https://developers.scrunch.com/"},"favicon":"https://mintcdn.com/scrunchai/lCDS3kviKweSb6eg/logo/favicon-green.png?fit=max\u0026auto=format\u0026n=lCDS3kviKweSb6eg\u0026q=85\u0026s=87f0c724d3b7bb2f310e2ffd6b54a30e","api":{"examples":{"prefill":true}},"background":{"decoration":"grid"},"navbar":{"links":[{"href":"https://helpcenter.scrunchai.com/en/","label":"Help Center"},{"href":"https://scrunch.com/blog","label":"Blog"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.scrunchai.com"}},"footer":{"socials":{"x":"https://x.com/scrunchai","linkedin":"https://linkedin.com/company/scrunchai"}},"integrations":{"telemetry":{"enabled":false}},"contextual":{"options":["copy","view","mcp","claude","chatgpt"],"display":"header"},"thumbnails":{"fonts":{"family":"Inter"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Status","icon":"flag","href":"https://status.scrunchai.com"},{"anchor":"Changelog","icon":"clock-rotate-left","href":"/changelog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"scrunchai","hasAudioNarration":false,"actualSubdomain":"scrunchai","customDomains":["developers.scrunch.com"],"gitSource":{"type":"github","owner":"excelsa-labs","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af36a6d81b9ebcb00164520","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API Reference","count":77},{"language":"default","tag":"MCP","count":40},{"language":"default","tag":"Workflows","count":24},{"language":"default","tag":"Configure","count":22},{"language":"default","tag":"Measure","count":21},{"language":"default","tag":"Configuration API","count":19},{"language":"default","tag":"Guides","count":16},{"language":"default","tag":"Deprecated","count":14},{"language":"default","tag":"Prompt Library","count":12},{"language":"default","tag":"Optimize","count":11}]},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"email":"support@scrunchai.com","showHelpButton":false}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles/global.css","content":".welcome-card-img-dark{display:none!important}html.dark .welcome-card-img-dark{display:block!important}html.dark .welcome-card-img-light{display:none!important}.welcome-card{display:block;text-decoration:none!important;border-bottom:none!important;color:inherit}.welcome-card p{text-decoration:none!important;border-bottom:none!important}.welcome-card-img{width:100%;border-radius:12px;display:block;transition:transform 0.2s ease;pointer-events:none}.welcome-card:hover .welcome-card-img{transform:scale(1.03)}.api-intro-hero{display:grid;grid-template-columns:3fr 2fr;gap:32px;align-items:center;margin-bottom:8px}.api-intro-hero-img{width:100%;max-width:280px;justify-self:end;border-radius:12px}@media (max-width: 640px){.api-intro-hero{grid-template-columns:1fr}.api-intro-hero-img{display:none}}html:not(.dark) .prompt{background-color:#FFFFFF!important}html:not(.dark) body,html:not(.dark) body>div,html:not(.dark) .mintlify,html:not(.dark) .pageWrapper,html:not(.dark) main{background-color:#FBF9F6!important}.update h2{font-size:1.0625rem;line-height:1.45;font-weight:600;letter-spacing:-0.01em;margin-top:0;margin-bottom:0.375rem}.update h2~h2,.update [data-as=\"p\"]+[data-as=\"p\"]{display:block;margin-top:1.375rem;padding-top:1.375rem;border-top:1px solid rgb(0 0 0 / 0.07)}html.dark .update h2~h2,html.dark .update [data-as=\"p\"]+[data-as=\"p\"]{border-top-color:rgb(255 255 255 / 0.1)}.update{scroll-margin-top:7rem}.cl-jump{display:flex;flex-direction:column;padding-top:1.25rem;border-top:1px solid rgb(0 0 0 / 0.07)}html.dark .cl-jump{border-top-color:rgb(255 255 255 / 0.1)}.cl-jump-title{font-weight:500;color:rgb(55 65 81);margin-bottom:0.75rem}html.dark .cl-jump-title{color:rgb(209 213 219)}.cl-jump-year{font-size:0.6875rem;font-weight:600;letter-spacing:0.06em;text-transform:uppercase;color:rgb(107 114 128);margin-bottom:0.5rem}.cl-jump-months{display:grid;grid-template-columns:repeat(2, minmax(0, 1fr));gap:0.25rem;list-style:none;margin:0 0 0.75rem;padding:0}.cl-jump-months:last-child{margin-bottom:0}.cl-jump-month{display:flex;align-items:baseline;justify-content:space-between;gap:0.5rem;width:100%;padding:0.25rem 0.5rem;border-radius:0.375rem;font-size:0.8125rem;line-height:1.4;color:rgb(75 85 99);background:transparent;cursor:pointer;transition:background-color 0.12s ease, color 0.12s ease}html.dark .cl-jump-month{color:rgb(156 163 175)}.cl-jump-month:hover{background:rgb(0 0 0 / 0.04);color:rgb(17 24 39)}html.dark .cl-jump-month:hover{background:rgb(255 255 255 / 0.06);color:rgb(243 244 246)}.cl-jump-month.is-active{background:rgb(174 206 49 / 0.45);color:#40362E;font-weight:500}html.dark .cl-jump-month.is-active{background:rgb(132 160 39 / 0.40);color:#FFFFFF}.cl-jump-count{font-variant-numeric:tabular-nums;font-size:0.75rem;opacity:0.55}.cl-cat--analytics{--cl-bg: rgb(60 103 245 / 0.18);--cl-fg: #1F2CAE}.cl-cat--integrations{--cl-bg: rgb(31 44 174 / 0.16);--cl-fg: #1F2CAE}.cl-cat--platform{--cl-bg: rgb(147 192 254 / 0.45);--cl-fg: #1F2CAE}.cl-cat--settings-admin{--cl-bg: rgb(184 171 142 / 0.45);--cl-fg: #40362E}.cl-cat--ui-ux{--cl-bg: rgb(239 190 3 / 0.35);--cl-fg: #88520B}.cl-cat--data-crawling{--cl-bg: rgb(255 232 67 / 0.55);--cl-fg: #88520B}.cl-cat--performance{--cl-bg: rgb(136 82 11 / 0.16);--cl-fg: #88520B}.cl-cat--api-mcp{--cl-bg: rgb(88 107 22 / 0.13);--cl-fg: #586B16}.cl-cat--bug-fix{--cl-bg: #F1E8C7;--cl-fg: #40362E}.cl-cat--general{--cl-bg: transparent;--cl-fg: #40362E;box-shadow:inset 0 0 0 1px rgb(64 54 46 / 0.35)}html.dark .cl-cat--analytics{--cl-bg: rgb(60 103 245 / 0.30);--cl-fg: #93C0FE}html.dark .cl-cat--integrations{--cl-bg: rgb(31 44 174 / 0.50);--cl-fg: #93C0FE}html.dark .cl-cat--platform{--cl-bg: rgb(147 192 254 / 0.20);--cl-fg: #93C0FE}html.dark .cl-cat--settings-admin{--cl-bg: rgb(184 171 142 / 0.22);--cl-fg: #B8AB8E}html.dark .cl-cat--ui-ux{--cl-bg: rgb(239 190 3 / 0.24);--cl-fg: #FFE843}html.dark .cl-cat--data-crawling{--cl-bg: rgb(255 232 67 / 0.16);--cl-fg: #FFE843}html.dark .cl-cat--api-mcp{--cl-bg: rgb(88 107 22 / 0.45);--cl-fg: #AECE31}html.dark .cl-cat--performance{--cl-bg: rgb(136 82 11 / 0.45);--cl-fg: #FFE843}html.dark .cl-cat--bug-fix{--cl-bg: rgb(241 232 199 / 0.20);--cl-fg: #F1E8C7}html.dark .cl-cat--general{--cl-bg: transparent;--cl-fg: #B8AB8E;box-shadow:inset 0 0 0 1px rgb(184 171 142 / 0.35)}[data-component-part=\"update-tag\"].cl-cat,#changelog-filters-content button.cl-cat{font-weight:500;background-color:var(--cl-bg)!important;color:var(--cl-fg)!important}[data-component-part=\"update-tag\"].cl-cat{padding:0.125rem 0.5rem}#changelog-filters-content button{transition:box-shadow 0.15s ease, transform 0.15s ease}#changelog-filters-content button:hover{box-shadow:0 2px 6px rgb(64 54 46 / 0.16), 0 1px 2px rgb(64 54 46 / 0.1);transform:translateY(-1px)}html.dark #changelog-filters-content button:hover{box-shadow:0 2px 6px rgb(0 0 0 / 0.5), 0 1px 2px rgb(0 0 0 / 0.35)}@media (prefers-reduced-motion: reduce){#changelog-filters-content button{transition:none}#changelog-filters-content button:hover{transform:none}}.update [data-component-part=\"update-label\"],.update [data-component-part=\"update-tag\"],#changelog-filters-content button,.cl-jump-month{border-radius:9999px}"}],"page":{"pagePath":"api-reference/keyword-volume/start-keyword-list","slug":"/api-reference/keyword-volume/start-keyword-list","pageMetadata":{"title":"Start Keyword List","description":"Start estimating a list of up to 200 keywords. The list runs in the background: poll Get Keyword List for each keyword's weekly volume, Demand Score and Commercial Intent score as they finish. Repeated keywords are counted once.\n\nEach keyword that hasn't been estimated recently uses one of the brand's weekly lookups. When the list needs more than the brand has left, the keywords past the limit are skipped (status `skipped_weekly_limit`) rather than the list being refused; recently estimated keywords always run, and use no lookup. A keyword that fails gives its lookup back.\n\nA brand runs one list at a time.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /{brand_id}/keyword-volume/lists","href":"/api-reference/keyword-volume/start-keyword-list","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Start estimating a list of up to 200 keywords. The list runs in the background: poll Get Keyword List for each keyword’s weekly volume, Demand Score and Commercial Intent score as they finish. Repeated keywords are counted once.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Each keyword that hasn’t been estimated recently uses one of the brand’s weekly lookups. When the list needs more than the brand has left, the keywords past the limit are skipped (status \", _jsx(_components.code, {\n children: \"skipped_weekly_limit\"\n }), \") rather than the list being refused; recently estimated keywords always run, and use no lookup. A keyword that fails gives its lookup back.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"A brand runs one list at a time.\"\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":"Start Keyword List","description":"Start estimating a list of up to 200 keywords. The list runs in the background: poll Get Keyword List for each keyword's weekly volume, Demand Score and Commercial Intent score as they finish. Repeated keywords are counted once.\n\nEach keyword that hasn't been estimated recently uses one of the brand's weekly lookups. When the list needs more than the brand has left, the keywords past the limit are skipped (status `skipped_weekly_limit`) rather than the list being refused; recently estimated keywords always run, and use no lookup. A keyword that fails gives its lookup back.\n\nA brand runs one list at a time.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /{brand_id}/keyword-volume/lists","href":"/api-reference/keyword-volume/start-keyword-list","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/scrunchai/bca9f10e73242105/changelog-enhance.js"],"openApiReferenceData":{"operation":{"tags":["keyword-volume"],"summary":"Start Keyword List","description":"Start estimating a list of up to 200 keywords. The list runs in the background: poll Get Keyword List for each keyword's weekly volume, Demand Score and Commercial Intent score as they finish. Repeated keywords are counted once.\n\nEach keyword that hasn't been estimated recently uses one of the brand's weekly lookups. When the list needs more than the brand has left, the keywords past the limit are skipped (status `skipped_weekly_limit`) rather than the list being refused; recently estimated keywords always run, and use no lookup. A keyword that fails gives its lookup back.\n\nA brand runs one list at a time.","operationId":"startKeywordList","security":["0471783a-9a83-4edf-b072-edf3a9b9bbe5"],"parameters":["5fd4d588-332b-4290-a7cb-a249c30fd349"],"requestBody":"4f73a15a-e5b4-471c-ae3a-04a3fc2900b4","responses":{"202":"e536b5e5-82a2-45ac-82d6-eba79356f99e","409":"13e6eec9-b4f6-4636-b174-c7478de81792","422":"7b006efc-a8ef-4abf-9e0d-c7c7ee7ef2f0","429":"822e3484-cfa1-49fc-a8f2-4b969e2c9ad3","503":"9c2c853b-68e5-462b-80f3-e1846d9a7f80"},"method":"post","type":"path","servers":["d688f9a2-3774-4ad8-8234-12467aa0a5ad"],"path":"/{brand_id}/keyword-volume/lists","baseUrlOptions":["https://api.scrunchai.com/v1"],"title":"Start Keyword List","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.keywords.items.0":"\u003cstring>"}]},"dependencies":{"parameters":{"5fd4d588-332b-4290-a7cb-a249c30fd349":{"name":"brand_id","in":"path","required":true,"schema":{"type":"integer","description":"The unique identifier for the brand","title":"Brand Id","isRequired":true,"uniqueKey":"","typeLabel":"integer"},"description":"The unique identifier for the brand"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keywords":{"items":{"type":"string","maxLength":200,"uniqueKey":"keywords.items.[INDEX]","typeLabel":"string"},"type":"array","maxItems":200,"minItems":1,"title":"Keywords","description":"Up to 200 keywords, each up to 200 characters. Repeats (ignoring case and spacing) are counted once, and blank entries are dropped.","isRequired":true,"uniqueKey":"keywords","typeLabel":"string[]"}},"type":"object","required":["keywords"],"title":"KeywordBulkRequest","description":"A list of keywords to estimate in the background.","uniqueKey":"","typeLabel":"KeywordBulkRequest · object"},"examples":{"Example":{"title":"Example","value":{"keywords":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e536b5e5-82a2-45ac-82d6-eba79356f99e":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"id":{"type":"integer","title":"Id","description":"The list's id.","isRequired":true,"uniqueKey":"id","typeLabel":"integer"},"status":{"type":"string","enum":["queued","running","finished","failed","canceled"],"title":"Status","description":"`queued` (waiting to start), `running`, `finished`, `failed` (stopped early; unused lookups were given back) or `canceled`.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"country":{"type":"string","title":"Country","description":"The country the estimates are for. Always `US` today.","isRequired":true,"uniqueKey":"country","typeLabel":"string"},"item_count":{"type":"integer","title":"Item Count","description":"How many keywords are on the list, after repeats and blanks are dropped.","isRequired":true,"uniqueKey":"item_count","typeLabel":"integer"},"counts":{"properties":{"pending":{"type":"integer","title":"Pending","description":"Waiting to run.","default":0,"uniqueKey":"counts.pending","typeLabel":"integer"},"running":{"type":"integer","title":"Running","description":"Being estimated now.","default":0,"uniqueKey":"counts.running","typeLabel":"integer"},"done":{"type":"integer","title":"Done","description":"Finished, with results.","default":0,"uniqueKey":"counts.done","typeLabel":"integer"},"failed":{"type":"integer","title":"Failed","description":"Couldn't be estimated. Their weekly lookups were given back.","default":0,"uniqueKey":"counts.failed","typeLabel":"integer"},"skipped_weekly_limit":{"type":"integer","title":"Skipped Weekly Limit","description":"Not run: the brand's weekly lookups ran out.","default":0,"uniqueKey":"counts.skipped_weekly_limit","typeLabel":"integer"},"canceled":{"type":"integer","title":"Canceled","description":"Not run: the list was canceled or stopped first.","default":0,"uniqueKey":"counts.canceled","typeLabel":"integer"}},"type":"object","title":"KeywordBulkCounts","description":"How many of the list's keywords are in each status.","isRequired":true,"uniqueKey":"counts","typeLabel":"KeywordBulkCounts · object"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the list was started.","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"started_at":{"oneOf":[{"type":"string","title":"Started At","description":"When it began running. Null while it's queued.","format":"date-time","isRequired":true,"uniqueKey":"started_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Started At","description":"When it began running. Null while it's queued.","isRequired":true,"uniqueKey":"started_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"started_at","typeLabel":"string\u003cdate-time> | null"},"finished_at":{"oneOf":[{"type":"string","title":"Finished At","description":"When it ended. Null while it's queued or running.","format":"date-time","isRequired":true,"uniqueKey":"finished_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Finished At","description":"When it ended. Null while it's queued or running.","isRequired":true,"uniqueKey":"finished_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"finished_at","typeLabel":"string\u003cdate-time> | null"}},"type":"object","required":["id","status","country","item_count","counts","created_at","started_at","finished_at"],"title":"KeywordBulkJob","description":"A keyword list: its status and progress, without the per-keyword results.","uniqueKey":"","typeLabel":"KeywordBulkJob · object"},"examples":{"Example":{"title":"Example","value":{"id":123,"status":"queued","country":"\u003cstring>","item_count":123,"counts":{"pending":0,"running":0,"done":0,"failed":0,"skipped_weekly_limit":0,"canceled":0},"created_at":"2023-11-07T05:31:56Z","started_at":"2023-11-07T05:31:56Z","finished_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"13e6eec9-b4f6-4636-b174-c7478de81792":{"description":"The brand already has a keyword list running. `detail.job_id` is that list: poll it or cancel it.","content":{"application/json":{"schema":{"properties":{"detail":{"properties":{"job_id":{"type":"integer","title":"Job Id","description":"The running list's id, to poll or cancel.","isRequired":true,"uniqueKey":"detail.job_id","typeLabel":"integer"},"message":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"},"error":{"type":"string","const":"bulk_job_active","title":"Error","default":"bulk_job_active","uniqueKey":"detail.error","typeLabel":"string"}},"type":"object","required":["job_id","message"],"title":"KeywordBulkActiveError","description":"The brand already has a keyword list running.","isRequired":true,"uniqueKey":"detail","typeLabel":"KeywordBulkActiveError · object"}},"type":"object","required":["detail"],"title":"KeywordBulkActiveResponse","description":"The 409 body as sent: the running list, inside the API's usual ``detail`` envelope.","uniqueKey":"","typeLabel":"KeywordBulkActiveResponse · object"},"examples":{"Example":{"title":"Example","value":{"detail":{"job_id":123,"message":"\u003cstring>","error":"bulk_job_active"}}}},"exampleType":"generated"}},"exampleType":"generated"},"7b006efc-a8ef-4abf-9e0d-c7c7ee7ef2f0":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"822e3484-cfa1-49fc-a8f2-4b969e2c9ad3":{"description":"No keyword on the list fits this week's lookups.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"9c2c853b-68e5-462b-80f3-e1846d9a7f80":{"description":"The list could not be started. Nothing was charged.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"0471783a-9a83-4edf-b072-edf3a9b9bbe5":{"HTTPBearer":{"type":"http","scheme":"bearer","scopes":["query"],"schemeName":"HTTPBearer"}}},"servers":{"d688f9a2-3774-4ad8-8234-12467aa0a5ad":{"url":"https://api.scrunchai.com/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":["query"],"schemeName":"HTTPBearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"HTTPBearer","name":"Authorization"}],"title":"HTTPBearer"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"scrunchai","siteName":"Scrunch API Docs","title":"Start Keyword List - Scrunch API Docs","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"contextualStarterQuestions":[],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T19:03:40.312Z","originalFileLocation":"api-reference/keyword-volume/start-keyword-list.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=\"Start estimating a list of up to 200 keywords. The list runs in the background: poll Get Keyword List for each keyword\u0026#x27;s weekly volume, Demand Score and Commercial Intent score as they finish. Repeated keywords are counted once. Each keyword that hasn\u0026#x27;t been estimated recently uses one of the brand\u0026#x27;s weekly lookups. When the list needs more than the brand has left, the keywords past the limit are skipped (status skipped_weekly_limit) rather than the list being refused; recently estimated keywords always run, and use no lookup. A keyword that fails gives its lookup back. A brand runs one list at a time.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Scrunch API 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/scrunchai/5P4kJEQP4z45O-k1/_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/scrunchai/5P4kJEQP4z45O-k1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scrunchai/5P4kJEQP4z45O-k1/_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/scrunchai/5P4kJEQP4z45O-k1/_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/scrunchai/5P4kJEQP4z45O-k1/_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/scrunchai/5P4kJEQP4z45O-k1/_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/scrunchai/5P4kJEQP4z45O-k1/_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/scrunchai/5P4kJEQP4z45O-k1/_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/scrunchai/5P4kJEQP4z45O-k1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Start Keyword List - Scrunch API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Start estimating a list of up to 200 keywords. The list runs in the background: poll Get Keyword List for each keyword\u0026#x27;s weekly volume, Demand Score and Commercial Intent score as they finish. Repeated keywords are counted once. Each keyword that hasn\u0026#x27;t been estimated recently uses one of the brand\u0026#x27;s weekly lookups. When the list needs more than the brand has left, the keywords past the limit are skipped (status skipped_weekly_limit) rather than the list being refused; recently estimated keywords always run, and use no lookup. A keyword that fails gives its lookup back. A brand runs one list at a time.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Scrunch API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.scrunch.com/api-reference/keyword-volume/start-keyword-list\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://scrunchai.mintlify.site/_mintlify/api/og/v2?division=Keyword+Volume+API\u0026amp;title=Start+Keyword+List\u0026amp;description=Start+estimating+a+list+of+up+to+200+keywords.+The+list+runs+in+the+background%3A+poll+Get+Keyword+List+for+each+keyword%27s+weekly+volume%2C+Demand+Score+and+Commerc\u0026amp;theme=649a67e452a44ab53c09d65d\u0026amp;signature=f28b5bfdbc442200d751d16de2eab2a0a7107982c8d10517ae6bf24728d77e4a\">\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=\"Start Keyword List - Scrunch API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Start estimating a list of up to 200 keywords. The list runs in the background: poll Get Keyword List for each keyword\u0026#x27;s weekly volume, Demand Score and Commercial Intent score as they finish. Repeated keywords are counted once. Each keyword that hasn\u0026#x27;t been estimated recently uses one of the brand\u0026#x27;s weekly lookups. When the list needs more than the brand has left, the keywords past the limit are skipped (status skipped_weekly_limit) rather than the list being refused; recently estimated keywords always run, and use no lookup. A keyword that fails gives its lookup back. A brand runs one list at a time.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://scrunchai.mintlify.site/_mintlify/api/og/v2?division=Keyword+Volume+API\u0026amp;title=Start+Keyword+List\u0026amp;description=Start+estimating+a+list+of+up+to+200+keywords.+The+list+runs+in+the+background%3A+poll+Get+Keyword+List+for+each+keyword%27s+weekly+volume%2C+Demand+Score+and+Commerc\u0026amp;theme=649a67e452a44ab53c09d65d\u0026amp;signature=f28b5bfdbc442200d751d16de2eab2a0a7107982c8d10517ae6bf24728d77e4a\">\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/scrunchai/5P4kJEQP4z45O-k1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Scrunch API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#84A027\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.scrunch.com/api-reference/keyword-volume/start-keyword-list\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/keyword-volume/start-keyword-list.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.scrunch.com/#organization\",\"name\":\"Scrunch API Docs\",\"url\":\"https://developers.scrunch.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/scrunchai/wmS3vnEYkMiks-uo/logo/scrunch-dark.svg?fit=max\u0026auto=format\u0026n=wmS3vnEYkMiks-uo\u0026q=85\u0026s=1ea209cf21e43eae27a79f766cb2cd31\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.scrunch.com#website\",\"name\":\"Scrunch API Docs\",\"url\":\"https://developers.scrunch.com\",\"publisher\":{\"@id\":\"https://developers.scrunch.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.scrunch.com/api-reference/keyword-volume/start-keyword-list#webpage\",\"url\":\"https://developers.scrunch.com/api-reference/keyword-volume/start-keyword-list\",\"name\":\"Start Keyword List\",\"description\":\"Start estimating a list of up to 200 keywords. The list runs in the background: poll Get Keyword List for each keyword's weekly volume, Demand Score and Commercial Intent score as they finish. Repeated keywords are counted once. Each keyword that hasn't been estimated recently uses one of the brand's weekly lookups. When the list needs more than the brand has left, the keywords past the limit are skipped (status skipped_weekly_limit) rather than the list being refused; recently estimated keywords always run, and use no lookup. A keyword that fails gives its lookup back. A brand runs one list at a time.\",\"dateModified\":\"2026-11-10T19:03:40.312Z\",\"isPartOf\":{\"@id\":\"https://developers.scrunch.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.scrunch.com/api-reference/keyword-volume/start-keyword-list#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.scrunch.com/api-reference/keyword-volume/start-keyword-list#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Measure\",\"item\":\"https://developers.scrunch.com/api-reference/query/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Keyword Volume API\",\"item\":\"https://developers.scrunch.com/api-reference/keyword-volume/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Start Keyword List\",\"item\":\"https://developers.scrunch.com/api-reference/keyword-volume/start-keyword-list\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.scrunch.com/api-reference/keyword-volume/start-keyword-list#apireference\",\"headline\":\"Start Keyword List\",\"name\":\"Start Keyword List\",\"description\":\"Start estimating a list of up to 200 keywords. The list runs in the background: poll Get Keyword List for each keyword's weekly volume, Demand Score and Commercial Intent score as they finish. Repeated keywords are counted once. Each keyword that hasn't been estimated recently uses one of the brand's weekly lookups. When the list needs more than the brand has left, the keywords past the limit are skipped (status skipped_weekly_limit) rather than the list being refused; recently estimated keywords always run, and use no lookup. A keyword that fails gives its lookup back. A brand runs one list at a time.\",\"url\":\"https://developers.scrunch.com/api-reference/keyword-volume/start-keyword-list\",\"mainEntityOfPage\":{\"@id\":\"https://developers.scrunch.com/api-reference/keyword-volume/start-keyword-list#webpage\"},\"dateModified\":\"2026-11-10T19:03:40.312Z\",\"publisher\":{\"@id\":\"https://developers.scrunch.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.scrunch.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Scrunch API Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Scrunch API Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/keyword-volume/start-keyword-list.md","siteName":"Scrunch API Docs","nav":{"global":{"anchors":[{"anchor":"Status","icon":"flag","href":"https://status.scrunchai.com"},{"anchor":"Changelog","icon":"clock-rotate-left","href":"/changelog"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","pages":[{"title":"Scrunch REST API Directory and Authentication","sidebarTitle":"Introduction","icon":"light-switch-off","href":"/api-reference/introduction"},{"group":"Measure","icon":"chart-mixed","pages":[{"group":"Query API","public":true,"pages":[{"title":"Query API: Aggregated AI Visibility Metrics","sidebarTitle":"Overview","href":"/api-reference/query/overview"},{"title":"Query","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/query","href":"/api-reference/query"},{"title":"Structured Query API: Multi-Metric JSON Endpoint","sidebarTitle":"Structured Query","href":"/api-reference/query/structured-query"}]},{"group":"Responses API","public":true,"pages":[{"title":"Responses API: Raw AI Answers and Citations","sidebarTitle":"Overview","href":"/api-reference/responses/overview"},{"title":"List Responses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/responses","href":"/api-reference/list-responses"}]},{"group":"Signals API","public":true,"pages":[{"title":"Signals API: Detected changes in AI visibility","sidebarTitle":"Overview","href":"/api-reference/signals/overview"},{"title":"List Signals","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/signals","href":"/api-reference/signals/list-signals"},{"title":"Get Signal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/signals/{signal_id}","href":"/api-reference/signals/get-signal"},{"title":"List Signal Anchor Dates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/signals/anchors","href":"/api-reference/signals/list-signal-anchor-dates"},{"title":"List Signal Reactions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/signals/reactions","href":"/api-reference/signals/list-signal-reactions"},{"title":"Set Signal Reaction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /{brand_id}/signals/{signal_id}/reaction","href":"/api-reference/signals/set-signal-reaction"},{"title":"Clear Signal Reaction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /{brand_id}/signals/{signal_id}/reaction","href":"/api-reference/signals/clear-signal-reaction"}]},{"group":"Agent Traffic API","public":true,"pages":[{"title":"Agent Traffic API: Monitor AI Bot Crawls","sidebarTitle":"Overview","href":"/api-reference/agent-traffic/overview"},{"title":"Get Agent Traffic","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/sites/{site_id}/agent-traffic","href":"/api-reference/agent-traffic/get-agent-traffic"},{"title":"Send Custom Agent Traffic Events","api":"POST https://webhooks.scrunchai.com/v1/sites/{site_id}/platforms/custom/web-traffic","href":"/api-reference/agent-traffic/post-custom-web-traffic"}]},{"group":"AI Referrals API","public":true,"pages":[{"title":"AI Referrals API: Send traffic from any analytics tool","sidebarTitle":"Overview","href":"/api-reference/ai-referrals/overview"},{"title":"Register AI Referrals Connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /{brand_id}/ai-referrals/connections","href":"/api-reference/ai-referrals/register-ai-referrals-connection"},{"title":"List AI Referrals Connections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/ai-referrals/connections","href":"/api-reference/ai-referrals/list-ai-referrals-connections"},{"title":"Disable AI Referrals Connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /{brand_id}/ai-referrals/connections/{connection_id}","href":"/api-reference/ai-referrals/disable-ai-referrals-connection"},{"title":"Push AI Referrals Events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /{brand_id}/ai-referrals/connections/{connection_id}/events","href":"/api-reference/ai-referrals/push-ai-referrals-events"}]},{"group":"Keyword Volume API","pages":[{"title":"Keyword Volume API: Estimate a keyword list","description":"Estimate weekly US AI prompt volume, Demand Score and Commercial Intent for up to 200 keywords at once: start a list, then read its results as they finish.","sidebarTitle":"Overview","href":"/api-reference/keyword-volume/overview"},{"title":"Start Keyword List","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /{brand_id}/keyword-volume/lists","href":"/api-reference/keyword-volume/start-keyword-list"},{"title":"Get Keyword List","description":"A keyword list's status and every keyword on it, with each finished keyword's weekly volume, Demand Score and Commercial Intent score. Poll it while the list is `queued` or `running`; every 30 seconds is plenty. Results stay readable after the list ends.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/keyword-volume/lists/{list_id}","href":"/api-reference/keyword-volume/get-keyword-list"},{"title":"Cancel Keyword List","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /{brand_id}/keyword-volume/lists/{list_id}/cancel","href":"/api-reference/keyword-volume/cancel-keyword-list"}]},{"group":"Collection API","pages":[{"title":"Create Collection Request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /{brand_id}/collections","href":"/api-reference/create-collection-request"}]}]},{"group":"Optimize","icon":"wand-magic-sparkles","pages":[{"group":"Site Optimization API","pages":[{"title":"Site Optimization API: Recommendations, by type and by page","sidebarTitle":"Overview","href":"/api-reference/site-optimization/overview"},{"title":"List Recommendation Types","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/site-optimization/recommendations/by-type","href":"/api-reference/site-optimization/list-recommendation-types"},{"title":"Get Recommendation Type Detail","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/site-optimization/recommendations/by-type/{best_practice_id}","href":"/api-reference/site-optimization/get-recommendation-type-detail"},{"title":"List Page Recommendations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/site-optimization/recommendations/by-page","href":"/api-reference/site-optimization/list-page-recommendations"},{"title":"Get Page Optimization Detail","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/site-optimization/optimization","href":"/api-reference/site-optimization/get-page-optimization-detail"},{"title":"Apply Page Optimization","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /{brand_id}/site-optimization/optimization/apply","href":"/api-reference/site-optimization/apply-page-optimization"}]},{"group":"Audit Scores API","pages":[{"title":"Audit Scores API: Retrievability and citability by page","sidebarTitle":"Overview","href":"/api-reference/audit-scores/overview"},{"title":"Get Site Audit Score","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/audit-scores/site","href":"/api-reference/audit-scores/get-site-audit-score"},{"title":"List Page Audit Scores","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/audit-scores/pages","href":"/api-reference/audit-scores/list-page-audit-scores"}]},{"group":"Crawl Readiness API","public":true,"pages":[{"title":"Crawl Readiness API: Check AI Crawler Access to a Site","sidebarTitle":"Overview","href":"/api-reference/crawl-readiness/overview"},{"title":"Get AI Crawl Readiness","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/crawl-readiness","href":"/api-reference/crawl-readiness/get-ai-crawl-readiness"}]}]},{"group":"Deliver","icon":"paper-plane","pages":[{"group":"Agent Pages","pages":[{"title":"Agent Pages Force Refresh: Update Pages on Demand","sidebarTitle":"Force Refresh overview","href":"/api-reference/agent-pages/force-refresh-overview"},{"title":"Force Refresh","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /{brand_id}/sites/{site_id}/agent-pages/refresh","href":"/api-reference/agent-pages/force-refresh"},{"title":"Agent Pages Unpublish: Stop Serving Pages on Demand","sidebarTitle":"Unpublish overview","href":"/api-reference/agent-pages/unpublish-overview"},{"title":"Unpublish","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /{brand_id}/sites/{site_id}/agent-pages/unpublish","href":"/api-reference/agent-pages/unpublish"},{"title":"Agent Pages Publish: Add Pages on Demand","sidebarTitle":"Publish overview","href":"/api-reference/agent-pages/publish-overview"},{"title":"Publish","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /{brand_id}/sites/{site_id}/agent-pages/publish","href":"/api-reference/agent-pages/publish"}]},{"group":"Curated Pages (AXP)","pages":[{"title":"AXP Unpublish API: Take Optimized Pages Off the Edge","sidebarTitle":"Unpublish overview","href":"/api-reference/axp/unpublish"},{"title":"Unpublish Optimized Pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /orchestration/unpublish/{brand_id}/sites/{site_id}","href":"/api-reference/axp-render/unpublish-optimized-pages"}]}]},{"group":"Configure","icon":"gear","pages":[{"group":"Configuration API","public":true,"pages":[{"title":"Configuration API: Manage Brands and Prompts","sidebarTitle":"Overview","href":"/api-reference/configuration/overview"},{"title":"List Brands","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /brands","href":"/api-reference/list-brands"},{"title":"List Sites","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/sites","href":"/api-reference/agent-pages/list-sites"},{"title":"Create Brand","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /brands","href":"/api-reference/create-brand"},{"title":"Update Brand","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /brands/{brand_id}","href":"/api-reference/update-brand"},{"title":"List Competitors","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /brands/{brand_id}/competitors","href":"/api-reference/list-competitors"},{"title":"Get Competitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /brands/{brand_id}/competitors/{competitor_id}","href":"/api-reference/get-competitor"},{"title":"Create Competitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /brands/{brand_id}/competitors","href":"/api-reference/create-competitor"},{"title":"Update Competitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /brands/{brand_id}/competitors/{competitor_id}","href":"/api-reference/update-competitor"},{"title":"Archive Competitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /brands/{brand_id}/competitors/{competitor_id}","href":"/api-reference/archive-competitor"},{"title":"List Personas","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /brands/{brand_id}/personas","href":"/api-reference/list-personas"},{"title":"Get Persona","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /brands/{brand_id}/personas/{persona_id}","href":"/api-reference/get-persona"},{"title":"Create Persona","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /brands/{brand_id}/personas","href":"/api-reference/create-persona"},{"title":"Update Persona","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /brands/{brand_id}/personas/{persona_id}","href":"/api-reference/update-persona"},{"title":"Archive Persona","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /brands/{brand_id}/personas/{persona_id}","href":"/api-reference/archive-persona"},{"title":"List Prompts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/prompts","href":"/api-reference/list-prompts"},{"title":"Create Prompt","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /{brand_id}/prompts","href":"/api-reference/create-prompt"},{"title":"Update Prompt Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /{brand_id}/prompts/{prompt_id}","href":"/api-reference/update-prompt-status"},{"title":"Archive Prompt","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /{brand_id}/prompts/{prompt_id}","href":"/api-reference/archive-prompt"}]},{"group":"Account API","public":true,"pages":[{"title":"Account API: Read the Subscription State of an API Key","sidebarTitle":"Overview","href":"/api-reference/account/overview"},{"title":"Get Account Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /account","href":"/api-reference/account/get-account-status"}]},{"group":"Webhooks","public":true,"pages":[{"title":"Webhooks: Pipeline Stage Completion Callbacks","sidebarTitle":"Overview","href":"/api-reference/webhooks/overview"}]}]},{"group":"Deprecated","icon":"box-archive","pages":[{"group":"Site Audit API","public":true,"tag":"Deprecated","pages":[{"title":"Site Audit API: Score pages for AI search readiness","sidebarTitle":"Overview","href":"/api-reference/site-audit/overview"},{"title":"Create Page Audits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /{brand_id}/page-audits","href":"/api-reference/create-page-audits"},{"title":"List Page Audits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/page-audits","href":"/api-reference/list-page-audits"},{"title":"Get Page Audit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/page-audits/{page_audit_id}","href":"/api-reference/get-page-audit"}]},{"group":"Sitemap API","public":true,"tag":"Deprecated","pages":[{"title":"Sitemap API: Pages, Audit Scores, AI Metrics","sidebarTitle":"Overview","href":"/api-reference/sitemap/overview"},{"title":"List Sitemap Pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/sitemap/pages","href":"/api-reference/sitemap/list-sitemap-pages"},{"title":"Get Sitemap Page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/sitemap/pages/{page_id}","href":"/api-reference/sitemap/get-sitemap-page"},{"title":"Get Sitemap Page Metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/sitemap/pages/{page_id}/metrics","href":"/api-reference/sitemap/get-sitemap-page-metrics"},{"title":"Export Sitemap Pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /{brand_id}/sitemap/export","href":"/api-reference/sitemap/export-sitemap-pages"}]},{"group":"AXP Render API","public":true,"tag":"Deprecated","pages":[{"title":"AXP Render API: Queue Optimized Page Renders","sidebarTitle":"Overview","href":"/api-reference/axp/overview"},{"title":"Bulk Render Optimized Pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /orchestration/render-bulk/{brand_id}/sites/{site_id}","href":"/api-reference/axp-render/bulk-render-optimized-pages"}]},{"group":"Optimize \u0026 Deploy API","public":true,"tag":"Deprecated","pages":[{"title":"Optimize and Deploy Pipeline API Overview","sidebarTitle":"Overview","href":"/api-reference/orchestration/overview"},{"title":"Create Optimize And Deploy Pipeline","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /orchestration/optimize-and-deploy/{brand_id}","href":"/api-reference/orchestration/create-optimize-and-deploy-pipeline"},{"title":"Get Pipeline Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /orchestration/optimize-and-deploy/{brand_id}/{token}","href":"/api-reference/orchestration/get-pipeline-status"}]}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]}]},"basePath":"","title":"Start Keyword List - Scrunch API Docs","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}