Etsy API

Etsy Scraper API for Listings, Shops and Reviews

Search listings with complete result cards, browse shop inventories, read shop and listing reviews and see the similar items Etsy recommends. Keep product details connected to the people selling them.

WHAT YOU CAN BUILD / 08 ENDPOINTS

Put Etsy data to work.

Find your use case, then explore the request and response.

Get an Etsy shop profile

GET/v1/etsy/shop

Build a handmade seller directory from shop identity, descriptions, seller information and shop statistics.

List an Etsy shop's items

GET/v1/etsy/shop/listings

Build a shop catalog browser by collecting an Etsy seller’s listings and their product information.

List an Etsy shop's reviews

GET/v1/etsy/shop/reviews

Build a shop reputation report from a seller’s customer reviews, ratings and review text.

Get an Etsy listing

GET/v1/etsy/listing

Build product comparison pages with an Etsy listing’s images, price, variations and product details.

Get Etsy listing reviews

GET/v1/etsy/listing/reviews

Build a product feedback report from the ratings and written reviews attached to a specific Etsy listing.

Get similar Etsy listings

GET/v1/etsy/listing/similar

Build a related-products gallery using listings similar to the Etsy item you are researching.

Search Etsy listings

GET/v1/etsy/search

Build a handmade product finder by turning keyword searches and listing filters into product results.

Get Etsy search suggestions

GET/v1/etsy/search/suggestions

Build a keyword discovery tool using Etsy’s suggested completions for a product search phrase.

HOW IT WORKS

From API key to Etsy data in four steps.

Run a sample below without a key.

  1. 01

    Get your API key

    Create a free account and copy your key. You start with 100 free credits; no card needed.

  2. 02

    Choose an endpoint

    Pick one of the 8 Etsy endpoints and add its input, such as a search query.

  3. 03

    Send one request

    Call it with your key in the x-api-key header. ScrapeAtlas reads the public Etsy data and retries when a read fails.

  4. 04

    Use the JSON

    Get structured JSON with a coverage status. Only successful requests use a credit.

TRY IT HERE / LIVE SAMPLE

Try a sample request.

Try the Etsy API right here. This sample uses the Search Etsy listings endpoint and returns live JSON. No API key needed.

  1. 01
    Choose a sample value

    Start with leather journal, or change the query field to your own value.

  2. 02
    Select Run sample

    Execute the sample code and see the response in the JSON response tab.

  3. 03
    Build on the result

    Open the full playground to try more parameters and copy code for your app.

Open this endpoint in the playground Request and response fields
LIVE SAMPLE / Search Etsy listingsNo API key needed

Preparing the sample…

// Run this sample here — no API key needed.
const value = "leather journal";
const url = new URL("/website/demo/etsy",
  "https://api.scrapeatlas.com");
url.searchParams.set("value", value);

const response = await fetch(url);
const data = await response.json();
console.log(data);
GET/v1/etsy/search

A live example from our playground. Change the value above, then select Run sample.

CUSTOMER STORIES

What they are saying
about us.

Nigel Yong — Founder, PostOnce

Pay as you go

Start free.
Build at your pace.

One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.

Free

Try the API with your next idea.

$0No credit card needed

100 free credits

One starter grant per account

Starter

For a new idea or a one-off project.

$19USD / one-time

10,000 credits

$1.90 per 1,000 successful requests

Growth

Save 6.3%

For regular workflows and bigger builds.

$89USD / one-time

50,000 credits

$1.78 per 1,000 successful requests

Enterprise Plan

Want to scrape larger volumes?

Let’s talk about a plan that fits your scale.

Etsy API

Frequently Asked Questions

Explore the API reference

Etsy API and scraping

What shop and product data does the Etsy API provide?

Retrieve shop profiles, listings, buyer reviews, product variations, pricing and images. Search Etsy listings, collect autocomplete suggestions or retrieve similar products to build a handmade product research workflow.

How do I scrape Etsy listing details and customer reviews?

Pass a listing to Listing Details for its description, seller, prices, images, materials and variations. Use Listing Reviews for buyer feedback, rating summaries, sorting options and star-rating filters.

Can the Etsy API help me discover similar products?

Use Similar Listings to retrieve products related to a selected listing. Follow up with Listing Details for the items you want to compare, bringing their descriptions, pricing, materials and variations into your research view.

Etsy: shop catalogs and product research

Can the Etsy search API find products by keyword?

Yes. Search Listings returns matching listing IDs and product cards with shop information, prices, discounts, ratings and badges. Search Suggestions supplies autocomplete terms for a partial query.

How can I retrieve an Etsy shop’s products and reviews?

Use Shop Listings to browse the seller’s catalog by section, sort and page. Shop Reviews returns customer ratings, written feedback, purchased listings and seller responses. Shop Profile adds the shop’s identity, sales counts and item-section information.

Can I retrieve Etsy listing variations and product materials?

Yes. Listing Details returns materials and variations alongside the description, seller, prices and images. Use these attributes to compare product options or describe a listing in a handmade product catalog.

API access and integration

How do I get a ScrapeAtlas API key and authenticate requests?

Create a ScrapeAtlas account and generate an API key in the dashboard. Send the key in the x-api-key request header when calling https://api.scrapeatlas.com. The API playground lets you enter an endpoint’s parameters and inspect its JSON response.

Can I call the scraping API from Python, JavaScript or the CLI?

Yes. Send authenticated HTTP requests from Python, JavaScript or another language that supports HTTP. The endpoint reference includes request examples and response fields. Use the ScrapeAtlas CLI for terminal workflows and pass the returned pagination values when requesting additional result pages.

Can I connect an AI assistant to the ScrapeAtlas MCP server?

Yes. Connect an MCP-compatible assistant to the ScrapeAtlas MCP server to discover and call the public platform tools with your ScrapeAtlas account. The agent reference also gives coding assistants a readable guide to the endpoints and their request schemas.

Make something with it

Ready to build?

Bring social data into your next project.
Start with 100 free credits and see what you can build.

No credit card needed.Building with an AI agent?