All platformsLive Etsy data

Etsy API. Listings, shops and prices as JSON.

A listing with its price, pictures, shop and newest reviews, every active listing in a shop, the listings Etsy recommends beside one, and search box suggestions. 4 routes under /v1/etsy, one credit per request.

No credit card requiredRead the API docs
  • 4 routes
  • Listings + shops
  • 1 credit per request
  • Failed requests aren't charged
99.8% uptime#3 Product of the Day3,200+ developers

Teams running monitoring, research, and enrichment pipelines

Etsy data as JSON. You build the product.

Live Etsy data in one response shape, with platform changes handled for you.

Etsy, plus every other platform

One key and one response envelope for Etsy and 86 more platforms.

  • API key

    sk_live_••••••••

Pricing you can reason about

One request, one credit. Know how far your balance will go before you run your next batch.

Requests
480
Credits
480

Balance

Live data on every request

Fetch public data when you ask for it.

Just now1h ago

Nothing to maintain

We handle platform changes and breakages.

Built for production jobs

Run concurrent workloads with explicit statuses and request IDs.

req_8f42200
req_a91c200
req_3e07200
req_d5b8200

lookupStatus: found

Regular jobs. Better rates.

Running lookups every month? Get lower per-credit rates with a monthly plan. For occasional projects, choose pay as you go.

MonthlyLower rate
Pay as you go

Example request

GET /v1/etsy/listing. Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON
Use cases

What teams build with Etsy data

Monitoring, enrichment, research and content workflows on Etsy data, on the same API as every other platform.

Track prices and sales

Follow the prices, sales, stock and ratings of listings and shops in your niche, yours or a competitor's.

Research a niche

Read what a shop sells, what Etsy recommends beside a product and what buyers type into search.

How it works

Your first request in three steps.

Use TypeScript or your automation tool of choice.

  1. API key

    sfk_live_••••••••••••

    Free requests100

    Step 1: Create your free account

    Get an API key with 100 requests included.

  2. GET/v2/instagram/profiles/charlidamelio

    1 request · 1 credit

    Step 2: Choose an endpoint

    Pass a username, URL, keyword, or post ID.

  3. 200 OK1.82s

    {

    "handle": "charlidamelio",

    "displayName": "Charli D'Amelio",

    "followers": 48300000,

    "following": 1284

    }

    Step 3: Get clean JSON

    Use the response immediately or send it into your pipeline.

Works with your stack

Code, automate, or connect your AI.

Explore integrations

Pricing

Social data, priced simply.

Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.

Starter

$29.00

18,000credits

  • Top up from $1.61 / 1k if you run out
  • Up to 25 monitors
Most popular

Growth

$79.00

50,000credits

  • Top up from $1.58 / 1k if you run out
  • 5 team seats
  • Up to 100 monitors

Scale

$225.00

150,000credits

  • Top up from $1.50 / 1k if you run out
  • 25 team seats
  • Up to 250 monitors
  • Cancel anytime
  • 30-day money-back guarantee
  • Price locked while you stay

Need 1M+ credits, invoicing, or volume rates? Talk to us

Trust signals

DevHunt

Product Hunt

Uneed

Customers

Teams building on Social Fetch.

“Our TikTok and Instagram scrapers broke constantly. Social Fetch took us off that rotation — we ship product again.”

Daniel Reeve · Founder, Social Crow
  • “A maker pastes one link and Social Fetch fills in their bio and socials. Most of inko runs on it, and it just works.”

    Jade P. · Founder, inko
  • “Live profile data on every request. We never flag accounts from a stale cache.”

    Hannah Webb · Founder, Scam Finder
  • “Heavy concurrent load, no rate limits to negotiate. The rare API I haven't wrapped in retries.”

    Owen Pritchard · Founder, IP Flare

Etsy API: common questions

Is there an Etsy API for listings and shops?

Yes. Social Fetch has 4 Etsy routes under /v1/etsy: a listing, similar listings, a shop's listings and search suggestions. Authenticate with your Social Fetch API key in x-api-key.

What is a listing id, and where do I find one?

Etsy's number for a listing: the number in its address, so https://www.etsy.com/listing/1136507412/opal-inlay-huggie-earrings-set-by is 1136507412. Every row of a shop's listings and the similar listings carries it as listingId. You can also pass the link itself.

