Skip to main content
cURL
Cost: Free.
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.
To find articles, use List news.

Authorizations

Authorization
string
header
required

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

Path Parameters

slug
string
required

The article slug (its id), such as regulatory-operating-fee-june-2026.

Maximum string length: 80
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
Example:

"us-entry-type-13-postal"

Query Parameters

fields
string

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

Response

OK

object
string
required
Allowed value: "etsy.news_article"
id
string
required

The article ID: its slug, such as regulatory-operating-fee-june-2026 (GET /v1/etsy/news/{slug}).

slug
string
required

Its permanent address, the same as id.

title
string
required

What changed, in one line.

dek
string
required

One sentence: who is affected and from when.

url
string | null
required

The article's page on alura.io (https://www.alura.io/news/{slug}).

published_at
string
required

The story's date: the day Etsy announced the change it covers, YYYY-MM-DD.

created_at
string
required

When Alura published the article (ISO 8601, UTC); a backfilled story is published long after its date.

updated_at
string
required

When Alura last changed the article (ISO 8601, UTC); a correction moves it.

topics
enum<string>[]
required

The areas of selling on Etsy it covers, as Etsy update kinds.

Required array length: 1 - 7 elements
Available options:
fees,
listing_rules,
policies,
search,
programs,
payments,
shipping
update_ids
string[]
required

The Etsy updates it explains (GET /v1/etsy/updates/{id}), the main one first.

Required array length: 1 - 20 elements
author
string
required

The byline (Alura).

body
string
required

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.

sources
object[]
required

Etsy's own pages every claim comes from, the main one first.

Required array length: 1 - 8 elements
corrections
object[]
required

Every correction made after publishing, oldest first; empty when there was none.

Maximum array length: 20