Skip to main content
cURL
Cost: Free.
Each article explains one or more Etsy updates in plain words for sellers. The list gives each article’s title, one-sentence dek, topics and the update_ids it explains. Get article returns the whole story.

Filter articles

Pages hold 10 articles, the most limit allows. See Pagination.

Authorizations

Authorization
string
header
required

An API key: Authorization: Bearer alura_sk_....

Query Parameters

since
string<date>

Only articles whose story date (published_at) or publishing day (created_at) is on or after this day, YYYY-MM-DD, so a backfilled story shows up when it is published.

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])))$
Example:

"2026-10-01"

kind
enum<string>

Only articles with this topic (an Etsy update kind).

Available options:
fees,
listing_rules,
policies,
search,
programs,
payments,
shipping
country
string

Only articles about an update for sellers in this country (ISO 3166-1 alpha-2, for example GB), including updates that apply everywhere.

Pattern: ^[A-Za-z]{2}$
limit
integer

Page size: at most 10, the default.

Required range: 1 <= x <= 10
cursor
string

The next_cursor of the previous page. Bound to the query, the workspace and the key.

fields
string

Comma-separated dotted paths to return; id, object and as_of always come back.

Response

OK

object
string
required
Allowed value: "list"
data
object[]
required
has_more
boolean
required
next_cursor
string | null
required
total
object
required