Etsy API by APISH

Get public Etsy data as clean, consistent JSON: etsy listing, etsy search, etsy shop, etsy shop reviews. 4 endpoints, one response shape, numbers parsed, absolute URLs.

How to use

1. Pick an Endpoint. Each option shows what it returns and its price in credits.
2. Enter its Parameters as JSON, for example {"q":"ceramic mug"}. All parameters are listed below.
3. Run. Each call becomes one row in the dataset. Use Batch to run the same endpoint for many inputs and Pages per input to follow pagination.

Pricing

Pay per event: you pay per APISH credit the call used. The price of each endpoint is in the table below. Calls that fail on our side (server errors, timeouts, blocks) are free.

Endpoints

Endpoint	Returns	Required parameters	Credits
/etsy/v1/listing	Etsy listing	—	1
/etsy/v1/search	Etsy search	q	1
/etsy/v1/shop	Etsy shop	—	1
/etsy/v1/shop_reviews	Etsy shop reviews	—	1

Output

Each dataset row has endpoint, params, status, credits_used and the endpoint's data. Add "raw": 1 to the parameters to also get the site's original record, or "fields": "a,b.c" to return only the fields you need.

Endpoint details

Etsy listing

Endpoint /etsy/v1/listing · 1 credit per successful call.

One listing: price, availability and quantity, rating and reviews, shop, description, category path, favorites, ships-from, shipping rate, returns, variations with their options and all images.

Parameters:

• url: The listing URL (https://www.etsy.com/listing/...).
• id: The listing id instead of url.

Etsy search

Endpoint /etsy/v1/search · 1 credit per successful call.

Listings for a query on etsy.com with sort, price range, free shipping, on sale, Star Seller, customizable, ship-to country and shop location filters. Etsy renders the first dozen cards of a page with full details (listings); listing_ids lists every result on the page (48) in rank order, and any of them can be passed to /etsy/v1/listing. Pass next_page back as page.

Parameters:

• q (required): Search terms.
• page: Page number. Pass next_page from the previous response.
• sort — one of relevance, price_asc, price_desc, newest, reviews: relevance (default), price_asc, price_desc, newest, reviews.
• min_price: Minimum price, USD.
• max_price: Maximum price, USD.
• free_shipping: 1 for free shipping only.
• on_sale: 1 for discounted listings only.
• star_seller: 1 for Star Seller shops only.
• customizable: 1 for customizable listings only.
• ship_to: Ship-to country code.
• location: Shop location (city, state or country).

Example parameters: {"q":"ceramic mug"}

Etsy shop

Endpoint /etsy/v1/shop · 1 credit per successful call.

A shop's profile: title, description, location, rating and review count, sales, admirers, year joined, Star Seller status, item count, announcement, and one page of its listings (about 36 per page). Pass next_page back as page for the next page; it is null on the last page.

Parameters:

• name: The shop name.
• url: The shop URL instead of name.
• page: Listings page (1 = first). Pass next_page back here.
• sort — one of custom, newest, price_asc, price_desc: Listing order: custom (the shop's own order, default), newest, price_asc or price_desc.

Etsy shop reviews

Endpoint /etsy/v1/shop_reviews · 1 credit per successful call.

A shop's buyer reviews, newest first, one page at a time: reviewer, date, stars, review text, buyer photos, the reviewed listing and the seller's reply, plus the shop's total review count. Pass next_page back as page for the next page; it is null on the last page.

Parameters:

• name: The shop name.
• url: The shop URL instead of name.
• page: Reviews page (1 = newest). Pass next_page back here.

Support

Questions, bugs or a missing field? Open an issue in this Actor's Issues tab and we will reply there.

Public data only: nothing behind a login. You are responsible for how you use the data you collect.