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.
- 4 routes
- Listings + shops
- 1 credit per request
- Failed requests aren't charged
Teams running monitoring, research, and enrichment pipelines
Why Social Fetch
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.
Nothing to maintain
We handle platform changes and breakages.
Built for production jobs
Run concurrent workloads with explicit statuses and request IDs.
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.
What Etsy data can you get?
4 endpoints, one API key. Every response comes back as live JSON in the same envelope.
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.
Example response
A 200 response. Live responses have the same shape with current data.
What teams build with Etsy data
Monitoring, enrichment, research and content workflows on Etsy data, on the same API as every other platform.
How it works
Your first request in three steps.
Use TypeScript or your automation tool of choice.
API key
sfk_live_••••••••••••
Free requests100
Step 1: Create your free account
Get an API key with 100 requests included.
GET/v2/instagram/profiles/charlidamelio
1 request · 1 credit
Step 2: Choose an endpoint
Pass a username, URL, keyword, or post ID.
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.
Pricing
Social data, priced simply.
Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.
Starter
18,000credits
$1.61 per 1k · $0.00161 per request
- Top up from $1.61 / 1k if you run out
- Up to 25 monitors
Growth
50,000credits
$1.58 per 1k · $0.00158 per request
- Top up from $1.58 / 1k if you run out
- 5 team seats
- Up to 100 monitors
Scale
150,000credits
$1.50 per 1k · $0.00150 per request
- 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.”
“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. 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. Pass an id, a name or a link
Call
GET /v1/etsy/listing?listing=1136507412orGET /v1/etsy/shop/listings?shop=PlanetJune. A listing or shop link works too. Sendx-api-keyon every request.3. Branch, page and bill
Check
data.lookupStatusbefore writing a row. Followpage.nextCursorwhilepage.hasMoreis true. Bill frommeta.creditsChargedand logmeta.requestIdfor 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
