HTTP 422: Unprocessable. Retrying the same request gives the same error. Errors never cost API credits.The request is well formed but cannot be applied, for example adding an item Alura does not have to a saved list. The detail names the item.What to do: Fix the request as the detail says.
Response
{ "type": "https://docs.alura.io/errors/unprocessable", "title": "Unprocessable", "status": 422, "code": "unprocessable", "detail": "Unprocessable", "suggestion": "Fix the request as the detail says.", "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/unprocessable","slug":"/errors/unprocessable","pageMetadata":{"title":"unprocessable","description":"Unprocessable. HTTP 422, not retryable.","href":"/errors/unprocessable"},"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: \"Unprocessable. HTTP 422, 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 422: Unprocessable.`}),` Retrying the same request gives the same error. Errors never cost API credits.`]}),`\n`,_jsxs(_components.p,{children:[`The request is well formed but cannot be applied, for example adding an item Alura does not have to a saved list. The `,_jsx(_components.code,{children:`detail`}),` names the item.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What to do:`}),` Fix the request as the detail says.`]}),`\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/unprocessable\"`}),_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:`\"Unprocessable\"`}),_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:`422`}),_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:`\"unprocessable\"`}),_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:`\"Unprocessable\"`}),_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:`\"Fix the request as the detail says.\"`}),_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":"unprocessable","description":"Unprocessable. HTTP 422, not retryable.","href":"/errors/unprocessable"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"alura","siteName":"Alura API","title":"unprocessable - Alura API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-16T16:48:51.864Z","originalFileLocation":"errors/unprocessable.mdx"},"headHtml":"\u003cmeta data-mint-head name=\"description\" content=\"Unprocessable. HTTP 422, 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=\"unprocessable - Alura API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Unprocessable. HTTP 422, 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/unprocessable\">\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=\"unprocessable - Alura API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Unprocessable. HTTP 422, 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/unprocessable\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/errors/unprocessable.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":"unprocessable - Alura API","buildId":"dpl_8yzRtH9eErzJnpfBBed2uBNYhAmY","deploymentId":"dpl_8yzRtH9eErzJnpfBBed2uBNYhAmY","dynamics":[],"chunks":[]}