Etsy API

Etsy Listing Search, Listing Details, Shop Profiles and Shop Reviews as JSON

Scrappa's read-only Etsy API turns public Etsy pages into structured JSON. Search listings with price, sale, free shipping and ship-to filters, read full listings with variations, images, materials and shipping, load shop profiles with sales count, rating and listings, and page through shop reviews. Ads are removed from search results and every filter is checked.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
4
Endpoints
Listings, shops, reviews
Data
10 credits
Per request

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Request preview
Request
curl -X GET "https://scrappa.co/api/etsy/search?query=leather+wallet&max_price=50&free_shipping=true" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response
{
  "success": true,
  "data": [],
  "pagination": {
    "page": 1,
    "has_more": true,
    "total_results": 89578,
    "filtered_out": 0,
    "sponsored_removed": 12
  },
  "currency": "USD",
  "meta": {
    "endpoint_family": "etsy-search",
    "billable": true,
    "attempts": 1,
    "credits_charged": 10
  }
}

What you can build

Structured data for real applications. Here are some ideas.

Price and Trend Monitoring

Track prices, discounts and bestseller flags for a search query with sort and price filters.

Product Research

Read variations, materials, images, shipping and favorites of any listing.

Competitor Shop Analysis

Compare shops by sales count, rating, admirers, location and their current listings.

Review Mining

Collect shop reviews with stars, text, date and the reviewed listing for sentiment analysis.

Etsy scraper API

Etsy API for listing search, product details, shops and reviews

The Etsy API is built for ecommerce teams, sellers and analysts who need Etsy marketplace data. Search a query, read the full listing, check the shop behind it and read its reviews, all as JSON.

Search listings with price, discount, rating and shop.

Filter by price range, free shipping, on sale and ship-to country.

Sort by relevance, newest, price or customer reviews.

Read variations, materials, images and shipping of a listing.

Load shop profiles with sales count and rating.

Call 4 read-only endpoints that return structured JSON.

Choose the right Etsy API endpoint

Search Etsy listings

Pass a query with a price range or free shipping. Ads are removed and every listing is checked against your filters.

Open Etsy Listing Search API docs

Read a listing and its shop

Take the listing id from a search result and request the product endpoint, then use the shop name for the shop and reviews endpoints.

Open Etsy Listing Details API docs

Available endpoints

Everything you need in one API.

Scrappa vs Do-it-yourself Etsy scraping

See how Scrappa compares to Do-it-yourself Etsy scraping.

Dedicated Etsy endpoints
Scrappa
yes (4 endpoints)
Do-it-yourself Etsy scraping
Output format
Scrappa
Structured JSON
Do-it-yourself Etsy scraping
Raw page content
Filters
Scrappa
Checked on every listing
Do-it-yourself Etsy scraping
Silently ignored by the platform
Bot protection
Scrappa
Handled by Scrappa
Do-it-yourself Etsy scraping
Your team
Request mode
Scrappa
Read-only
Do-it-yourself Etsy scraping
Depends on implementation

Key features

4 read-only endpoints
Ads removed from search results
Price, free shipping, on sale and ship-to filters that are checked
Variations, images, materials and shipping per listing
Shop profile with sales count, rating and listings
No login and no private data

Frequently asked questions

The Etsy API is Scrappa's read-only REST API for public Etsy data. It covers listing search, listing details, shop profiles and shop reviews.

No. Scrappa is an independent service and is not affiliated with or endorsed by Etsy. A Scrappa API key is used to access the endpoints on this page.

A successful request costs 10 credits because Etsy needs a full browser for each page. Errors and not found answers cost nothing.

Not yet. The reviews endpoint returns the reviews of a shop. The product endpoint returns the exact review count and a few sample reviews.

No. All Etsy endpoints on this page are read-only.

Start using the Etsy API

Sign up and get 500 free credits. No credit card required.