curl "https://api.alura.io/v1/etsy/feed?since=2026-10-01" \
-H "Authorization: Bearer $ALURA_API_KEY"const res = await fetch('https://api.alura.io/v1/etsy/feed?since=2026-10-01', {
headers: {
Authorization: `Bearer ${process.env.ALURA_API_KEY}`,
},
});
console.log(await res.json());import json
import os
import urllib.request
request = urllib.request.Request(
"https://api.alura.io/v1/etsy/feed?since=2026-10-01",
headers={
"Authorization": f"Bearer {os.environ['ALURA_API_KEY']}",
},
)
with urllib.request.urlopen(request) as response:
print(json.load(response)){
"object": "list",
"data": [
{
"object": "etsy.update",
"id": "2026-10-20-share-and-save-holiday-refund",
"kind": "fees",
"title": "Share & Save refunds the full 6.5% transaction fee through January 4, 2027",
"summary": "From October 20, 2026 through January 4, 2027, sellers enrolled in Share & Save get the full 6.5% transaction fee refunded on eligible orders that come through their Share & Save links, up from the usual 4%. The refund returns to 4% after January 4, 2027.",
"status": "in_effect",
"announced_at": "2026-10-20",
"effective_at": "2026-10-20",
"countries": null,
"affects": [
{
"type": "fee",
"key": "share_and_save_refund"
},
{
"type": "program",
"key": "share_and_save"
}
],
"sources": [
{
"url": "https://community.etsy.com/forum/announcements-290/topic/our-share-save-holiday-gift-to-you-190476/",
"title": "Our Share & Save holiday gift to you",
"publisher": "Etsy",
"published_at": "2026-10-20",
"read_at": null
},
{
"url": "https://help.etsy.com/hc/en-us/articles/16981332744087",
"title": "How to Save on Etsy Fees with the Share & Save Program",
"publisher": "Etsy",
"published_at": "2026-10-20",
"read_at": null
}
],
"news_slug": "share-and-save-holiday-refund",
"updated_at": "2026-10-22T09:00:00.000Z"
},
{
"object": "etsy.news_article",
"id": "share-and-save-holiday-refund",
"slug": "share-and-save-holiday-refund",
"title": "Share & Save refunds the full 6.5% transaction fee through January 4, 2027",
"dek": "Sellers enrolled in Share & Save get the whole transaction fee back on eligible orders from their own links from October 20, 2026 through January 4, 2027.",
"url": "https://www.alura.io/news/share-and-save-holiday-refund",
"published_at": "2026-10-20",
"created_at": "2026-10-22T09:00:00.000Z",
"updated_at": "2026-10-22T09:00:00.000Z",
"topics": [
"fees",
"programs"
],
"update_ids": [
"2026-10-20-share-and-save-holiday-refund"
],
"author": "Alura"
},
{
"object": "etsy.update",
"id": "2026-10-19-us-entry-type-13",
"kind": "shipping",
"title": "US requires electronic Entry Type 13 filing for postal parcels from January 20, 2027",
"summary": "From January 20, 2027, international postal packages worth $2,500 USD or less entering the US must be filed electronically in US Customs' ACE system under Entry Type 13, with shipment-level data and any documents US agencies such as the FDA or CPSC require. Etsy says packages without the required customs information may be held or returned, and recommends connecting the shop to a free Zonos Verified Account.",
"status": "announced",
"announced_at": "2026-10-19",
"effective_at": "2027-01-20",
"countries": null,
"affects": [],
"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
}
],
"news_slug": "us-entry-type-13-postal",
"updated_at": "2026-10-22T09:00:00.000Z"
},
{
"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"
},
{
"object": "etsy.news_article",
"id": "regulatory-operating-fee-june-2026",
"slug": "regulatory-operating-fee-june-2026",
"title": "Etsy changes the regulatory operating fee in 7 countries, with France rising to 1.14%",
"dek": "Sellers based in France, Hungary, India, Italy, Spain, Türkiye and the UK pay new rates from June 22, 2026, and Canada's rate has fallen to 0.50% with no start date from Etsy.",
"url": "https://www.alura.io/news/regulatory-operating-fee-june-2026",
"published_at": "2026-04-22",
"created_at": "2026-10-22T09:00:00.000Z",
"updated_at": "2026-10-22T09:00:00.000Z",
"topics": [
"fees"
],
"update_ids": [
"2026-06-22-regulatory-operating-fee-changes",
"2026-06-22-regulatory-operating-fee-canada-cut"
],
"author": "Alura"
}
],
"has_more": false,
"next_cursor": null,
"total": {
"value": 5,
"relation": "eq"
}
}{
"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"
}{
"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"
}{
"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"
}{
"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"
}List feed
List Etsy updates and Etsy News articles in one timeline, newest first, to show everything that changed on Etsy in one place.
curl "https://api.alura.io/v1/etsy/feed?since=2026-10-01" \
-H "Authorization: Bearer $ALURA_API_KEY"const res = await fetch('https://api.alura.io/v1/etsy/feed?since=2026-10-01', {
headers: {
Authorization: `Bearer ${process.env.ALURA_API_KEY}`,
},
});
console.log(await res.json());import json
import os
import urllib.request
request = urllib.request.Request(
"https://api.alura.io/v1/etsy/feed?since=2026-10-01",
headers={
"Authorization": f"Bearer {os.environ['ALURA_API_KEY']}",
},
)
with urllib.request.urlopen(request) as response:
print(json.load(response)){
"object": "list",
"data": [
{
"object": "etsy.update",
"id": "2026-10-20-share-and-save-holiday-refund",
"kind": "fees",
"title": "Share & Save refunds the full 6.5% transaction fee through January 4, 2027",
"summary": "From October 20, 2026 through January 4, 2027, sellers enrolled in Share & Save get the full 6.5% transaction fee refunded on eligible orders that come through their Share & Save links, up from the usual 4%. The refund returns to 4% after January 4, 2027.",
"status": "in_effect",
"announced_at": "2026-10-20",
"effective_at": "2026-10-20",
"countries": null,
"affects": [
{
"type": "fee",
"key": "share_and_save_refund"
},
{
"type": "program",
"key": "share_and_save"
}
],
"sources": [
{
"url": "https://community.etsy.com/forum/announcements-290/topic/our-share-save-holiday-gift-to-you-190476/",
"title": "Our Share & Save holiday gift to you",
"publisher": "Etsy",
"published_at": "2026-10-20",
"read_at": null
},
{
"url": "https://help.etsy.com/hc/en-us/articles/16981332744087",
"title": "How to Save on Etsy Fees with the Share & Save Program",
"publisher": "Etsy",
"published_at": "2026-10-20",
"read_at": null
}
],
"news_slug": "share-and-save-holiday-refund",
"updated_at": "2026-10-22T09:00:00.000Z"
},
{
"object": "etsy.news_article",
"id": "share-and-save-holiday-refund",
"slug": "share-and-save-holiday-refund",
"title": "Share & Save refunds the full 6.5% transaction fee through January 4, 2027",
"dek": "Sellers enrolled in Share & Save get the whole transaction fee back on eligible orders from their own links from October 20, 2026 through January 4, 2027.",
"url": "https://www.alura.io/news/share-and-save-holiday-refund",
"published_at": "2026-10-20",
"created_at": "2026-10-22T09:00:00.000Z",
"updated_at": "2026-10-22T09:00:00.000Z",
"topics": [
"fees",
"programs"
],
"update_ids": [
"2026-10-20-share-and-save-holiday-refund"
],
"author": "Alura"
},
{
"object": "etsy.update",
"id": "2026-10-19-us-entry-type-13",
"kind": "shipping",
"title": "US requires electronic Entry Type 13 filing for postal parcels from January 20, 2027",
"summary": "From January 20, 2027, international postal packages worth $2,500 USD or less entering the US must be filed electronically in US Customs' ACE system under Entry Type 13, with shipment-level data and any documents US agencies such as the FDA or CPSC require. Etsy says packages without the required customs information may be held or returned, and recommends connecting the shop to a free Zonos Verified Account.",
"status": "announced",
"announced_at": "2026-10-19",
"effective_at": "2027-01-20",
"countries": null,
"affects": [],
"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
}
],
"news_slug": "us-entry-type-13-postal",
"updated_at": "2026-10-22T09:00:00.000Z"
},
{
"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"
},
{
"object": "etsy.news_article",
"id": "regulatory-operating-fee-june-2026",
"slug": "regulatory-operating-fee-june-2026",
"title": "Etsy changes the regulatory operating fee in 7 countries, with France rising to 1.14%",
"dek": "Sellers based in France, Hungary, India, Italy, Spain, Türkiye and the UK pay new rates from June 22, 2026, and Canada's rate has fallen to 0.50% with no start date from Etsy.",
"url": "https://www.alura.io/news/regulatory-operating-fee-june-2026",
"published_at": "2026-04-22",
"created_at": "2026-10-22T09:00:00.000Z",
"updated_at": "2026-10-22T09:00:00.000Z",
"topics": [
"fees"
],
"update_ids": [
"2026-06-22-regulatory-operating-fee-changes",
"2026-06-22-regulatory-operating-fee-canada-cut"
],
"author": "Alura"
}
],
"has_more": false,
"next_cursor": null,
"total": {
"value": 5,
"relation": "eq"
}
}{
"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"
}{
"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"
}{
"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"
}{
"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"
}curl -G "https://api.alura.io/v1/etsy/feed" \
-H "Authorization: Bearer $ALURA_API_KEY" \
--data-urlencode "since=2026-10-01" \
--data-urlencode "country=GB"
| Endpoint | What you get | Use it for |
|---|---|---|
| List updates | Etsy’s changes as dated records: status, the fee and rule keys they change, Etsy’s own pages | Code that tracks or reacts to changes |
| List news | Articles Alura writes for sellers, one per major change, each explaining one or more updates | Showing people what changed and what it means |
| List feed | Updates and articles in one list, newest first | One timeline of both |
object says what it is:
etsy.update: an update, as List updates gives it, placed by the day Etsy announced it.etsy.news_article: an article, as List news gives it (without the story’s body), placed by its story date.
Filter the feed
| Filter | Updates | Articles |
|---|---|---|
since | Announced or taking effect on or after the day | Story date or the day Alura published it is on or after the day |
kind | Of this kind | With this topic |
country | For sellers in this country, or for everywhere | About updates for this country, or for everywhere |
status | With this status: announced, in_effect or withdrawn | Not filtered |
limit allows. See Pagination.Authorizations
An API key: Authorization: Bearer alura_sk_....
Query Parameters
Only updates announced or taking effect on or after this day, and articles whose story date or publishing day is on or after it, YYYY-MM-DD.
^(?:(?:\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])))$"2026-10-01"
Only updates of this kind, and articles with this topic.
fees, listing_rules, policies, search, programs, payments, shipping Only updates for sellers in this country (ISO 3166-1 alpha-2) and articles about them, including those that apply everywhere.
^[A-Za-z]{2}$Only updates with this status; articles are not filtered by it.
announced, in_effect, withdrawn Page size: at most 10, the default.
1 <= x <= 10The next_cursor of the previous page. Bound to the query, the workspace and the key.
Comma-separated dotted paths to return; id, object and as_of always come back.