HTTP 409: API key limit reached. Retrying the same request gives the same error. Errors never cost API credits.A workspace has at most 25 active API keys. A rotated key in its 24-hour grace period does not count.What to do: Revoke a key you no longer use; a workspace has at most 25 active keys.
Response
{ "type": "https://docs.alura.io/errors/key_limit_reached", "title": "API key limit reached", "status": 409, "code": "key_limit_reached", "detail": "API key limit reached", "suggestion": "Revoke a key you no longer use; a workspace has at most 25 active keys.", "retryable": false, "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"}
The response is application/problem+json (RFC 9457) and has a Request-Id header with the same request_id. See all errors.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Alura API","description":"Etsy market research for scripts and AI assistants: products, shops, keywords and saved research.","colors":{"primary":"#155EEF","light":"#528BFF","dark":"#004EEB"},"logo":{"light":"https://mintcdn.com/alura/HySS5CT36sWBL9EL/logo/light.svg?fit=max\u0026auto=format\u0026n=HySS5CT36sWBL9EL\u0026q=85\u0026s=6afcc5174d02ee0af4c233126964240a","dark":"https://mintcdn.com/alura/HySS5CT36sWBL9EL/logo/dark.svg?fit=max\u0026auto=format\u0026n=HySS5CT36sWBL9EL\u0026q=85\u0026s=0babd9724a17bbf017bb0d29d0943900","href":"https://alura.io"},"favicon":"https://mintcdn.com/alura/HySS5CT36sWBL9EL/favicon.svg?fit=max\u0026auto=format\u0026n=HySS5CT36sWBL9EL\u0026q=85\u0026s=4a49d66ca34eb4e2b084d778927ed570","api":{"playground":{"display":"none","proxy":false},"examples":{"languages":["curl","typescript","python"]}},"background":{"color":{"light":"#FFFFFF","dark":"#171717"}},"navbar":{"links":[{"href":"/status","label":"Status"}],"primary":{"type":"button","label":"Get an API key","href":"https://platform.alura.io/settings"}},"footer":{"socials":{"website":"https://alura.io"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"alura","hasAudioNarration":false,"actualSubdomain":"alura","customDomains":["docs.alura.io"],"gitSource":{"type":"github","owner":"pixell-co","repo":"alura-public-api","deployBranch":"main","contentDirectory":"apps/docs/content","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ad38ac82afd258e640a2c23","collectionId":"4328c41b-00d5-4504-b4d9-36ccf63eb92c","liveDeploymentHistoryId":"6ad38ac82afd258e640a2c23","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ad38ac82afd258e640a2c23","clientVersion":"0.0.3880","searchFilterCounts":[{"language":"default","tag":"API reference","count":52},{"language":"default","tag":"Research","count":35},{"language":"default","tag":"Documentation","count":19},{"language":"default","tag":"Saved","count":13},{"language":"default","tag":"Overview","count":8},{"language":"default","tag":"MCP","count":8},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"Products","count":7},{"language":"default","tag":"Account","count":6},{"language":"default","tag":"Keywords","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"editor-branches-v2-autocommit","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-branches-v2","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":"teamspace","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":"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":"revalidation-jwt","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":"client-snapshot-docs-config","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"a[href=\"https://platform.alura.io/settings\"]:not(.link){background-color:transparent!important}a[href=\"https://platform.alura.io/settings\"]:not(.link)>span:first-child,html.dark a[href=\"https://platform.alura.io/settings\"]:not(.link)>span:first-child{background-color:#155eef!important}a[href=\"https://platform.alura.io/settings\"]:not(.link),a[href=\"https://platform.alura.io/settings\"]:not(.link) *{color:#fff!important}a[href=\"https://platform.alura.io/settings\"]:not(.link):hover>span:first-child{background-color:#004eeb!important}a[href=\"https://platform.alura.io/settings\"][target=_blank]:not(.link) svg{display:none!important}#search-bar-entry,#search-bar-entry-mobile,.sidebar-group a,a[href=\"https://platform.alura.io/settings\"]:not(.link),a[href=\"https://platform.alura.io/settings\"]:not(.link)>span:first-child,button:not([role=switch]):not([role=tab]){border-radius:9999px!important}#page-context-menu-button{border-radius:.75rem 0 0 .75rem!important}#page-context-menu-button+button{border-radius:0 .75rem .75rem 0!important}#topbar-cta-button>a{padding:.375rem .875rem!important;font-size:.8125rem!important}[data-component-part=update-description],[data-component-part=update-tag]{font-size:.75rem;line-height:1.25rem}[data-component-part=update-tag-list]{flex-direction:column;gap:.25rem}[data-component-part=update-tag]{opacity:.7}[data-component-part=update-content]>h2:first-child{margin-top:0;font-size:1.5rem;line-height:2rem}[data-component-part=update-content] h3{font-size:1rem;margin-top:1.75rem}"}],"page":{"pagePath":"errors/key_limit_reached","slug":"/errors/key_limit_reached","pageMetadata":{"title":"key_limit_reached","description":"API key limit reached. HTTP 409, not retryable.","href":"/errors/key_limit_reached"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"API key limit reached. HTTP 409, not retryable.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`HTTP 409: API key limit reached.`}),` Retrying the same request gives the same error. Errors never cost API credits.`]}),`\n`,_jsx(_components.p,{children:`A workspace has at most 25 active API keys. A rotated key in its 24-hour grace period does not count.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What to do:`}),` Revoke a key you no longer use; a workspace has at most 25 active keys.`]}),`\n`,_jsx(CodeBlock,{filename:`Response`,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://docs.alura.io/errors/key_limit_reached\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"API key limit reached\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`409`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"key_limit_reached\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"detail\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"API key limit reached\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"suggestion\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Revoke a key you no longer use; a workspace has at most 25 active keys.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"retryable\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The response is `,_jsx(_components.code,{children:`application/problem+json`}),` (RFC 9457) and has a `,_jsx(_components.code,{children:`Request-Id`}),` header with the same `,_jsx(_components.code,{children:`request_id`}),`. See `,_jsx(_components.a,{href:`/api-reference/errors`,children:`all errors`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"key_limit_reached","description":"API key limit reached. HTTP 409, not retryable.","href":"/errors/key_limit_reached"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"alura","siteName":"Alura API","title":"key_limit_reached - Alura API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-16T16:48:51.886Z","originalFileLocation":"errors/key_limit_reached.mdx"},"headHtml":"\u003cmeta data-mint-head name=\"description\" content=\"API key limit reached. HTTP 409, not retryable.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Alura API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/alura/Zo6rWRwbAxOIKIxc/_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/alura/Zo6rWRwbAxOIKIxc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/alura/Zo6rWRwbAxOIKIxc/_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/alura/Zo6rWRwbAxOIKIxc/_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/alura/Zo6rWRwbAxOIKIxc/_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/alura/Zo6rWRwbAxOIKIxc/_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/alura/Zo6rWRwbAxOIKIxc/_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/alura/Zo6rWRwbAxOIKIxc/_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/alura/Zo6rWRwbAxOIKIxc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"key_limit_reached - Alura API\">\u003cmeta data-mint-head property=\"og:description\" content=\"API key limit reached. HTTP 409, not retryable.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Alura API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.alura.io/errors/key_limit_reached\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"key_limit_reached - Alura API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"API key limit reached. HTTP 409, not retryable.\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/alura/Zo6rWRwbAxOIKIxc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Alura API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#155EEF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.alura.io/errors/key_limit_reached\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/errors/key_limit_reached.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Alura API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Alura API","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Get started","pages":[{"title":"Alura API","href":""},{"title":"Quickstart","href":"/quickstart"}]},{"group":"Guides","pages":[{"title":"Find products","href":"/guides/find-products"},{"title":"Analyze a shop","href":"/guides/analyze-a-shop"},{"title":"Keyword research","href":"/guides/keyword-research"},{"title":"Bulk lookups","href":"/guides/bulk-lookups"},{"title":"Look up Etsy links","href":"/guides/look-up-etsy-links"},{"title":"Sales history","href":"/guides/sales-history"},{"title":"Usage and limits","href":"/guides/usage-and-limits"},{"title":"Handling errors","href":"/guides/handling-errors"}]},{"group":"Research features","pages":[{"title":"Trending","href":"/features/trending"},{"title":"Saved research","href":"/features/saved-research"}]},{"group":"Methodology","pages":[{"title":"Methodology","href":"/methodology"},{"title":"Sales estimates","version":"2026-10","href":"/methodology/sales-estimates"},{"title":"Sales trend","version":"2026-10","href":"/methodology/sales-trend"},{"title":"Keyword market","version":"2026-10","href":"/methodology/keyword-market"}]},{"group":"Resources","pages":[{"title":"Status","href":"/status"}]},{"group":"Legal","pages":[{"title":"API terms of use","href":"/legal/api-terms"},{"title":"Privacy policy: API and MCP addendum","href":"/legal/privacy-api"}]}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"API credits","href":"/api-reference/api-credits"},{"title":"Pagination","href":"/api-reference/pagination"},{"title":"Rate and fetch limits","href":"/api-reference/rate-limits"},{"title":"Errors","href":"/api-reference/errors"},{"title":"Freshness and pending","href":"/api-reference/freshness"},{"title":"Changelog","href":"/api-reference/changelog"}]},{"group":"Research","pages":[{"group":"Products","pages":[{"title":"Search products","deprecated":null,"version":null,"sidebarTitle":"Search products","openapi":"/openapi.json get /v1/research/products","href":"/api-reference/research/products/search"},{"title":"Get a product","deprecated":null,"version":null,"sidebarTitle":"Get a product","openapi":"/openapi.json get /v1/research/products/{id}","href":"/api-reference/research/products/get"},{"title":"Get products by ID","openapi":"openapi-variants.json GET /v1/research/products","href":"/api-reference/research/products/getMany"},{"title":"Find similar products","deprecated":null,"version":null,"sidebarTitle":"Find similar products","openapi":"/openapi.json get /v1/research/products/{id}/similar","href":"/api-reference/research/products/similar"},{"title":"Get a product's sales history","deprecated":null,"version":null,"sidebarTitle":"Get a product's sales history","openapi":"/openapi.json get /v1/research/products/{id}/history","href":"/api-reference/research/products/history"},{"title":"List a product's reviews","deprecated":null,"version":null,"sidebarTitle":"List a product's reviews","openapi":"/openapi.json get /v1/research/products/{id}/reviews","href":"/api-reference/research/products/reviews"},{"title":"Get a product's tags","deprecated":null,"version":null,"sidebarTitle":"Get a product's tags","openapi":"/openapi.json get /v1/research/products/{id}/tags","href":"/api-reference/research/products/tags"}]},{"group":"Shops","pages":[{"title":"Search shops","deprecated":null,"version":null,"sidebarTitle":"Search shops","openapi":"/openapi.json get /v1/research/shops","href":"/api-reference/research/shops/search"},{"title":"Get a shop","deprecated":null,"version":null,"sidebarTitle":"Get a shop","openapi":"/openapi.json get /v1/research/shops/{id}","href":"/api-reference/research/shops/get"},{"title":"List a shop's products","deprecated":null,"version":null,"sidebarTitle":"List a shop's products","openapi":"/openapi.json get /v1/research/shops/{id}/products","href":"/api-reference/research/shops/products"},{"title":"List a shop's reviews","deprecated":null,"version":null,"sidebarTitle":"List a shop's reviews","openapi":"/openapi.json get /v1/research/shops/{id}/reviews","href":"/api-reference/research/shops/reviews"},{"title":"Get a shop's sales history","deprecated":null,"version":null,"sidebarTitle":"Get a shop's sales history","openapi":"/openapi.json get /v1/research/shops/{id}/history","href":"/api-reference/research/shops/history"}]},{"group":"Keywords","pages":[{"title":"Look up keywords","deprecated":null,"version":null,"sidebarTitle":"Look up keywords","openapi":"/openapi.json get /v1/research/keywords","href":"/api-reference/research/keywords/lookup"},{"title":"Get a keyword","deprecated":null,"version":null,"sidebarTitle":"Get a keyword","openapi":"/openapi.json get /v1/research/keywords/{id}","href":"/api-reference/research/keywords/get"},{"title":"Get related keywords","deprecated":null,"version":null,"sidebarTitle":"Get related keywords","openapi":"/openapi.json get /v1/research/keywords/{id}/related","href":"/api-reference/research/keywords/related"},{"title":"Get a keyword's top products","deprecated":null,"version":null,"sidebarTitle":"Get a keyword's top products","openapi":"/openapi.json get /v1/research/keywords/{id}/products","href":"/api-reference/research/keywords/products"},{"title":"Get a keyword's top shops","deprecated":null,"version":null,"sidebarTitle":"Get a keyword's top shops","openapi":"/openapi.json get /v1/research/keywords/{id}/shops","href":"/api-reference/research/keywords/shops"},{"title":"Get a keyword's search history","deprecated":null,"version":null,"sidebarTitle":"Get a keyword's search history","openapi":"/openapi.json get /v1/research/keywords/{id}/history","href":"/api-reference/research/keywords/history"}]},{"group":"Trending","pages":[{"title":"Get trending products","deprecated":null,"version":null,"sidebarTitle":"Get trending products","openapi":"/openapi.json get /v1/research/products/trending","href":"/api-reference/research/products/trending"},{"title":"Get trending shops","deprecated":null,"version":null,"sidebarTitle":"Get trending shops","openapi":"/openapi.json get /v1/research/shops/trending","href":"/api-reference/research/shops/trending"},{"title":"Get trending keywords","deprecated":null,"version":null,"sidebarTitle":"Get trending keywords","openapi":"/openapi.json get /v1/research/keywords/trending","href":"/api-reference/research/keywords/trending"}]},{"group":"Lookup","pages":[{"title":"Look up an Etsy URL or shop name","deprecated":null,"version":null,"sidebarTitle":"Look up an Etsy URL or shop name","openapi":"/openapi.json get /v1/research/lookup","href":"/api-reference/research/lookup"}]},{"group":"Saved","pages":[{"group":"Folders","pages":[{"title":"List saved folders","deprecated":null,"version":null,"sidebarTitle":"List saved folders","openapi":"/openapi.json get /v1/research/saved/folders","href":"/api-reference/research/saved/folders/list"},{"title":"Create a saved folder","deprecated":null,"version":null,"sidebarTitle":"Create a saved folder","openapi":"/openapi.json post /v1/research/saved/folders","href":"/api-reference/research/saved/folders/create"},{"title":"Get a saved folder","deprecated":null,"version":null,"sidebarTitle":"Get a saved folder","openapi":"/openapi.json get /v1/research/saved/folders/{id}","href":"/api-reference/research/saved/folders/get"},{"title":"Update a saved folder","deprecated":null,"version":null,"sidebarTitle":"Update a saved folder","openapi":"/openapi.json patch /v1/research/saved/folders/{id}","href":"/api-reference/research/saved/folders/update"},{"title":"Delete a saved folder","deprecated":null,"version":null,"sidebarTitle":"Delete a saved folder","openapi":"/openapi.json delete /v1/research/saved/folders/{id}","href":"/api-reference/research/saved/folders/delete"}]},{"group":"Lists","pages":[{"title":"List saved lists","deprecated":null,"version":null,"sidebarTitle":"List saved lists","openapi":"/openapi.json get /v1/research/saved/lists","href":"/api-reference/research/saved/lists/list"},{"title":"Create a saved list","deprecated":null,"version":null,"sidebarTitle":"Create a saved list","openapi":"/openapi.json post /v1/research/saved/lists","href":"/api-reference/research/saved/lists/create"},{"title":"Get a saved list","deprecated":null,"version":null,"sidebarTitle":"Get a saved list","openapi":"/openapi.json get /v1/research/saved/lists/{id}","href":"/api-reference/research/saved/lists/get"},{"title":"Update a saved list","deprecated":null,"version":null,"sidebarTitle":"Update a saved list","openapi":"/openapi.json patch /v1/research/saved/lists/{id}","href":"/api-reference/research/saved/lists/update"},{"title":"Delete a saved list","deprecated":null,"version":null,"sidebarTitle":"Delete a saved list","openapi":"/openapi.json delete /v1/research/saved/lists/{id}","href":"/api-reference/research/saved/lists/delete"}]},{"group":"Items","pages":[{"title":"List saved items","deprecated":null,"version":null,"sidebarTitle":"List saved items","openapi":"/openapi.json get /v1/research/saved/lists/{id}/items","href":"/api-reference/research/saved/items/list"},{"title":"Add saved items","deprecated":null,"version":null,"sidebarTitle":"Add saved items","openapi":"/openapi.json post /v1/research/saved/lists/{id}/items","href":"/api-reference/research/saved/items/add"},{"title":"Remove saved items","deprecated":null,"version":null,"sidebarTitle":"Remove saved items","openapi":"/openapi.json delete /v1/research/saved/lists/{id}/items","href":"/api-reference/research/saved/items/remove"}]}]}]},{"group":"Reference data","pages":[{"group":"Categories","pages":[{"title":"Search categories","deprecated":null,"version":null,"sidebarTitle":"Search categories","openapi":"/openapi.json get /v1/categories","href":"/api-reference/reference/categories/search"},{"title":"Get a category","deprecated":null,"version":null,"sidebarTitle":"Get a category","openapi":"/openapi.json get /v1/categories/{id}","href":"/api-reference/reference/categories/get"}]},{"group":"Languages","pages":[{"title":"List languages","deprecated":null,"version":null,"sidebarTitle":"List languages","openapi":"/openapi.json get /v1/languages","href":"/api-reference/reference/languages/list"}]}]},{"group":"Account","pages":[{"group":"Me","pages":[{"title":"Get the current user","deprecated":null,"version":null,"sidebarTitle":"Get the current user","openapi":"/openapi.json get /v1/me","href":"/api-reference/account/me/get"}]},{"group":"Workspaces","pages":[{"title":"List workspaces","deprecated":null,"version":null,"sidebarTitle":"List workspaces","openapi":"/openapi.json get /v1/me/workspaces","href":"/api-reference/account/workspaces/list"},{"title":"Switch workspace","deprecated":null,"version":null,"sidebarTitle":"Switch workspace","openapi":"/openapi.json post /v1/me/workspace","href":"/api-reference/account/workspace/switch"}]},{"group":"Usage","pages":[{"title":"Get usage","deprecated":null,"version":null,"sidebarTitle":"Get usage","openapi":"/openapi.json get /v1/usage","href":"/api-reference/account/usage/get"},{"title":"Get usage by day","deprecated":null,"version":null,"sidebarTitle":"Get usage by day","openapi":"/openapi.json get /v1/usage/by-day","href":"/api-reference/account/usage/byday"},{"title":"List usage events","deprecated":null,"version":null,"sidebarTitle":"List usage events","openapi":"/openapi.json get /v1/usage/events","href":"/api-reference/account/usage/events"}]}]}]},{"tab":"MCP","groups":[{"group":"Get started","pages":[{"title":"Connect an AI assistant","href":"/connect-ai"},{"title":"API credits over MCP","href":"/mcp/credits"},{"title":"Troubleshooting","href":"/mcp/troubleshooting"}]},{"group":"Tools","pages":[{"title":"Tools","sidebarTitle":"Overview","href":"/mcp/tools"},{"title":"Products and shops","href":"/mcp/tools/products-and-shops"},{"title":"Keywords and trends","href":"/mcp/tools/keywords"},{"title":"Saved research","href":"/mcp/tools/saved-research"},{"title":"Usage and workspaces","href":"/mcp/tools/account"}]}]}]},"title":"key_limit_reached - Alura API","buildId":"dpl_8yzRtH9eErzJnpfBBed2uBNYhAmY","deploymentId":"dpl_8yzRtH9eErzJnpfBBed2uBNYhAmY","dynamics":[],"chunks":[]}