import json
import os
import urllib.request
request = urllib.request.Request(
"https://api.alura.io/v1/etsy/news/us-entry-type-13-postal",
headers={
"Authorization": f"Bearer {os.environ['ALURA_API_KEY']}",
},
)
with urllib.request.urlopen(request) as response:
print(json.load(response))
{
"object": "etsy.news_article",
"id": "us-entry-type-13-postal",
"slug": "us-entry-type-13-postal",
"title": "US requires Entry Type 13 customs filing for postal parcels worth $2,500 or less from January 20, 2027",
"dek": "From January 20, 2027, sellers outside the US who post orders to US buyers need shipment-level customs data on each parcel, or it may be held or returned.",
"url": "https://www.alura.io/news/us-entry-type-13-postal",
"published_at": "2026-10-19",
"created_at": "2026-10-22T09:00:00.000Z",
"updated_at": "2026-10-22T09:00:00.000Z",
"topics": [
"shipping",
"policies"
],
"update_ids": [
"2026-10-19-us-entry-type-13"
],
"author": "Alura",
"body": "Starting January 20, 2027, international postal packages valued at $2,500 USD or less that enter the US \"must be filed electronically\" in US Customs and Border Protection's ACE system. Etsy [announced the change on October 19, 2026](https://community.etsy.com/forum/announcements-290/topic/new-us-customs-postal-entry-requirements-for-international-sellers-190423/). The filing goes through a new process called Entry Type 13. Each entry needs shipment-level customs data, plus any information or documents that US agencies such as the FDA or CPSC require. Your postal carrier collects it.\n\n## Who it affects\n\nEtsy's post is addressed to sellers who ship to US buyers from outside the US. The rule covers postal shipments only. Etsy says express carriers like FedEx, UPS and DHL \"already collect this information.\"\n\nThe agency rules reach many product types. Etsy's examples are food, supplements, candles, toys, children's clothing, certain jewelry, and items with animal materials (feathers, shells, bone, leather) or plant materials (wood, cork, botanicals). Products applied to the skin are also on the list. Depending on what you sell, you may need extra documents such as compliance certificates. Etsy says: \"You'll need to determine if the items you sell are affected.\"\n\n## What it means\n\nAfter January 20, 2027, a parcel posted without the required data can stop at the border. Etsy's wording: \"If required customs information isn't provided, your package may be held or returned.\"\n\nFor children's products and other CPSC-regulated goods, this builds on a rule already in force. Etsy's [Help Center](https://help.etsy.com/hc/en-us/articles/41840762260759) says that from July 8, 2026, importers of certain consumer products must submit safety certificate information electronically. Children's products need a Children's Product Certificate. For goods sent by postal mail, Etsy says using the CPSC Product Registry \"is required.\" The Registry issues a reference ID that you include with the shipment's customs information.\n\nEtsy hasn't put a price on any of this. The post mentions no Etsy fee.\n\n## What to do\n\n- List which of your products fall into the categories above, and gather any certificates you hold for them.\n- Etsy recommends connecting your shop to a free Zonos Verified Account to check whether items can ship to the US or need more documents. To connect, Etsy says to go to the Channels page in the Zonos Dashboard, select Add channel, choose Etsy, then select Connect and approve Zonos' request to access your orders and catalog. Zonos is a separate company, and Etsy notes that your use of it \"is governed by the applicable Zonos terms.\"\n- If you post CPSC-regulated items, register them in the CPSC Product Registry now. Etsy's Help Center already lists it as required for postal imports under the eFiling rule.\n- Ask your postal carrier what data it will need from you and how you will submit it.\n\n## What we don't know yet\n\nEtsy hasn't said which data fields postal carriers will ask for. It also hasn't said whether shipping labels bought on Etsy will pass the data automatically, or what happens to parcels already in transit on January 20, 2027. Etsy says it is \"monitoring developments leading up to the January compliance date\" and will update its post as it learns more.",
"sources": [
{
"url": "https://community.etsy.com/forum/announcements-290/topic/new-us-customs-postal-entry-requirements-for-international-sellers-190423/",
"title": "New US customs postal entry requirements for international sellers",
"publisher": "Etsy",
"published_at": "2026-10-19",
"read_at": null
},
{
"url": "https://help.etsy.com/hc/en-us/articles/41840762260759",
"title": "How to Comply with US CPSC eFiling Requirements",
"publisher": "Etsy",
"published_at": "2026-07-09",
"read_at": null
}
],
"corrections": []
}
{
"type": "https://docs.alura.io/errors/invalid_request",
"title": "Invalid request",
"status": 400,
"code": "invalid_request",
"detail": "Invalid request",
"suggestion": "Fix the request as the detail says, then send it again.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}
{
"type": "https://docs.alura.io/errors/unauthorized",
"title": "Unauthorized",
"status": 401,
"code": "unauthorized",
"detail": "Unauthorized",
"suggestion": "Send a valid API key as `Authorization: Bearer alura_sk_...`.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}
{
"type": "https://docs.alura.io/errors/credits_exhausted",
"title": "API credits exhausted",
"status": 402,
"code": "credits_exhausted",
"detail": "API credits exhausted",
"suggestion": "Upgrade the plan or wait for the monthly reset.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}
{
"type": "https://docs.alura.io/errors/plan_required",
"title": "Plan required",
"status": 403,
"code": "plan_required",
"detail": "Plan required",
"suggestion": "Upgrade the workspace plan to use this operation.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}
{
"type": "https://docs.alura.io/errors/not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "Not found",
"suggestion": "Check the ID, or search for it first.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}
{
"type": "https://docs.alura.io/errors/method_not_allowed",
"title": "Method not allowed",
"status": 405,
"code": "method_not_allowed",
"detail": "Method not allowed",
"suggestion": "Use one of the methods in the Allow header.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}
import json
import os
import urllib.request
request = urllib.request.Request(
"https://api.alura.io/v1/etsy/news/us-entry-type-13-postal",
headers={
"Authorization": f"Bearer {os.environ['ALURA_API_KEY']}",
},
)
with urllib.request.urlopen(request) as response:
print(json.load(response))
{
"object": "etsy.news_article",
"id": "us-entry-type-13-postal",
"slug": "us-entry-type-13-postal",
"title": "US requires Entry Type 13 customs filing for postal parcels worth $2,500 or less from January 20, 2027",
"dek": "From January 20, 2027, sellers outside the US who post orders to US buyers need shipment-level customs data on each parcel, or it may be held or returned.",
"url": "https://www.alura.io/news/us-entry-type-13-postal",
"published_at": "2026-10-19",
"created_at": "2026-10-22T09:00:00.000Z",
"updated_at": "2026-10-22T09:00:00.000Z",
"topics": [
"shipping",
"policies"
],
"update_ids": [
"2026-10-19-us-entry-type-13"
],
"author": "Alura",
"body": "Starting January 20, 2027, international postal packages valued at $2,500 USD or less that enter the US \"must be filed electronically\" in US Customs and Border Protection's ACE system. Etsy [announced the change on October 19, 2026](https://community.etsy.com/forum/announcements-290/topic/new-us-customs-postal-entry-requirements-for-international-sellers-190423/). The filing goes through a new process called Entry Type 13. Each entry needs shipment-level customs data, plus any information or documents that US agencies such as the FDA or CPSC require. Your postal carrier collects it.\n\n## Who it affects\n\nEtsy's post is addressed to sellers who ship to US buyers from outside the US. The rule covers postal shipments only. Etsy says express carriers like FedEx, UPS and DHL \"already collect this information.\"\n\nThe agency rules reach many product types. Etsy's examples are food, supplements, candles, toys, children's clothing, certain jewelry, and items with animal materials (feathers, shells, bone, leather) or plant materials (wood, cork, botanicals). Products applied to the skin are also on the list. Depending on what you sell, you may need extra documents such as compliance certificates. Etsy says: \"You'll need to determine if the items you sell are affected.\"\n\n## What it means\n\nAfter January 20, 2027, a parcel posted without the required data can stop at the border. Etsy's wording: \"If required customs information isn't provided, your package may be held or returned.\"\n\nFor children's products and other CPSC-regulated goods, this builds on a rule already in force. Etsy's [Help Center](https://help.etsy.com/hc/en-us/articles/41840762260759) says that from July 8, 2026, importers of certain consumer products must submit safety certificate information electronically. Children's products need a Children's Product Certificate. For goods sent by postal mail, Etsy says using the CPSC Product Registry \"is required.\" The Registry issues a reference ID that you include with the shipment's customs information.\n\nEtsy hasn't put a price on any of this. The post mentions no Etsy fee.\n\n## What to do\n\n- List which of your products fall into the categories above, and gather any certificates you hold for them.\n- Etsy recommends connecting your shop to a free Zonos Verified Account to check whether items can ship to the US or need more documents. To connect, Etsy says to go to the Channels page in the Zonos Dashboard, select Add channel, choose Etsy, then select Connect and approve Zonos' request to access your orders and catalog. Zonos is a separate company, and Etsy notes that your use of it \"is governed by the applicable Zonos terms.\"\n- If you post CPSC-regulated items, register them in the CPSC Product Registry now. Etsy's Help Center already lists it as required for postal imports under the eFiling rule.\n- Ask your postal carrier what data it will need from you and how you will submit it.\n\n## What we don't know yet\n\nEtsy hasn't said which data fields postal carriers will ask for. It also hasn't said whether shipping labels bought on Etsy will pass the data automatically, or what happens to parcels already in transit on January 20, 2027. Etsy says it is \"monitoring developments leading up to the January compliance date\" and will update its post as it learns more.",
"sources": [
{
"url": "https://community.etsy.com/forum/announcements-290/topic/new-us-customs-postal-entry-requirements-for-international-sellers-190423/",
"title": "New US customs postal entry requirements for international sellers",
"publisher": "Etsy",
"published_at": "2026-10-19",
"read_at": null
},
{
"url": "https://help.etsy.com/hc/en-us/articles/41840762260759",
"title": "How to Comply with US CPSC eFiling Requirements",
"publisher": "Etsy",
"published_at": "2026-07-09",
"read_at": null
}
],
"corrections": []
}
{
"type": "https://docs.alura.io/errors/invalid_request",
"title": "Invalid request",
"status": 400,
"code": "invalid_request",
"detail": "Invalid request",
"suggestion": "Fix the request as the detail says, then send it again.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}
{
"type": "https://docs.alura.io/errors/unauthorized",
"title": "Unauthorized",
"status": 401,
"code": "unauthorized",
"detail": "Unauthorized",
"suggestion": "Send a valid API key as `Authorization: Bearer alura_sk_...`.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}
{
"type": "https://docs.alura.io/errors/credits_exhausted",
"title": "API credits exhausted",
"status": 402,
"code": "credits_exhausted",
"detail": "API credits exhausted",
"suggestion": "Upgrade the plan or wait for the monthly reset.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}
{
"type": "https://docs.alura.io/errors/plan_required",
"title": "Plan required",
"status": 403,
"code": "plan_required",
"detail": "Plan required",
"suggestion": "Upgrade the workspace plan to use this operation.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}
{
"type": "https://docs.alura.io/errors/not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "Not found",
"suggestion": "Check the ID, or search for it first.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}
{
"type": "https://docs.alura.io/errors/method_not_allowed",
"title": "Method not allowed",
"status": 405,
"code": "method_not_allowed",
"detail": "Method not allowed",
"suggestion": "Use one of the methods in the Allow header.",
"retryable": false,
"request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}
body is the story in markdown, 250 to 600 words: what changed, who it affects, what it costs, what to do and what isn’t known yet. url is the article’s page on alura.io.
published_at is the story’s date: the day Etsy announced the change. created_at is when Alura published the article, which can be much later for an older change.
corrections lists every correction made after publishing, oldest first. A correction moves updated_at.
update_ids are the Etsy updates the article explains, the main one first.
Every correction made after publishing, oldest first; empty when there was none.
Maximum array length: 20
Show child attributes
{"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":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aef4f3f4f6351e51850c94d","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API reference","count":141},{"language":"default","tag":"Your shop","count":76},{"language":"default","tag":"Research","count":37},{"language":"default","tag":"Documentation","count":34},{"language":"default","tag":"Shop","count":34},{"language":"default","tag":"Listings","count":22},{"language":"default","tag":"Etsy","count":16},{"language":"default","tag":"Saved","count":14},{"language":"default","tag":"Shipping profiles","count":13},{"language":"default","tag":"Webhooks \u0026 events","count":12}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":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:#FFFFFF!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}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\"]),.sidebar-group a,#search-bar-entry,#search-bar-entry-mobile{border-radius:9999px!important}#page-context-menu-button{border-radius:0.75rem 0 0 0.75rem!important}#page-context-menu-button+button{border-radius:0 0.75rem 0.75rem 0!important}#topbar-cta-button>a{padding:0.375rem 0.875rem!important;font-size:0.8125rem!important}[data-component-part=\"update-tag\"],[data-component-part=\"update-description\"]{font-size:0.75rem;line-height:1.25rem}[data-component-part=\"update-tag-list\"]{flex-direction:column;gap:0.25rem}[data-component-part=\"update-tag\"]{opacity:0.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":"api-reference/etsy/news/get","slug":"/api-reference/etsy/news/get","pageMetadata":{"title":"Get article","description":"Get one Etsy News article by its slug: the whole story in markdown, with Etsy's pages as sources and every correction made after publishing.","deprecated":null,"version":null,"sidebarTitle":"Get article","openapi":"/openapi.json get /v1/etsy/news/{slug}","href":"/api-reference/etsy/news/get","autogeneratedByOpenApi":true},"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: \"Get one Etsy News article by its slug: the whole story in markdown, with Etsy’s pages as sources and every correction made after publishing.\"\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`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cost:`}),` Free.`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.alura.io/v1/etsy/news/us-entry-type-13-postal\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$ALURA_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`body`}),` is the story in markdown, 250 to 600 words: what changed, who it affects, what it costs, what to do and what isn’t known yet. `,_jsx(_components.code,{children:`url`}),` is the article’s page on alura.io.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`published_at`}),` is the story’s date: the day Etsy announced the change. `,_jsx(_components.code,{children:`created_at`}),` is when Alura published the article, which can be much later for an older change.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`corrections`}),` lists every correction made after publishing, oldest first. A correction moves `,_jsx(_components.code,{children:`updated_at`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`update_ids`}),` are the `,_jsx(_components.a,{href:`/api-reference/etsy/updates/get`,children:`Etsy updates`}),` the article explains, the main one first.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`To find articles, use `,_jsx(_components.a,{href:`/api-reference/etsy/news/list`,children:`List news`}),`.`]})]})}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":"Get article","description":"Get one Etsy News article by its slug: the whole story in markdown, with Etsy's pages as sources and every correction made after publishing.","deprecated":null,"version":null,"sidebarTitle":"Get article","openapi":"/openapi.json get /v1/etsy/news/{slug}","href":"/api-reference/etsy/news/get","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"etsy.news.get","summary":"Get article","description":"Get one Etsy News article by its slug: the whole story in markdown, with Etsy's pages as sources and every correction made after publishing.","parameters":["4c3f88c2-094e-4e1a-855c-dd56afc9eb94","c1e5bccc-2291-4522-b70f-a2ce52a5cb04"],"responses":{"200":"00a2bb48-dccc-4a37-9331-8751cce5e2f0","400":"2f3b0ec1-ec02-456d-98df-e761ee1a9eab","401":"3eab1548-133c-4796-8d24-c04efb0865ac","402":"c4e05f82-cc6a-44b1-840d-e6dbf3e957e4","403":"c75edec8-3656-4787-a360-9060b6eecbc9","404":"afc63dc5-6831-4f65-afb5-6a9590d7c3c1","405":"a8a69497-55c6-4608-a236-a0c7340c73d3","429":"9de14297-13c1-429c-9d8e-3a6a26abff30","500":"19bdd722-9bb0-4852-b3ac-6af2af21e525","503":"f5d8251c-0155-4535-b640-b2b51169db1d"},"x-alura-credits":{"credits":0,"unit":"call"},"x-alura-scopes":["research:read"],"x-codeSamples":[{"lang":"bash","label":"cURL","source":"curl \"https://api.alura.io/v1/etsy/news/us-entry-type-13-postal\" \\\n -H \"Authorization: Bearer $ALURA_API_KEY\""},{"lang":"typescript","label":"TypeScript","source":"const res = await fetch('https://api.alura.io/v1/etsy/news/us-entry-type-13-postal', {\n headers: {\n Authorization: `Bearer ${process.env.ALURA_API_KEY}`,\n },\n});\nconsole.log(await res.json());"},{"lang":"python","label":"Python","source":"import json\nimport os\nimport urllib.request\n\nrequest = urllib.request.Request(\n \"https://api.alura.io/v1/etsy/news/us-entry-type-13-postal\",\n headers={\n \"Authorization\": f\"Bearer {os.environ['ALURA_API_KEY']}\",\n },\n)\nwith urllib.request.urlopen(request) as response:\n print(json.load(response))"}],"x-mint":{"href":"/api-reference/etsy/news/get","metadata":{"sidebarTitle":"Get article","description":"Get one Etsy News article by its slug: the whole story in markdown, with Etsy's pages as sources and every correction made after publishing."},"content":"**Cost:** Free.\n\n```bash\ncurl \"https://api.alura.io/v1/etsy/news/us-entry-type-13-postal\" \\\n -H \"Authorization: Bearer $ALURA_API_KEY\"\n```\n\n`body` is the story in markdown, 250 to 600 words: what changed, who it affects, what it costs, what to do and what isn't known yet. `url` is the article's page on alura.io.\n\n- `published_at` is the story's date: the day Etsy announced the change. `created_at` is when Alura published the article, which can be much later for an older change.\n- `corrections` lists every correction made after publishing, oldest first. A correction moves `updated_at`.\n- `update_ids` are the [Etsy updates](/api-reference/etsy/updates/get) the article explains, the main one first.\n\nTo find articles, use [List news](/api-reference/etsy/news/list)."},"method":"get","type":"path","servers":["6c764af2-fbc8-469e-a5ff-745270cc266b"],"security":["6144536c-06b0-4b8d-affd-b8dccec7d5ee"],"path":"/v1/etsy/news/{slug}","baseUrlOptions":["https://api.alura.io"],"title":"Get article","codeSamples":[{"label":"cURL","lang":"bash","source":"curl \"https://api.alura.io/v1/etsy/news/us-entry-type-13-postal\" \\\n -H \"Authorization: Bearer $ALURA_API_KEY\""},{"label":"TypeScript","lang":"typescript","source":"const res = await fetch('https://api.alura.io/v1/etsy/news/us-entry-type-13-postal', {\n headers: {\n Authorization: `Bearer ${process.env.ALURA_API_KEY}`,\n },\n});\nconsole.log(await res.json());"},{"label":"Python","lang":"python","source":"import json\nimport os\nimport urllib.request\n\nrequest = urllib.request.Request(\n \"https://api.alura.io/v1/etsy/news/us-entry-type-13-postal\",\n headers={\n \"Authorization\": f\"Bearer {os.environ['ALURA_API_KEY']}\",\n },\n)\nwith urllib.request.urlopen(request) as response:\n print(json.load(response))"}],"requestExampleLanguages":["bash","typescript","python"],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"4c3f88c2-094e-4e1a-855c-dd56afc9eb94":{"name":"slug","in":"path","required":true,"schema":{"type":"string","maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"The article slug (its id), such as `regulatory-operating-fee-june-2026`.","example":"us-entry-type-13-postal","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"c1e5bccc-2291-4522-b70f-a2ce52a5cb04":{"name":"fields","in":"query","required":false,"description":"Comma-separated dotted paths to return; `id`, `object` and `as_of` always come back.","schema":{"type":"string","isRequired":false,"description":"Comma-separated dotted paths to return; `id`, `object` and `as_of` always come back.","uniqueKey":"","typeLabel":"string"}}},"responses":{"00a2bb48-dccc-4a37-9331-8751cce5e2f0":{"description":"OK","headers":{"Request-Id":{"description":"`req_` + ULID; quote it when reporting a problem.","schema":{"type":"string"}},"Alura-Credits-Cost":{"description":"API credits this call cost.","schema":{"type":"integer"}},"Alura-Credits-Remaining":{"description":"API credits left in the workspace's monthly allowance, counting calls still in flight. Absent when it cannot be read right now.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"etsy.news_article","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"id":{"type":"string","description":"The article ID: its slug, such as `regulatory-operating-fee-june-2026` (`GET /v1/etsy/news/{slug}`).","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"slug":{"type":"string","description":"Its permanent address, the same as `id`.","isRequired":true,"uniqueKey":"slug","typeLabel":"string"},"title":{"type":"string","description":"What changed, in one line.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"dek":{"type":"string","description":"One sentence: who is affected and from when.","isRequired":true,"uniqueKey":"dek","typeLabel":"string"},"url":{"oneOf":[{"description":"The article's page on alura.io (`https://www.alura.io/news/{slug}`).","type":"string","isRequired":true,"uniqueKey":"url.oneOf.0","typeLabel":"string"},{"description":"The article's page on alura.io (`https://www.alura.io/news/{slug}`).","type":"null","isRequired":true,"uniqueKey":"url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"url","typeLabel":"string | null"},"published_at":{"type":"string","description":"The story's date: the day Etsy announced the change it covers, `YYYY-MM-DD`.","isRequired":true,"uniqueKey":"published_at","typeLabel":"string"},"created_at":{"type":"string","description":"When Alura published the article (ISO 8601, UTC); a backfilled story is published long after its date.","isRequired":true,"uniqueKey":"created_at","typeLabel":"string"},"updated_at":{"type":"string","description":"When Alura last changed the article (ISO 8601, UTC); a correction moves it.","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string"},"topics":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["fees","listing_rules","policies","search","programs","payments","shipping"],"uniqueKey":"topics.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"The areas of selling on Etsy it covers, as Etsy update kinds.","isRequired":true,"uniqueKey":"topics","typeLabel":"enum\u003cstring>[]"},"update_ids":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","uniqueKey":"update_ids.items.[INDEX]","typeLabel":"string"},"description":"The Etsy updates it explains (`GET /v1/etsy/updates/{id}`), the main one first.","isRequired":true,"uniqueKey":"update_ids","typeLabel":"string[]"},"author":{"type":"string","description":"The byline (`Alura`).","isRequired":true,"uniqueKey":"author","typeLabel":"string"},"body":{"type":"string","description":"The story in markdown, 250 to 600 words: what changed, who it affects, what it costs, what to do, and what is not known yet.","isRequired":true,"uniqueKey":"body","typeLabel":"string"},"sources":{"minItems":1,"maxItems":8,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"description":"Etsy's page: etsy.com, or its help, investors, blog or community site; a later source may be a web.archive.org copy of one.","isRequired":true,"uniqueKey":"sources.items.[INDEX].url","typeLabel":"string"},"title":{"type":"string","description":"The page's title, as Etsy wrote it.","isRequired":true,"uniqueKey":"sources.items.[INDEX].title","typeLabel":"string"},"publisher":{"type":"string","enum":["Etsy","ISO 4217"],"description":"`Etsy` for Etsy-owned pages; `ISO 4217` for currency minor units, the one source that is not Etsy.","isRequired":true,"uniqueKey":"sources.items.[INDEX].publisher","typeLabel":"enum\u003cstring>"},"published_at":{"oneOf":[{"type":"string","description":"When the page was published or last edited (YYYY-MM-DD); null when it does not say.","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","isRequired":true,"uniqueKey":"sources.items.[INDEX].published_at.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","description":"When the page was published or last edited (YYYY-MM-DD); null when it does not say.","isRequired":true,"uniqueKey":"sources.items.[INDEX].published_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sources.items.[INDEX].published_at","typeLabel":"string\u003cdate> | null"},"read_at":{"oneOf":[{"type":"string","description":"When Alura read the page (YYYY-MM-DD); null when not recorded.","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","isRequired":true,"uniqueKey":"sources.items.[INDEX].read_at.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","description":"When Alura read the page (YYYY-MM-DD); null when not recorded.","isRequired":true,"uniqueKey":"sources.items.[INDEX].read_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sources.items.[INDEX].read_at","typeLabel":"string\u003cdate> | null"}},"required":["url","title","publisher","published_at","read_at"],"additionalProperties":false,"uniqueKey":"sources.items.[INDEX]","typeLabel":"object"},"description":"Etsy's own pages every claim comes from, the main one first.","isRequired":true,"uniqueKey":"sources","typeLabel":"object[]"},"corrections":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"at":{"type":"string","description":"When it was corrected (ISO 8601, UTC).","isRequired":true,"uniqueKey":"corrections.items.[INDEX].at","typeLabel":"string"},"note":{"type":"string","description":"What was wrong, or what changed.","isRequired":true,"uniqueKey":"corrections.items.[INDEX].note","typeLabel":"string"}},"required":["at","note"],"additionalProperties":false,"uniqueKey":"corrections.items.[INDEX]","typeLabel":"object"},"description":"Every correction made after publishing, oldest first; empty when there was none.","isRequired":true,"uniqueKey":"corrections","typeLabel":"object[]"}},"required":["object","id","slug","title","dek","url","published_at","created_at","updated_at","topics","update_ids","author","body","sources","corrections"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"example":{"object":"etsy.news_article","id":"us-entry-type-13-postal","slug":"us-entry-type-13-postal","title":"US requires Entry Type 13 customs filing for postal parcels worth $2,500 or less from January 20, 2027","dek":"From January 20, 2027, sellers outside the US who post orders to US buyers need shipment-level customs data on each parcel, or it may be held or returned.","url":"https://www.alura.io/news/us-entry-type-13-postal","published_at":"2026-10-19","created_at":"2026-10-22T09:00:00.000Z","updated_at":"2026-10-22T09:00:00.000Z","topics":["shipping","policies"],"update_ids":["2026-10-19-us-entry-type-13"],"author":"Alura","body":"Starting January 20, 2027, international postal packages valued at $2,500 USD or less that enter the US \"must be filed electronically\" in US Customs and Border Protection's ACE system. Etsy [announced the change on October 19, 2026](https://community.etsy.com/forum/announcements-290/topic/new-us-customs-postal-entry-requirements-for-international-sellers-190423/). The filing goes through a new process called Entry Type 13. Each entry needs shipment-level customs data, plus any information or documents that US agencies such as the FDA or CPSC require. Your postal carrier collects it.\n\n## Who it affects\n\nEtsy's post is addressed to sellers who ship to US buyers from outside the US. The rule covers postal shipments only. Etsy says express carriers like FedEx, UPS and DHL \"already collect this information.\"\n\nThe agency rules reach many product types. Etsy's examples are food, supplements, candles, toys, children's clothing, certain jewelry, and items with animal materials (feathers, shells, bone, leather) or plant materials (wood, cork, botanicals). Products applied to the skin are also on the list. Depending on what you sell, you may need extra documents such as compliance certificates. Etsy says: \"You'll need to determine if the items you sell are affected.\"\n\n## What it means\n\nAfter January 20, 2027, a parcel posted without the required data can stop at the border. Etsy's wording: \"If required customs information isn't provided, your package may be held or returned.\"\n\nFor children's products and other CPSC-regulated goods, this builds on a rule already in force. Etsy's [Help Center](https://help.etsy.com/hc/en-us/articles/41840762260759) says that from July 8, 2026, importers of certain consumer products must submit safety certificate information electronically. Children's products need a Children's Product Certificate. For goods sent by postal mail, Etsy says using the CPSC Product Registry \"is required.\" The Registry issues a reference ID that you include with the shipment's customs information.\n\nEtsy hasn't put a price on any of this. The post mentions no Etsy fee.\n\n## What to do\n\n- List which of your products fall into the categories above, and gather any certificates you hold for them.\n- Etsy recommends connecting your shop to a free Zonos Verified Account to check whether items can ship to the US or need more documents. To connect, Etsy says to go to the Channels page in the Zonos Dashboard, select Add channel, choose Etsy, then select Connect and approve Zonos' request to access your orders and catalog. Zonos is a separate company, and Etsy notes that your use of it \"is governed by the applicable Zonos terms.\"\n- If you post CPSC-regulated items, register them in the CPSC Product Registry now. Etsy's Help Center already lists it as required for postal imports under the eFiling rule.\n- Ask your postal carrier what data it will need from you and how you will submit it.\n\n## What we don't know yet\n\nEtsy hasn't said which data fields postal carriers will ask for. It also hasn't said whether shipping labels bought on Etsy will pass the data automatically, or what happens to parcels already in transit on January 20, 2027. Etsy says it is \"monitoring developments leading up to the January compliance date\" and will update its post as it learns more.","sources":[{"url":"https://community.etsy.com/forum/announcements-290/topic/new-us-customs-postal-entry-requirements-for-international-sellers-190423/","title":"New US customs postal entry requirements for international sellers","publisher":"Etsy","published_at":"2026-10-19","read_at":null},{"url":"https://help.etsy.com/hc/en-us/articles/41840762260759","title":"How to Comply with US CPSC eFiling Requirements","publisher":"Etsy","published_at":"2026-07-09","read_at":null}],"corrections":[]},"examples":{"Example":{"title":"Example","value":{"object":"etsy.news_article","id":"us-entry-type-13-postal","slug":"us-entry-type-13-postal","title":"US requires Entry Type 13 customs filing for postal parcels worth $2,500 or less from January 20, 2027","dek":"From January 20, 2027, sellers outside the US who post orders to US buyers need shipment-level customs data on each parcel, or it may be held or returned.","url":"https://www.alura.io/news/us-entry-type-13-postal","published_at":"2026-10-19","created_at":"2026-10-22T09:00:00.000Z","updated_at":"2026-10-22T09:00:00.000Z","topics":["shipping","policies"],"update_ids":["2026-10-19-us-entry-type-13"],"author":"Alura","body":"Starting January 20, 2027, international postal packages valued at $2,500 USD or less that enter the US \"must be filed electronically\" in US Customs and Border Protection's ACE system. Etsy [announced the change on October 19, 2026](https://community.etsy.com/forum/announcements-290/topic/new-us-customs-postal-entry-requirements-for-international-sellers-190423/). The filing goes through a new process called Entry Type 13. Each entry needs shipment-level customs data, plus any information or documents that US agencies such as the FDA or CPSC require. Your postal carrier collects it.\n\n## Who it affects\n\nEtsy's post is addressed to sellers who ship to US buyers from outside the US. The rule covers postal shipments only. Etsy says express carriers like FedEx, UPS and DHL \"already collect this information.\"\n\nThe agency rules reach many product types. Etsy's examples are food, supplements, candles, toys, children's clothing, certain jewelry, and items with animal materials (feathers, shells, bone, leather) or plant materials (wood, cork, botanicals). Products applied to the skin are also on the list. Depending on what you sell, you may need extra documents such as compliance certificates. Etsy says: \"You'll need to determine if the items you sell are affected.\"\n\n## What it means\n\nAfter January 20, 2027, a parcel posted without the required data can stop at the border. Etsy's wording: \"If required customs information isn't provided, your package may be held or returned.\"\n\nFor children's products and other CPSC-regulated goods, this builds on a rule already in force. Etsy's [Help Center](https://help.etsy.com/hc/en-us/articles/41840762260759) says that from July 8, 2026, importers of certain consumer products must submit safety certificate information electronically. Children's products need a Children's Product Certificate. For goods sent by postal mail, Etsy says using the CPSC Product Registry \"is required.\" The Registry issues a reference ID that you include with the shipment's customs information.\n\nEtsy hasn't put a price on any of this. The post mentions no Etsy fee.\n\n## What to do\n\n- List which of your products fall into the categories above, and gather any certificates you hold for them.\n- Etsy recommends connecting your shop to a free Zonos Verified Account to check whether items can ship to the US or need more documents. To connect, Etsy says to go to the Channels page in the Zonos Dashboard, select Add channel, choose Etsy, then select Connect and approve Zonos' request to access your orders and catalog. Zonos is a separate company, and Etsy notes that your use of it \"is governed by the applicable Zonos terms.\"\n- If you post CPSC-regulated items, register them in the CPSC Product Registry now. Etsy's Help Center already lists it as required for postal imports under the eFiling rule.\n- Ask your postal carrier what data it will need from you and how you will submit it.\n\n## What we don't know yet\n\nEtsy hasn't said which data fields postal carriers will ask for. It also hasn't said whether shipping labels bought on Etsy will pass the data automatically, or what happens to parcels already in transit on January 20, 2027. Etsy says it is \"monitoring developments leading up to the January compliance date\" and will update its post as it learns more.","sources":[{"url":"https://community.etsy.com/forum/announcements-290/topic/new-us-customs-postal-entry-requirements-for-international-sellers-190423/","title":"New US customs postal entry requirements for international sellers","publisher":"Etsy","published_at":"2026-10-19","read_at":null},{"url":"https://help.etsy.com/hc/en-us/articles/41840762260759","title":"How to Comply with US CPSC eFiling Requirements","publisher":"Etsy","published_at":"2026-07-09","read_at":null}],"corrections":[]}}},"exampleType":"examples"}},"exampleType":"examples"},"2f3b0ec1-ec02-456d-98df-e761ee1a9eab":{"description":"Error","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 problem details.","properties":{"type":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","description":"A code from the error catalog; new codes may be added.","x-extensible-enum":["invalid_request","unknown_parameter","invalid_cursor","cursor_window_exceeded","invalid_reference","id_type_mismatch","invalid_keyword","shop_id_required","listing_not_publishable","sales_window_not_covered","unauthorized","credits_exhausted","plan_required","insufficient_scope","workspace_required","workspace_locked","your_shop_unavailable","writes_suspended","browser_refused","role_required","impersonation_refused","recent_sign_in_required","etsy_scope_required","etsy_partner_required","not_found","not_collected","not_found_on_etsy","shop_opted_out","method_not_allowed","conflict","key_limit_reached","reconnect_required","settings_not_fetched","listing_busy","settings_busy","shop_create_busy","idempotency_partial_unverifiable","listing_has_variations","changed_since","change_not_revertable","listing_in_ab_test","activation_skipped","idempotency_processing","confirmation_required","test_shop_active_cap","write_outcome_unknown","unprocessable","listing_removed_on_etsy","endpoint_removed","rate_limited","throttled","daily_credit_cap_exceeded","credits_reserved","fetch_limit_reached","write_rate_limited","sync_cooldown","shop_write_budget_exhausted","internal_error","write_misconfigured","upstream_unavailable","credits_unavailable","service_unavailable","fetch_unavailable","create_lock_unavailable","writes_paused","etsy_capacity","upstream_timeout"],"isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"suggestion":{"type":"string","isRequired":true,"uniqueKey":"suggestion","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"upgrade_url":{"type":"string","format":"uri","description":"credits_exhausted and plan_required: where to upgrade the plan.","uniqueKey":"upgrade_url","typeLabel":"string\u003curi>"},"credits_needed":{"type":"integer","description":"API credit refusals: what the call needed.","uniqueKey":"credits_needed","typeLabel":"integer"},"credits_remaining":{"type":"integer","description":"API credit refusals: what is left (of the month, or of the day for daily_credit_cap_exceeded).","uniqueKey":"credits_remaining","typeLabel":"integer"},"resets_at":{"type":"string","format":"date-time","description":"credits_exhausted and daily_credit_cap_exceeded: when the limit resets.","uniqueKey":"resets_at","typeLabel":"string\u003cdate-time>"}},"required":["type","title","status","code","detail","suggestion","retryable","request_id"],"uniqueKey":"","typeLabel":"object"},"example":{"type":"https://docs.alura.io/errors/invalid_request","title":"Invalid request","status":400,"code":"invalid_request","detail":"Invalid request","suggestion":"Fix the request as the detail says, then send it again.","retryable":false,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.alura.io/errors/invalid_request","title":"Invalid request","status":400,"code":"invalid_request","detail":"Invalid request","suggestion":"Fix the request as the detail says, then send it again.","retryable":false,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"}}},"exampleType":"examples"}},"exampleType":"examples"},"3eab1548-133c-4796-8d24-c04efb0865ac":{"description":"Error","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 problem details.","properties":{"type":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","description":"A code from the error catalog; new codes may be added.","x-extensible-enum":["invalid_request","unknown_parameter","invalid_cursor","cursor_window_exceeded","invalid_reference","id_type_mismatch","invalid_keyword","shop_id_required","listing_not_publishable","sales_window_not_covered","unauthorized","credits_exhausted","plan_required","insufficient_scope","workspace_required","workspace_locked","your_shop_unavailable","writes_suspended","browser_refused","role_required","impersonation_refused","recent_sign_in_required","etsy_scope_required","etsy_partner_required","not_found","not_collected","not_found_on_etsy","shop_opted_out","method_not_allowed","conflict","key_limit_reached","reconnect_required","settings_not_fetched","listing_busy","settings_busy","shop_create_busy","idempotency_partial_unverifiable","listing_has_variations","changed_since","change_not_revertable","listing_in_ab_test","activation_skipped","idempotency_processing","confirmation_required","test_shop_active_cap","write_outcome_unknown","unprocessable","listing_removed_on_etsy","endpoint_removed","rate_limited","throttled","daily_credit_cap_exceeded","credits_reserved","fetch_limit_reached","write_rate_limited","sync_cooldown","shop_write_budget_exhausted","internal_error","write_misconfigured","upstream_unavailable","credits_unavailable","service_unavailable","fetch_unavailable","create_lock_unavailable","writes_paused","etsy_capacity","upstream_timeout"],"isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"suggestion":{"type":"string","isRequired":true,"uniqueKey":"suggestion","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"upgrade_url":{"type":"string","format":"uri","description":"credits_exhausted and plan_required: where to upgrade the plan.","uniqueKey":"upgrade_url","typeLabel":"string\u003curi>"},"credits_needed":{"type":"integer","description":"API credit refusals: what the call needed.","uniqueKey":"credits_needed","typeLabel":"integer"},"credits_remaining":{"type":"integer","description":"API credit refusals: what is left (of the month, or of the day for daily_credit_cap_exceeded).","uniqueKey":"credits_remaining","typeLabel":"integer"},"resets_at":{"type":"string","format":"date-time","description":"credits_exhausted and daily_credit_cap_exceeded: when the limit resets.","uniqueKey":"resets_at","typeLabel":"string\u003cdate-time>"}},"required":["type","title","status","code","detail","suggestion","retryable","request_id"],"uniqueKey":"","typeLabel":"object"},"example":{"type":"https://docs.alura.io/errors/unauthorized","title":"Unauthorized","status":401,"code":"unauthorized","detail":"Unauthorized","suggestion":"Send a valid API key as `Authorization: Bearer alura_sk_...`.","retryable":false,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.alura.io/errors/unauthorized","title":"Unauthorized","status":401,"code":"unauthorized","detail":"Unauthorized","suggestion":"Send a valid API key as `Authorization: Bearer alura_sk_...`.","retryable":false,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"}}},"exampleType":"examples"}},"exampleType":"examples"},"c4e05f82-cc6a-44b1-840d-e6dbf3e957e4":{"description":"Error","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 problem details.","properties":{"type":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","description":"A code from the error catalog; new codes may be added.","x-extensible-enum":["invalid_request","unknown_parameter","invalid_cursor","cursor_window_exceeded","invalid_reference","id_type_mismatch","invalid_keyword","shop_id_required","listing_not_publishable","sales_window_not_covered","unauthorized","credits_exhausted","plan_required","insufficient_scope","workspace_required","workspace_locked","your_shop_unavailable","writes_suspended","browser_refused","role_required","impersonation_refused","recent_sign_in_required","etsy_scope_required","etsy_partner_required","not_found","not_collected","not_found_on_etsy","shop_opted_out","method_not_allowed","conflict","key_limit_reached","reconnect_required","settings_not_fetched","listing_busy","settings_busy","shop_create_busy","idempotency_partial_unverifiable","listing_has_variations","changed_since","change_not_revertable","listing_in_ab_test","activation_skipped","idempotency_processing","confirmation_required","test_shop_active_cap","write_outcome_unknown","unprocessable","listing_removed_on_etsy","endpoint_removed","rate_limited","throttled","daily_credit_cap_exceeded","credits_reserved","fetch_limit_reached","write_rate_limited","sync_cooldown","shop_write_budget_exhausted","internal_error","write_misconfigured","upstream_unavailable","credits_unavailable","service_unavailable","fetch_unavailable","create_lock_unavailable","writes_paused","etsy_capacity","upstream_timeout"],"isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"suggestion":{"type":"string","isRequired":true,"uniqueKey":"suggestion","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"upgrade_url":{"type":"string","format":"uri","description":"credits_exhausted and plan_required: where to upgrade the plan.","uniqueKey":"upgrade_url","typeLabel":"string\u003curi>"},"credits_needed":{"type":"integer","description":"API credit refusals: what the call needed.","uniqueKey":"credits_needed","typeLabel":"integer"},"credits_remaining":{"type":"integer","description":"API credit refusals: what is left (of the month, or of the day for daily_credit_cap_exceeded).","uniqueKey":"credits_remaining","typeLabel":"integer"},"resets_at":{"type":"string","format":"date-time","description":"credits_exhausted and daily_credit_cap_exceeded: when the limit resets.","uniqueKey":"resets_at","typeLabel":"string\u003cdate-time>"}},"required":["type","title","status","code","detail","suggestion","retryable","request_id"],"uniqueKey":"","typeLabel":"object"},"example":{"type":"https://docs.alura.io/errors/credits_exhausted","title":"API credits exhausted","status":402,"code":"credits_exhausted","detail":"API credits exhausted","suggestion":"Upgrade the plan or wait for the monthly reset.","retryable":false,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.alura.io/errors/credits_exhausted","title":"API credits exhausted","status":402,"code":"credits_exhausted","detail":"API credits exhausted","suggestion":"Upgrade the plan or wait for the monthly reset.","retryable":false,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"}}},"exampleType":"examples"}},"exampleType":"examples"},"c75edec8-3656-4787-a360-9060b6eecbc9":{"description":"Error","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 problem details.","properties":{"type":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","description":"A code from the error catalog; new codes may be added.","x-extensible-enum":["invalid_request","unknown_parameter","invalid_cursor","cursor_window_exceeded","invalid_reference","id_type_mismatch","invalid_keyword","shop_id_required","listing_not_publishable","sales_window_not_covered","unauthorized","credits_exhausted","plan_required","insufficient_scope","workspace_required","workspace_locked","your_shop_unavailable","writes_suspended","browser_refused","role_required","impersonation_refused","recent_sign_in_required","etsy_scope_required","etsy_partner_required","not_found","not_collected","not_found_on_etsy","shop_opted_out","method_not_allowed","conflict","key_limit_reached","reconnect_required","settings_not_fetched","listing_busy","settings_busy","shop_create_busy","idempotency_partial_unverifiable","listing_has_variations","changed_since","change_not_revertable","listing_in_ab_test","activation_skipped","idempotency_processing","confirmation_required","test_shop_active_cap","write_outcome_unknown","unprocessable","listing_removed_on_etsy","endpoint_removed","rate_limited","throttled","daily_credit_cap_exceeded","credits_reserved","fetch_limit_reached","write_rate_limited","sync_cooldown","shop_write_budget_exhausted","internal_error","write_misconfigured","upstream_unavailable","credits_unavailable","service_unavailable","fetch_unavailable","create_lock_unavailable","writes_paused","etsy_capacity","upstream_timeout"],"isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"suggestion":{"type":"string","isRequired":true,"uniqueKey":"suggestion","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"upgrade_url":{"type":"string","format":"uri","description":"credits_exhausted and plan_required: where to upgrade the plan.","uniqueKey":"upgrade_url","typeLabel":"string\u003curi>"},"credits_needed":{"type":"integer","description":"API credit refusals: what the call needed.","uniqueKey":"credits_needed","typeLabel":"integer"},"credits_remaining":{"type":"integer","description":"API credit refusals: what is left (of the month, or of the day for daily_credit_cap_exceeded).","uniqueKey":"credits_remaining","typeLabel":"integer"},"resets_at":{"type":"string","format":"date-time","description":"credits_exhausted and daily_credit_cap_exceeded: when the limit resets.","uniqueKey":"resets_at","typeLabel":"string\u003cdate-time>"}},"required":["type","title","status","code","detail","suggestion","retryable","request_id"],"uniqueKey":"","typeLabel":"object"},"example":{"type":"https://docs.alura.io/errors/plan_required","title":"Plan required","status":403,"code":"plan_required","detail":"Plan required","suggestion":"Upgrade the workspace plan to use this operation.","retryable":false,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.alura.io/errors/plan_required","title":"Plan required","status":403,"code":"plan_required","detail":"Plan required","suggestion":"Upgrade the workspace plan to use this operation.","retryable":false,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"}}},"exampleType":"examples"}},"exampleType":"examples"},"afc63dc5-6831-4f65-afb5-6a9590d7c3c1":{"description":"Error","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 problem details.","properties":{"type":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","description":"A code from the error catalog; new codes may be added.","x-extensible-enum":["invalid_request","unknown_parameter","invalid_cursor","cursor_window_exceeded","invalid_reference","id_type_mismatch","invalid_keyword","shop_id_required","listing_not_publishable","sales_window_not_covered","unauthorized","credits_exhausted","plan_required","insufficient_scope","workspace_required","workspace_locked","your_shop_unavailable","writes_suspended","browser_refused","role_required","impersonation_refused","recent_sign_in_required","etsy_scope_required","etsy_partner_required","not_found","not_collected","not_found_on_etsy","shop_opted_out","method_not_allowed","conflict","key_limit_reached","reconnect_required","settings_not_fetched","listing_busy","settings_busy","shop_create_busy","idempotency_partial_unverifiable","listing_has_variations","changed_since","change_not_revertable","listing_in_ab_test","activation_skipped","idempotency_processing","confirmation_required","test_shop_active_cap","write_outcome_unknown","unprocessable","listing_removed_on_etsy","endpoint_removed","rate_limited","throttled","daily_credit_cap_exceeded","credits_reserved","fetch_limit_reached","write_rate_limited","sync_cooldown","shop_write_budget_exhausted","internal_error","write_misconfigured","upstream_unavailable","credits_unavailable","service_unavailable","fetch_unavailable","create_lock_unavailable","writes_paused","etsy_capacity","upstream_timeout"],"isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"suggestion":{"type":"string","isRequired":true,"uniqueKey":"suggestion","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"upgrade_url":{"type":"string","format":"uri","description":"credits_exhausted and plan_required: where to upgrade the plan.","uniqueKey":"upgrade_url","typeLabel":"string\u003curi>"},"credits_needed":{"type":"integer","description":"API credit refusals: what the call needed.","uniqueKey":"credits_needed","typeLabel":"integer"},"credits_remaining":{"type":"integer","description":"API credit refusals: what is left (of the month, or of the day for daily_credit_cap_exceeded).","uniqueKey":"credits_remaining","typeLabel":"integer"},"resets_at":{"type":"string","format":"date-time","description":"credits_exhausted and daily_credit_cap_exceeded: when the limit resets.","uniqueKey":"resets_at","typeLabel":"string\u003cdate-time>"}},"required":["type","title","status","code","detail","suggestion","retryable","request_id"],"uniqueKey":"","typeLabel":"object"},"example":{"type":"https://docs.alura.io/errors/not_found","title":"Not found","status":404,"code":"not_found","detail":"Not found","suggestion":"Check the ID, or search for it first.","retryable":false,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.alura.io/errors/not_found","title":"Not found","status":404,"code":"not_found","detail":"Not found","suggestion":"Check the ID, or search for it first.","retryable":false,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"}}},"exampleType":"examples"}},"exampleType":"examples"},"a8a69497-55c6-4608-a236-a0c7340c73d3":{"description":"Error","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 problem details.","properties":{"type":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","description":"A code from the error catalog; new codes may be added.","x-extensible-enum":["invalid_request","unknown_parameter","invalid_cursor","cursor_window_exceeded","invalid_reference","id_type_mismatch","invalid_keyword","shop_id_required","listing_not_publishable","sales_window_not_covered","unauthorized","credits_exhausted","plan_required","insufficient_scope","workspace_required","workspace_locked","your_shop_unavailable","writes_suspended","browser_refused","role_required","impersonation_refused","recent_sign_in_required","etsy_scope_required","etsy_partner_required","not_found","not_collected","not_found_on_etsy","shop_opted_out","method_not_allowed","conflict","key_limit_reached","reconnect_required","settings_not_fetched","listing_busy","settings_busy","shop_create_busy","idempotency_partial_unverifiable","listing_has_variations","changed_since","change_not_revertable","listing_in_ab_test","activation_skipped","idempotency_processing","confirmation_required","test_shop_active_cap","write_outcome_unknown","unprocessable","listing_removed_on_etsy","endpoint_removed","rate_limited","throttled","daily_credit_cap_exceeded","credits_reserved","fetch_limit_reached","write_rate_limited","sync_cooldown","shop_write_budget_exhausted","internal_error","write_misconfigured","upstream_unavailable","credits_unavailable","service_unavailable","fetch_unavailable","create_lock_unavailable","writes_paused","etsy_capacity","upstream_timeout"],"isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"suggestion":{"type":"string","isRequired":true,"uniqueKey":"suggestion","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"upgrade_url":{"type":"string","format":"uri","description":"credits_exhausted and plan_required: where to upgrade the plan.","uniqueKey":"upgrade_url","typeLabel":"string\u003curi>"},"credits_needed":{"type":"integer","description":"API credit refusals: what the call needed.","uniqueKey":"credits_needed","typeLabel":"integer"},"credits_remaining":{"type":"integer","description":"API credit refusals: what is left (of the month, or of the day for daily_credit_cap_exceeded).","uniqueKey":"credits_remaining","typeLabel":"integer"},"resets_at":{"type":"string","format":"date-time","description":"credits_exhausted and daily_credit_cap_exceeded: when the limit resets.","uniqueKey":"resets_at","typeLabel":"string\u003cdate-time>"}},"required":["type","title","status","code","detail","suggestion","retryable","request_id"],"uniqueKey":"","typeLabel":"object"},"example":{"type":"https://docs.alura.io/errors/method_not_allowed","title":"Method not allowed","status":405,"code":"method_not_allowed","detail":"Method not allowed","suggestion":"Use one of the methods in the Allow header.","retryable":false,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.alura.io/errors/method_not_allowed","title":"Method not allowed","status":405,"code":"method_not_allowed","detail":"Method not allowed","suggestion":"Use one of the methods in the Allow header.","retryable":false,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"}}},"exampleType":"examples"}},"exampleType":"examples"},"9de14297-13c1-429c-9d8e-3a6a26abff30":{"description":"Error","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 problem details.","properties":{"type":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","description":"A code from the error catalog; new codes may be added.","x-extensible-enum":["invalid_request","unknown_parameter","invalid_cursor","cursor_window_exceeded","invalid_reference","id_type_mismatch","invalid_keyword","shop_id_required","listing_not_publishable","sales_window_not_covered","unauthorized","credits_exhausted","plan_required","insufficient_scope","workspace_required","workspace_locked","your_shop_unavailable","writes_suspended","browser_refused","role_required","impersonation_refused","recent_sign_in_required","etsy_scope_required","etsy_partner_required","not_found","not_collected","not_found_on_etsy","shop_opted_out","method_not_allowed","conflict","key_limit_reached","reconnect_required","settings_not_fetched","listing_busy","settings_busy","shop_create_busy","idempotency_partial_unverifiable","listing_has_variations","changed_since","change_not_revertable","listing_in_ab_test","activation_skipped","idempotency_processing","confirmation_required","test_shop_active_cap","write_outcome_unknown","unprocessable","listing_removed_on_etsy","endpoint_removed","rate_limited","throttled","daily_credit_cap_exceeded","credits_reserved","fetch_limit_reached","write_rate_limited","sync_cooldown","shop_write_budget_exhausted","internal_error","write_misconfigured","upstream_unavailable","credits_unavailable","service_unavailable","fetch_unavailable","create_lock_unavailable","writes_paused","etsy_capacity","upstream_timeout"],"isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"suggestion":{"type":"string","isRequired":true,"uniqueKey":"suggestion","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"upgrade_url":{"type":"string","format":"uri","description":"credits_exhausted and plan_required: where to upgrade the plan.","uniqueKey":"upgrade_url","typeLabel":"string\u003curi>"},"credits_needed":{"type":"integer","description":"API credit refusals: what the call needed.","uniqueKey":"credits_needed","typeLabel":"integer"},"credits_remaining":{"type":"integer","description":"API credit refusals: what is left (of the month, or of the day for daily_credit_cap_exceeded).","uniqueKey":"credits_remaining","typeLabel":"integer"},"resets_at":{"type":"string","format":"date-time","description":"credits_exhausted and daily_credit_cap_exceeded: when the limit resets.","uniqueKey":"resets_at","typeLabel":"string\u003cdate-time>"}},"required":["type","title","status","code","detail","suggestion","retryable","request_id"],"uniqueKey":"","typeLabel":"object"},"example":{"type":"https://docs.alura.io/errors/rate_limited","title":"Rate limited","status":429,"code":"rate_limited","detail":"Rate limited","suggestion":"Wait for Retry-After, then retry.","retryable":true,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.alura.io/errors/rate_limited","title":"Rate limited","status":429,"code":"rate_limited","detail":"Rate limited","suggestion":"Wait for Retry-After, then retry.","retryable":true,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"}}},"exampleType":"examples"}},"exampleType":"examples"},"19bdd722-9bb0-4852-b3ac-6af2af21e525":{"description":"Error","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 problem details.","properties":{"type":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","description":"A code from the error catalog; new codes may be added.","x-extensible-enum":["invalid_request","unknown_parameter","invalid_cursor","cursor_window_exceeded","invalid_reference","id_type_mismatch","invalid_keyword","shop_id_required","listing_not_publishable","sales_window_not_covered","unauthorized","credits_exhausted","plan_required","insufficient_scope","workspace_required","workspace_locked","your_shop_unavailable","writes_suspended","browser_refused","role_required","impersonation_refused","recent_sign_in_required","etsy_scope_required","etsy_partner_required","not_found","not_collected","not_found_on_etsy","shop_opted_out","method_not_allowed","conflict","key_limit_reached","reconnect_required","settings_not_fetched","listing_busy","settings_busy","shop_create_busy","idempotency_partial_unverifiable","listing_has_variations","changed_since","change_not_revertable","listing_in_ab_test","activation_skipped","idempotency_processing","confirmation_required","test_shop_active_cap","write_outcome_unknown","unprocessable","listing_removed_on_etsy","endpoint_removed","rate_limited","throttled","daily_credit_cap_exceeded","credits_reserved","fetch_limit_reached","write_rate_limited","sync_cooldown","shop_write_budget_exhausted","internal_error","write_misconfigured","upstream_unavailable","credits_unavailable","service_unavailable","fetch_unavailable","create_lock_unavailable","writes_paused","etsy_capacity","upstream_timeout"],"isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"suggestion":{"type":"string","isRequired":true,"uniqueKey":"suggestion","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"upgrade_url":{"type":"string","format":"uri","description":"credits_exhausted and plan_required: where to upgrade the plan.","uniqueKey":"upgrade_url","typeLabel":"string\u003curi>"},"credits_needed":{"type":"integer","description":"API credit refusals: what the call needed.","uniqueKey":"credits_needed","typeLabel":"integer"},"credits_remaining":{"type":"integer","description":"API credit refusals: what is left (of the month, or of the day for daily_credit_cap_exceeded).","uniqueKey":"credits_remaining","typeLabel":"integer"},"resets_at":{"type":"string","format":"date-time","description":"credits_exhausted and daily_credit_cap_exceeded: when the limit resets.","uniqueKey":"resets_at","typeLabel":"string\u003cdate-time>"}},"required":["type","title","status","code","detail","suggestion","retryable","request_id"],"uniqueKey":"","typeLabel":"object"},"example":{"type":"https://docs.alura.io/errors/internal_error","title":"Internal error","status":500,"code":"internal_error","detail":"Internal error","suggestion":"Retry; if it keeps failing, report the request_id.","retryable":true,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.alura.io/errors/internal_error","title":"Internal error","status":500,"code":"internal_error","detail":"Internal error","suggestion":"Retry; if it keeps failing, report the request_id.","retryable":true,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"}}},"exampleType":"examples"}},"exampleType":"examples"},"f5d8251c-0155-4535-b640-b2b51169db1d":{"description":"Error","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 problem details.","properties":{"type":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","description":"A code from the error catalog; new codes may be added.","x-extensible-enum":["invalid_request","unknown_parameter","invalid_cursor","cursor_window_exceeded","invalid_reference","id_type_mismatch","invalid_keyword","shop_id_required","listing_not_publishable","sales_window_not_covered","unauthorized","credits_exhausted","plan_required","insufficient_scope","workspace_required","workspace_locked","your_shop_unavailable","writes_suspended","browser_refused","role_required","impersonation_refused","recent_sign_in_required","etsy_scope_required","etsy_partner_required","not_found","not_collected","not_found_on_etsy","shop_opted_out","method_not_allowed","conflict","key_limit_reached","reconnect_required","settings_not_fetched","listing_busy","settings_busy","shop_create_busy","idempotency_partial_unverifiable","listing_has_variations","changed_since","change_not_revertable","listing_in_ab_test","activation_skipped","idempotency_processing","confirmation_required","test_shop_active_cap","write_outcome_unknown","unprocessable","listing_removed_on_etsy","endpoint_removed","rate_limited","throttled","daily_credit_cap_exceeded","credits_reserved","fetch_limit_reached","write_rate_limited","sync_cooldown","shop_write_budget_exhausted","internal_error","write_misconfigured","upstream_unavailable","credits_unavailable","service_unavailable","fetch_unavailable","create_lock_unavailable","writes_paused","etsy_capacity","upstream_timeout"],"isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"suggestion":{"type":"string","isRequired":true,"uniqueKey":"suggestion","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"upgrade_url":{"type":"string","format":"uri","description":"credits_exhausted and plan_required: where to upgrade the plan.","uniqueKey":"upgrade_url","typeLabel":"string\u003curi>"},"credits_needed":{"type":"integer","description":"API credit refusals: what the call needed.","uniqueKey":"credits_needed","typeLabel":"integer"},"credits_remaining":{"type":"integer","description":"API credit refusals: what is left (of the month, or of the day for daily_credit_cap_exceeded).","uniqueKey":"credits_remaining","typeLabel":"integer"},"resets_at":{"type":"string","format":"date-time","description":"credits_exhausted and daily_credit_cap_exceeded: when the limit resets.","uniqueKey":"resets_at","typeLabel":"string\u003cdate-time>"}},"required":["type","title","status","code","detail","suggestion","retryable","request_id"],"uniqueKey":"","typeLabel":"object"},"example":{"type":"https://docs.alura.io/errors/credits_unavailable","title":"API credits unavailable","status":503,"code":"credits_unavailable","detail":"API credits unavailable","suggestion":"Retry shortly.","retryable":true,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"},"examples":{"Example":{"title":"Example","value":{"type":"https://docs.alura.io/errors/credits_unavailable","title":"API credits unavailable","status":503,"code":"credits_unavailable","detail":"API credits unavailable","suggestion":"Retry shortly.","retryable":true,"request_id":"req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"6144536c-06b0-4b8d-affd-b8dccec7d5ee":{"apiKey":{"type":"http","scheme":"bearer","description":"An API key: `Authorization: Bearer alura_sk_...`.","scopes":[],"schemeName":"apiKey"}}},"servers":{"6c764af2-fbc8-469e-a5ff-745270cc266b":{"url":"https://api.alura.io"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An API key: `Authorization: Bearer alura_sk_...`.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key: `Authorization: Bearer alura_sk_...`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"alura","siteName":"Alura API","title":"Get article - Alura API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-07T16:18:24.042Z","originalFileLocation":"api-reference/etsy/news/get.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=\"Get one Etsy News article by its slug: the whole story in markdown, with Etsy\u0026#x27;s pages as sources and every correction made after publishing.\">\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=\"Get article - Alura API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get one Etsy News article by its slug: the whole story in markdown, with Etsy\u0026#x27;s pages as sources and every correction made after publishing.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Alura API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.alura.io/api-reference/etsy/news/get\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://alura.mintlify.site/_mintlify/api/og/v2?division=News+%26+updates\u0026amp;title=Get+article\u0026amp;description=Get+one+Etsy+News+article+by+its+slug%3A+the+whole+story+in+markdown%2C+with+Etsy%27s+pages+as+sources+and+every+correction+made+after+publishing.\u0026amp;theme=3c07f090342beadd77468265\u0026amp;signature=6cf4951d24db36b85de5e03a52354103109c10b787ef7704357f4241f566a2fd\">\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=\"Get article - Alura API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get one Etsy News article by its slug: the whole story in markdown, with Etsy\u0026#x27;s pages as sources and every correction made after publishing.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://alura.mintlify.site/_mintlify/api/og/v2?division=News+%26+updates\u0026amp;title=Get+article\u0026amp;description=Get+one+Etsy+News+article+by+its+slug%3A+the+whole+story+in+markdown%2C+with+Etsy%27s+pages+as+sources+and+every+correction+made+after+publishing.\u0026amp;theme=3c07f090342beadd77468265\u0026amp;signature=6cf4951d24db36b85de5e03a52354103109c10b787ef7704357f4241f566a2fd\">\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/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/api-reference/etsy/news/get\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/etsy/news/get.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.alura.io/#organization\",\"name\":\"Alura API\",\"url\":\"https://docs.alura.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/alura/HySS5CT36sWBL9EL/logo/light.svg?fit=max\u0026auto=format\u0026n=HySS5CT36sWBL9EL\u0026q=85\u0026s=6afcc5174d02ee0af4c233126964240a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.alura.io#website\",\"name\":\"Alura API\",\"url\":\"https://docs.alura.io\",\"publisher\":{\"@id\":\"https://docs.alura.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.alura.io/api-reference/etsy/news/get#webpage\",\"url\":\"https://docs.alura.io/api-reference/etsy/news/get\",\"name\":\"Get article\",\"description\":\"Get one Etsy News article by its slug: the whole story in markdown, with Etsy's pages as sources and every correction made after publishing.\",\"dateModified\":\"2026-11-07T16:18:24.042Z\",\"isPartOf\":{\"@id\":\"https://docs.alura.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.alura.io/api-reference/etsy/news/get#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.alura.io/api-reference/etsy/news/get#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Etsy\",\"item\":\"https://docs.alura.io/api-reference/etsy/categories/search\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"News \u0026 updates\",\"item\":\"https://docs.alura.io/api-reference/etsy/feed/list\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get article\",\"item\":\"https://docs.alura.io/api-reference/etsy/news/get\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.alura.io/api-reference/etsy/news/get#apireference\",\"headline\":\"Get article\",\"name\":\"Get article\",\"description\":\"Get one Etsy News article by its slug: the whole story in markdown, with Etsy's pages as sources and every correction made after publishing.\",\"url\":\"https://docs.alura.io/api-reference/etsy/news/get\",\"mainEntityOfPage\":{\"@id\":\"https://docs.alura.io/api-reference/etsy/news/get#webpage\"},\"dateModified\":\"2026-11-07T16:18:24.042Z\",\"publisher\":{\"@id\":\"https://docs.alura.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.alura.io#website\"}}]}\u003c/script>\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","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Credits and limits","href":"/api-reference/credits-and-limits"},{"title":"Errors","href":"/api-reference/errors"}]},{"group":"Research","pages":[{"group":"Lookup","pages":[{"title":"Look up URL or shop","deprecated":null,"version":null,"sidebarTitle":"Look up URL or shop","openapi":"/openapi.json get /v1/research/lookup","href":"/api-reference/research/lookup"}]},{"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 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 product","deprecated":null,"version":null,"sidebarTitle":"Get 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":"Get similar products","deprecated":null,"version":null,"sidebarTitle":"Get similar products","openapi":"/openapi.json get /v1/research/products/{id}/similar","href":"/api-reference/research/products/similar"},{"title":"Get product history","deprecated":null,"version":null,"sidebarTitle":"Get product history","openapi":"/openapi.json get /v1/research/products/{id}/history","href":"/api-reference/research/products/history"},{"title":"Get sales histories","deprecated":null,"version":null,"sidebarTitle":"Get sales histories","openapi":"/openapi.json get /v1/research/history","href":"/api-reference/research/history/getmany"},{"title":"List product reviews","deprecated":null,"version":null,"sidebarTitle":"List product reviews","openapi":"/openapi.json get /v1/research/products/{id}/reviews","href":"/api-reference/research/products/reviews"}]},{"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 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 shop","deprecated":null,"version":null,"sidebarTitle":"Get shop","openapi":"/openapi.json get /v1/research/shops/{id}","href":"/api-reference/research/shops/get"},{"title":"List shop products","deprecated":null,"version":null,"sidebarTitle":"List shop products","openapi":"/openapi.json get /v1/research/shops/{id}/products","href":"/api-reference/research/shops/products"},{"title":"Get similar shops","deprecated":null,"version":null,"sidebarTitle":"Get similar shops","openapi":"/openapi.json get /v1/research/shops/{id}/similar","href":"/api-reference/research/shops/similar"},{"title":"List shop reviews","deprecated":null,"version":null,"sidebarTitle":"List shop reviews","openapi":"/openapi.json get /v1/research/shops/{id}/reviews","href":"/api-reference/research/shops/reviews"},{"title":"Get shop history","deprecated":null,"version":null,"sidebarTitle":"Get shop 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 trending keywords","deprecated":null,"version":null,"sidebarTitle":"Get trending keywords","openapi":"/openapi.json get /v1/research/keywords/trending","href":"/api-reference/research/keywords/trending"},{"title":"Get keyword","deprecated":null,"version":null,"sidebarTitle":"Get 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 top products","deprecated":null,"version":null,"sidebarTitle":"Get top products","openapi":"/openapi.json get /v1/research/keywords/{id}/products","href":"/api-reference/research/keywords/products"},{"title":"Get top shops","deprecated":null,"version":null,"sidebarTitle":"Get top shops","openapi":"/openapi.json get /v1/research/keywords/{id}/shops","href":"/api-reference/research/keywords/shops"},{"title":"Get keyword history","deprecated":null,"version":null,"sidebarTitle":"Get keyword history","openapi":"/openapi.json get /v1/research/keywords/{id}/history","href":"/api-reference/research/keywords/history"}]},{"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 saved folder","deprecated":null,"version":null,"sidebarTitle":"Create saved folder","openapi":"/openapi.json post /v1/research/saved/folders","href":"/api-reference/research/saved/folders/create"},{"title":"Get saved folder","deprecated":null,"version":null,"sidebarTitle":"Get saved folder","openapi":"/openapi.json get /v1/research/saved/folders/{id}","href":"/api-reference/research/saved/folders/get"},{"title":"Update saved folder","deprecated":null,"version":null,"sidebarTitle":"Update saved folder","openapi":"/openapi.json patch /v1/research/saved/folders/{id}","href":"/api-reference/research/saved/folders/update"},{"title":"Delete saved folder","deprecated":null,"version":null,"sidebarTitle":"Delete 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 saved list","deprecated":null,"version":null,"sidebarTitle":"Create saved list","openapi":"/openapi.json post /v1/research/saved/lists","href":"/api-reference/research/saved/lists/create"},{"title":"Get saved list","deprecated":null,"version":null,"sidebarTitle":"Get saved list","openapi":"/openapi.json get /v1/research/saved/lists/{id}","href":"/api-reference/research/saved/lists/get"},{"title":"Update saved list","deprecated":null,"version":null,"sidebarTitle":"Update saved list","openapi":"/openapi.json patch /v1/research/saved/lists/{id}","href":"/api-reference/research/saved/lists/update"},{"title":"Delete saved list","deprecated":null,"version":null,"sidebarTitle":"Delete 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":"List all saved items","deprecated":null,"version":null,"sidebarTitle":"List all saved items","openapi":"/openapi.json get /v1/research/saved/items","href":"/api-reference/research/saved/items/search"},{"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":"Your shop","pages":[{"group":"Shop","pages":[{"title":"List shops","deprecated":null,"version":null,"sidebarTitle":"List shops","openapi":"/openapi.json get /v1/workspace/shops","href":"/api-reference/workspace/shops/list"},{"title":"Get shop","deprecated":null,"version":null,"sidebarTitle":"Get shop","openapi":"/openapi.json get /v1/workspace/shops/{shop_id}","href":"/api-reference/workspace/shops/get"},{"title":"Update shop","deprecated":null,"version":null,"sidebarTitle":"Update shop","openapi":"/openapi.json patch /v1/workspace/shops/{shop_id}","href":"/api-reference/workspace/shops/update"},{"group":"Sections","pages":[{"title":"List sections","deprecated":null,"version":null,"sidebarTitle":"List sections","openapi":"/openapi.json get /v1/workspace/sections","href":"/api-reference/workspace/sections/list"},{"title":"Create section","deprecated":null,"version":null,"sidebarTitle":"Create section","openapi":"/openapi.json post /v1/workspace/sections","href":"/api-reference/workspace/sections/create"},{"title":"Update section","deprecated":null,"version":null,"sidebarTitle":"Update section","openapi":"/openapi.json patch /v1/workspace/sections/{id}","href":"/api-reference/workspace/sections/update"},{"title":"Delete section","deprecated":null,"version":null,"sidebarTitle":"Delete section","openapi":"/openapi.json delete /v1/workspace/sections/{id}","href":"/api-reference/workspace/sections/delete"}]},{"group":"Shipping profiles","pages":[{"title":"List shipping profiles","deprecated":null,"version":null,"sidebarTitle":"List shipping profiles","openapi":"/openapi.json get /v1/workspace/shipping-profiles","href":"/api-reference/workspace/shippingprofiles/list"},{"title":"Get shipping profile","deprecated":null,"version":null,"sidebarTitle":"Get shipping profile","openapi":"/openapi.json get /v1/workspace/shipping-profiles/{id}","href":"/api-reference/workspace/shippingprofiles/get"},{"title":"Create shipping profile","deprecated":null,"version":null,"sidebarTitle":"Create shipping profile","openapi":"/openapi.json post /v1/workspace/shipping-profiles","href":"/api-reference/workspace/shippingprofiles/create"},{"title":"Update shipping profile","deprecated":null,"version":null,"sidebarTitle":"Update shipping profile","openapi":"/openapi.json patch /v1/workspace/shipping-profiles/{id}","href":"/api-reference/workspace/shippingprofiles/update"},{"title":"Delete shipping profile","deprecated":null,"version":null,"sidebarTitle":"Delete shipping profile","openapi":"/openapi.json delete /v1/workspace/shipping-profiles/{id}","href":"/api-reference/workspace/shippingprofiles/delete"},{"group":"Destinations","pages":[{"title":"List destinations","deprecated":null,"version":null,"sidebarTitle":"List destinations","openapi":"/openapi.json get /v1/workspace/shipping-profiles/{id}/destinations","href":"/api-reference/workspace/shippingprofiles/destinations"},{"title":"Create destination","deprecated":null,"version":null,"sidebarTitle":"Create destination","openapi":"/openapi.json post /v1/workspace/shipping-profiles/{id}/destinations","href":"/api-reference/workspace/shippingprofiles/destinations/create"},{"title":"Update destination","deprecated":null,"version":null,"sidebarTitle":"Update destination","openapi":"/openapi.json patch /v1/workspace/shipping-profiles/{id}/destinations/{destination_id}","href":"/api-reference/workspace/shippingprofiles/destinations/update"},{"title":"Delete destination","deprecated":null,"version":null,"sidebarTitle":"Delete destination","openapi":"/openapi.json delete /v1/workspace/shipping-profiles/{id}/destinations/{destination_id}","href":"/api-reference/workspace/shippingprofiles/destinations/delete"}]},{"group":"Upgrades","pages":[{"title":"List delivery upgrades","deprecated":null,"version":null,"sidebarTitle":"List delivery upgrades","openapi":"/openapi.json get /v1/workspace/shipping-profiles/{id}/upgrades","href":"/api-reference/workspace/shippingprofiles/deliveryoptions"},{"title":"Create upgrade","deprecated":null,"version":null,"sidebarTitle":"Create upgrade","openapi":"/openapi.json post /v1/workspace/shipping-profiles/{id}/upgrades","href":"/api-reference/workspace/shippingprofiles/deliveryoptions/create"},{"title":"Update upgrade","deprecated":null,"version":null,"sidebarTitle":"Update upgrade","openapi":"/openapi.json patch /v1/workspace/shipping-profiles/{id}/upgrades/{upgrade_id}","href":"/api-reference/workspace/shippingprofiles/deliveryoptions/update"},{"title":"Delete upgrade","deprecated":null,"version":null,"sidebarTitle":"Delete upgrade","openapi":"/openapi.json delete /v1/workspace/shipping-profiles/{id}/upgrades/{upgrade_id}","href":"/api-reference/workspace/shippingprofiles/deliveryoptions/delete"}]}]},{"group":"Return policies","pages":[{"title":"List return policies","deprecated":null,"version":null,"sidebarTitle":"List return policies","openapi":"/openapi.json get /v1/workspace/return-policies","href":"/api-reference/workspace/returnpolicies/list"},{"title":"Get return policy","deprecated":null,"version":null,"sidebarTitle":"Get return policy","openapi":"/openapi.json get /v1/workspace/return-policies/{id}","href":"/api-reference/workspace/returnpolicies/get"},{"title":"Create return policy","deprecated":null,"version":null,"sidebarTitle":"Create return policy","openapi":"/openapi.json post /v1/workspace/return-policies","href":"/api-reference/workspace/returnpolicies/create"},{"title":"Update return policy","deprecated":null,"version":null,"sidebarTitle":"Update return policy","openapi":"/openapi.json patch /v1/workspace/return-policies/{id}","href":"/api-reference/workspace/returnpolicies/update"},{"title":"Delete return policy","deprecated":null,"version":null,"sidebarTitle":"Delete return policy","openapi":"/openapi.json delete /v1/workspace/return-policies/{id}","href":"/api-reference/workspace/returnpolicies/delete"},{"title":"Move policy listings","deprecated":null,"version":null,"sidebarTitle":"Move policy listings","openapi":"/openapi.json post /v1/workspace/return-policies/{id}/move-listings","href":"/api-reference/workspace/returnpolicies/movelistings"}]},{"group":"Processing profiles","pages":[{"title":"List profiles","deprecated":null,"version":null,"sidebarTitle":"List profiles","openapi":"/openapi.json get /v1/workspace/processing-profiles","href":"/api-reference/workspace/processingprofiles/list"},{"title":"Get profile","deprecated":null,"version":null,"sidebarTitle":"Get profile","openapi":"/openapi.json get /v1/workspace/processing-profiles/{id}","href":"/api-reference/workspace/processingprofiles/get"},{"title":"Create profile","deprecated":null,"version":null,"sidebarTitle":"Create profile","openapi":"/openapi.json post /v1/workspace/processing-profiles","href":"/api-reference/workspace/processingprofiles/create"},{"title":"Update profile","deprecated":null,"version":null,"sidebarTitle":"Update profile","openapi":"/openapi.json patch /v1/workspace/processing-profiles/{id}","href":"/api-reference/workspace/processingprofiles/update"},{"title":"Delete profile","deprecated":null,"version":null,"sidebarTitle":"Delete profile","openapi":"/openapi.json delete /v1/workspace/processing-profiles/{id}","href":"/api-reference/workspace/processingprofiles/delete"}]},{"group":"Holiday settings","pages":[{"title":"Get holiday settings","deprecated":null,"version":null,"sidebarTitle":"Get holiday settings","openapi":"/openapi.json get /v1/workspace/holiday-settings","href":"/api-reference/workspace/holidaysettings/list"},{"title":"Update holiday settings","deprecated":null,"version":null,"sidebarTitle":"Update holiday settings","openapi":"/openapi.json patch /v1/workspace/holiday-settings","href":"/api-reference/workspace/holidaysettings/update"}]},{"group":"Production partners","pages":[{"title":"List partners","deprecated":null,"version":null,"sidebarTitle":"List partners","openapi":"/openapi.json get /v1/workspace/production-partners","href":"/api-reference/workspace/productionpartners/list"}]}]},{"group":"Stats","pages":[{"title":"Get shop stats","deprecated":null,"version":null,"sidebarTitle":"Get shop stats","openapi":"/openapi.json get /v1/workspace/stats","href":"/api-reference/workspace/stats/get"}]},{"group":"Listings","pages":[{"title":"Search listings","deprecated":null,"version":null,"sidebarTitle":"Search listings","openapi":"/openapi.json get /v1/workspace/listings","href":"/api-reference/workspace/listings/search"},{"title":"Get listing","deprecated":null,"version":null,"sidebarTitle":"Get listing","openapi":"/openapi.json get /v1/workspace/listings/{id}","href":"/api-reference/workspace/listings/get"},{"title":"Get listing stats","deprecated":null,"version":null,"sidebarTitle":"Get listing stats","openapi":"/openapi.json get /v1/workspace/listings/{id}/stats","href":"/api-reference/workspace/listings/stats"},{"title":"Update listing","deprecated":null,"version":null,"sidebarTitle":"Update listing","openapi":"/openapi.json patch /v1/workspace/listings/{id}","href":"/api-reference/workspace/listings/update"},{"title":"Create listing","deprecated":null,"version":null,"sidebarTitle":"Create listing","openapi":"/openapi.json post /v1/workspace/listings","href":"/api-reference/workspace/listings/create"},{"title":"Duplicate listing","deprecated":null,"version":null,"sidebarTitle":"Duplicate listing","openapi":"/openapi.json post /v1/workspace/listings/{id}/duplicate","href":"/api-reference/workspace/listings/duplicate"},{"title":"Delete listing","deprecated":null,"version":null,"sidebarTitle":"Delete listing","openapi":"/openapi.json delete /v1/workspace/listings/{id}","href":"/api-reference/workspace/listings/delete"},{"group":"Images","pages":[{"title":"Add images","deprecated":null,"version":null,"sidebarTitle":"Add images","openapi":"/openapi.json post /v1/workspace/listings/{id}/images","href":"/api-reference/workspace/listings/images/add"},{"title":"Update alt text","deprecated":null,"version":null,"sidebarTitle":"Update alt text","openapi":"/openapi.json patch /v1/workspace/listings/{id}/images/{image_id}","href":"/api-reference/workspace/listings/images/update"},{"title":"Reorder images","deprecated":null,"version":null,"sidebarTitle":"Reorder images","openapi":"/openapi.json put /v1/workspace/listings/{id}/images/order","href":"/api-reference/workspace/listings/images/reorder"},{"title":"Remove image","deprecated":null,"version":null,"sidebarTitle":"Remove image","openapi":"/openapi.json delete /v1/workspace/listings/{id}/images/{image_id}","href":"/api-reference/workspace/listings/images/remove"}]},{"group":"Videos","pages":[{"title":"Add video","deprecated":null,"version":null,"sidebarTitle":"Add video","openapi":"/openapi.json post /v1/workspace/listings/{id}/videos","href":"/api-reference/workspace/listings/videos/add"},{"title":"Feature video","deprecated":null,"version":null,"sidebarTitle":"Feature video","openapi":"/openapi.json put /v1/workspace/listings/{id}/videos/featured","href":"/api-reference/workspace/listings/videos/feature"},{"title":"Remove video","deprecated":null,"version":null,"sidebarTitle":"Remove video","openapi":"/openapi.json delete /v1/workspace/listings/{id}/videos/{video_id}","href":"/api-reference/workspace/listings/videos/remove"}]},{"group":"Files","pages":[{"title":"Add file","deprecated":null,"version":null,"sidebarTitle":"Add file","openapi":"/openapi.json post /v1/workspace/listings/{id}/files","href":"/api-reference/workspace/listings/files/add"},{"title":"Remove file","deprecated":null,"version":null,"sidebarTitle":"Remove file","openapi":"/openapi.json delete /v1/workspace/listings/{id}/files/{file_id}","href":"/api-reference/workspace/listings/files/remove"}]},{"group":"Inventory","pages":[{"title":"Replace inventory","deprecated":null,"version":null,"sidebarTitle":"Replace inventory","openapi":"/openapi.json put /v1/workspace/listings/{id}/inventory","href":"/api-reference/workspace/listings/inventory/replace"},{"title":"Patch offerings","deprecated":null,"version":null,"sidebarTitle":"Patch offerings","openapi":"/openapi.json patch /v1/workspace/listings/{id}/inventory","href":"/api-reference/workspace/listings/inventory/patch"}]},{"group":"Content","pages":[{"title":"Update attributes","deprecated":null,"version":null,"sidebarTitle":"Update attributes","openapi":"/openapi.json patch /v1/workspace/listings/{id}/attributes","href":"/api-reference/workspace/listings/attributes/update"},{"title":"Set translation","deprecated":null,"version":null,"sidebarTitle":"Set translation","openapi":"/openapi.json put /v1/workspace/listings/{id}/translations/{language}","href":"/api-reference/workspace/listings/translations/update"},{"title":"Replace personalization","deprecated":null,"version":null,"sidebarTitle":"Replace personalization","openapi":"/openapi.json put /v1/workspace/listings/{id}/personalization","href":"/api-reference/workspace/listings/personalization/replace"},{"title":"Set variation images","deprecated":null,"version":null,"sidebarTitle":"Set variation images","openapi":"/openapi.json put /v1/workspace/listings/{id}/variation-images","href":"/api-reference/workspace/listings/variation_images/replace"}]}]},{"group":"Orders","pages":[{"title":"Search orders","deprecated":null,"version":null,"sidebarTitle":"Search orders","openapi":"/openapi.json get /v1/workspace/orders","href":"/api-reference/workspace/orders/search"},{"title":"Get order","deprecated":null,"version":null,"sidebarTitle":"Get order","openapi":"/openapi.json get /v1/workspace/orders/{id}","href":"/api-reference/workspace/orders/get"},{"title":"Add shipment","deprecated":null,"version":null,"sidebarTitle":"Add shipment","openapi":"/openapi.json post /v1/workspace/orders/{id}/shipments","href":"/api-reference/workspace/orders/shipments/create"}]},{"group":"Reviews","pages":[{"title":"Search reviews","deprecated":null,"version":null,"sidebarTitle":"Search reviews","openapi":"/openapi.json get /v1/workspace/reviews","href":"/api-reference/workspace/reviews/search"}]},{"group":"Customers","pages":[{"title":"Search customers","deprecated":null,"version":null,"sidebarTitle":"Search customers","openapi":"/openapi.json get /v1/workspace/customers","href":"/api-reference/workspace/customers/search"},{"title":"Get customer","deprecated":null,"version":null,"sidebarTitle":"Get customer","openapi":"/openapi.json get /v1/workspace/customers/{id}","href":"/api-reference/workspace/customers/get"}]},{"group":"Changes","pages":[{"title":"List changes","deprecated":null,"version":null,"sidebarTitle":"List changes","openapi":"/openapi.json get /v1/workspace/changes","href":"/api-reference/workspace/changes/list"},{"title":"Get change","deprecated":null,"version":null,"sidebarTitle":"Get change","openapi":"/openapi.json get /v1/workspace/changes/{id}","href":"/api-reference/workspace/changes/get"},{"title":"Revert change","deprecated":null,"version":null,"sidebarTitle":"Revert change","openapi":"/openapi.json post /v1/workspace/changes/{id}/revert","href":"/api-reference/workspace/changes/revert"}]},{"group":"Syncs","pages":[{"title":"Start sync","deprecated":null,"version":null,"sidebarTitle":"Start sync","openapi":"/openapi.json post /v1/workspace/syncs","href":"/api-reference/workspace/syncs/start"},{"title":"Get sync","deprecated":null,"version":null,"sidebarTitle":"Get sync","openapi":"/openapi.json get /v1/workspace/syncs/{id}","href":"/api-reference/workspace/syncs/get"},{"title":"List syncs","deprecated":null,"version":null,"sidebarTitle":"List syncs","openapi":"/openapi.json get /v1/workspace/syncs","href":"/api-reference/workspace/syncs/list"}]}]},{"group":"Etsy","pages":[{"group":"Catalog","pages":[{"title":"Search categories","deprecated":null,"version":null,"sidebarTitle":"Search categories","openapi":"/openapi.json get /v1/etsy/categories","href":"/api-reference/etsy/categories/search"},{"title":"Get category","deprecated":null,"version":null,"sidebarTitle":"Get category","openapi":"/openapi.json get /v1/etsy/categories/{id}","href":"/api-reference/etsy/categories/get"},{"title":"Get category properties","deprecated":null,"version":null,"sidebarTitle":"Get category properties","openapi":"/openapi.json get /v1/etsy/categories/{id}/properties","href":"/api-reference/etsy/categories/properties"},{"title":"List languages","deprecated":null,"version":null,"sidebarTitle":"List languages","openapi":"/openapi.json get /v1/etsy/languages","href":"/api-reference/etsy/languages/list"}]},{"group":"Selling","pages":[{"title":"Get listing rules","deprecated":null,"version":null,"sidebarTitle":"Get listing rules","openapi":"/openapi.json get /v1/etsy/listing-rules","href":"/api-reference/etsy/listingrules/get"},{"title":"Get fees","deprecated":null,"version":null,"sidebarTitle":"Get fees","openapi":"/openapi.json get /v1/etsy/fees","href":"/api-reference/etsy/fees/get"}]},{"group":"Countries \u0026 currencies","pages":[{"title":"List countries","deprecated":null,"version":null,"sidebarTitle":"List countries","openapi":"/openapi.json get /v1/etsy/countries","href":"/api-reference/etsy/countries/list"},{"title":"Get country","deprecated":null,"version":null,"sidebarTitle":"Get country","openapi":"/openapi.json get /v1/etsy/countries/{code}","href":"/api-reference/etsy/countries/get"},{"title":"List currencies","deprecated":null,"version":null,"sidebarTitle":"List currencies","openapi":"/openapi.json get /v1/etsy/currencies","href":"/api-reference/etsy/currencies/list"},{"title":"Get currency","deprecated":null,"version":null,"sidebarTitle":"Get currency","openapi":"/openapi.json get /v1/etsy/currencies/{code}","href":"/api-reference/etsy/currencies/get"}]},{"group":"Shipping","pages":[{"title":"Get shipping carriers","deprecated":null,"version":null,"sidebarTitle":"Get shipping carriers","openapi":"/openapi.json get /v1/etsy/shipping-carriers","href":"/api-reference/etsy/shippingcarriers/get"}]},{"group":"News \u0026 updates","pages":[{"title":"List feed","deprecated":null,"version":null,"sidebarTitle":"List feed","openapi":"/openapi.json get /v1/etsy/feed","href":"/api-reference/etsy/feed/list"},{"title":"List updates","deprecated":null,"version":null,"sidebarTitle":"List updates","openapi":"/openapi.json get /v1/etsy/updates","href":"/api-reference/etsy/updates/list"},{"title":"Get update","deprecated":null,"version":null,"sidebarTitle":"Get update","openapi":"/openapi.json get /v1/etsy/updates/{id}","href":"/api-reference/etsy/updates/get"},{"title":"List news","description":"List Etsy News: articles Alura writes for sellers, one per major Etsy change, each explaining what changed and citing Etsy's own pages. Newest story first.","deprecated":null,"version":null,"sidebarTitle":"List news","openapi":"/openapi.json get /v1/etsy/news","href":"/api-reference/etsy/news/list"},{"title":"Get article","deprecated":null,"version":null,"sidebarTitle":"Get article","openapi":"/openapi.json get /v1/etsy/news/{slug}","href":"/api-reference/etsy/news/get"}]}]},{"group":"Webhooks \u0026 events","pages":[{"group":"Webhook endpoints","pages":[{"title":"Create webhook","description":"Create a webhook endpoint: an HTTPS URL that receives your connected shops' Etsy events, filtered by event type and shop.","deprecated":null,"version":null,"sidebarTitle":"Create webhook","openapi":"/openapi.json post /v1/webhooks","href":"/api-reference/webhooks/endpoints/create"},{"title":"List webhooks","deprecated":null,"version":null,"sidebarTitle":"List webhooks","openapi":"/openapi.json get /v1/webhooks","href":"/api-reference/webhooks/endpoints/list"},{"title":"Get webhook","deprecated":null,"version":null,"sidebarTitle":"Get webhook","openapi":"/openapi.json get /v1/webhooks/{id}","href":"/api-reference/webhooks/endpoints/get"},{"title":"Update webhook","deprecated":null,"version":null,"sidebarTitle":"Update webhook","openapi":"/openapi.json patch /v1/webhooks/{id}","href":"/api-reference/webhooks/endpoints/update"},{"title":"Delete webhook","deprecated":null,"version":null,"sidebarTitle":"Delete webhook","openapi":"/openapi.json delete /v1/webhooks/{id}","href":"/api-reference/webhooks/endpoints/delete"},{"title":"Send test event","deprecated":null,"version":null,"sidebarTitle":"Send test event","openapi":"/openapi.json post /v1/webhooks/{id}/test","href":"/api-reference/webhooks/endpoints/test"},{"title":"Rotate secret","deprecated":null,"version":null,"sidebarTitle":"Rotate secret","openapi":"/openapi.json post /v1/webhooks/{id}/rotate-secret","href":"/api-reference/webhooks/endpoints/rotatesecret"}]},{"group":"Deliveries","pages":[{"title":"List deliveries","deprecated":null,"version":null,"sidebarTitle":"List deliveries","openapi":"/openapi.json get /v1/webhooks/{id}/deliveries","href":"/api-reference/webhooks/deliveries/list"}]},{"group":"Events","pages":[{"title":"List events","deprecated":null,"version":null,"sidebarTitle":"List events","openapi":"/openapi.json get /v1/events","href":"/api-reference/events/list"},{"title":"Get event","deprecated":null,"version":null,"sidebarTitle":"Get event","openapi":"/openapi.json get /v1/events/{id}","href":"/api-reference/events/get"}]}]},{"group":"Account","pages":[{"group":"Me","pages":[{"title":"Get current user","deprecated":null,"version":null,"sidebarTitle":"Get 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","pages":[{"title":"MCP","href":"/connect-ai"}]}]},"basePath":"","title":"Get article - Alura API","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}