Skip to main content
cURL
Cost: Free.
Each entry’s 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.
On the same day, updates come before articles.

Filter the feed

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

Authorizations

Authorization
string
header
required

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

Query Parameters

since
string<date>

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.

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 updates of this kind, and articles with this topic.

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

Only updates for sellers in this country (ISO 3166-1 alpha-2) and articles about them, including those that apply everywhere.

Pattern: ^[A-Za-z]{2}$
status
enum<string>

Only updates with this status; articles are not filtered by it.

Available options:
announced,
in_effect,
withdrawn
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