# 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).