# etsy — Etsy Open API v3 (gated)

`GET https://openapi.etsy.com/v3/application/listings/active?keywords&taxonomy_id&limit=100&offset&sort_on=created`
with `x-api-key: $ETSY_API_KEY`; images + shop via `/listings/batch?listing_ids=…&includes=Images,Shop`;
taxonomy ids resolved from `/seller-taxonomy/nodes` by node-name path (cached in the cursor).

- Money `{amount, divisor, currency_code}` → native-currency `listing` (never a sale); supplies,
  made-to-order and inactive listings skipped; `when_made` era in metadata.
- Cursor `{queryIndex, taxonomy}` rotates the keyword/taxonomy seeds; `lookup()` for `etsy.com/listing/<id>`.
- Identifier: `etsy_listing_id`.
- Fixture synthesised from the official OpenAPI schema (not a live capture — no key yet).

Credentials: https://www.etsy.com/developers/register → create app → keystring → `ETSY_API_KEY`
(commercial use requires Etsy API Terms approval).