How do I list every product in an Etsy shop?

Call GET /v1/etsy/shop/listings with the shop's name, such as PlanetJune, or its link. Follow page.nextCursor while page.hasMore is true; page.totalListings counts the whole catalogue. The list stops at page 100 and says so with truncated.

Do I get sale prices?

Yes. price is the price as shown, the sale price when the listing is on sale, and originalPrice is the price before the sale. On a listing, minPrice and maxPrice give the range across its options. Prices are in US dollars.

Which reviews are included?

A listing carries its rating, its review count and the newest reviews its page shows, up to 4, each with the stars, date, text and the buyer's name as Etsy shows it. A shop carries its own rating and review count.

How much does the Etsy API cost?

Every Etsy route charges 1 credit per completed request. New accounts start with 100 free credits. Check meta.creditsCharged on each response for the amount actually billed.

Does HTTP 200 mean the listing exists?

No. HTTP 200 means the request finished. Check data.lookupStatus: found means it was read, not_found means no listing or shop has the id or name, or it was removed or closed.

The Etsy API in detailHow the Etsy routes work, what they cost, and how they differ from the official API.

Why teams use Social Fetch for Etsy

Social Fetch exposes 4 routes under /v1/etsy. Every response uses the { data, meta } envelope, and the listing and shop routes carry data.lookupStatus: found or not_found. HTTP 200 only means the request finished, so branch on lookupStatus before storing a row.

Etsy names every listing by a numeric id, the number in its address (/listing/1136507412/... is 1136507412), and every shop by its name, the last part of its address (/shop/PlanetJune). Each route takes either the id or name, or the Etsy link itself. Prices are in US dollars, as a visitor to the US site sees them.

GET /v1/etsy/listing reads one listing with its title, description, price and sale price, the price range across its options, stock, pictures, video, category, materials, shop, rating, newest reviews, where it ships from and the shop's FAQs. GET /v1/etsy/listing/similar lists the listings Etsy recommends beside it, with ads kept and marked. GET /v1/etsy/shop/listings reads a shop (headline, location, owners, rating, review and sales counts) with one page of its active listings, 36 a page, in the shop's order, newest first or by price. GET /v1/etsy/search/suggestions answers the searches Etsy's search box suggests for a partial query.

How to call the Etsy API

  1. 1. Create an API key

    Sign up at Social Fetch and copy a key (sfk_…). New accounts get 100 free credits, enough to try every Etsy route on real listings and shops.

  2. 2. Pass an id, a name or a link

    Call GET /v1/etsy/listing?listing=1136507412 or GET /v1/etsy/shop/listings?shop=PlanetJune. A listing or shop link works too. Send x-api-key on every request.

  3. 3. Branch, page and bill

    Check data.lookupStatus before writing a row. Follow page.nextCursor while page.hasMore is true. Bill from meta.creditsCharged and log meta.requestId for support.

What each Etsy route returns

  • Any listing by id or Etsy link: title, description, price, sale price, price range across options, stock and quantity.
  • Listing pictures and video, category path, materials, the shop selling it and where it ships from, with US shipping price.
  • The listing's rating, review count and newest reviews, plus the shop's frequently asked questions.
  • A shop by name or link: headline, location, owners, logo, banner, rating, review count and sales count.
  • Every active listing in a shop, 36 a page, in the shop's own order, newest first or by price, with sale prices and free shipping.
  • The listings Etsy recommends beside a listing, with ads marked.
  • The searches Etsy's search box suggests for a partial query, best first.

How much does the Etsy API cost?

Every Etsy route charges 1 credit per completed request, a not-found answer included. Each page of a shop's listings is its own request. Credits never expire on pay-as-you-go packs. meta.creditsCharged on every response is the billing source of truth.

Social Fetch vs the official Etsy API

Etsy's own Open API is built for sellers and approved apps: it needs a registered app and key, and requests are rate limited per app. Social Fetch returns the public listings, shops and suggestions any visitor sees, with no app to register, under one JSON envelope with typed lookupStatus values and absolute links. Pictures are linked, never rehosted.

Pull your first Etsy data.

Run a live Etsy request in the playground. 100 free credits, no card, JSON back in seconds.

No credit cardSign up in 30 seconds withGoogleGitHub