100 free credits. No credit card required.Start building
Logo
100 free credits. No credit card required

Etsy Scraper API

Access 4 Etsy API endpoints through one unified interface for profiles, posts, comments, search, and more. When an endpoint supports a computed field and the required source inputs are present, that optional field is included in the unified response.

TL;DR

The Etsy API by SocialCrawl returns Etsy data as structured JSON: 4 endpoints behind one x-api-key, from 5 credits per call. It shares one unified schema with 53 other platforms, so the same client code works everywhere.

Live demo

Try the Etsy API in your browser

Type a real handle, run a real request, see the JSON SocialCrawl returns. No signup, no key. Same response shape you get in production.

Returns one Etsy listing by id or URL: title, description, price, images, shop name, and whether it is in stock.

Use it when you already have a listing id or etsy.com/listing URL. For listings in a shop, start at shop/products.

Try the Etsy Product API

See real data before writing a single line

GET/v1/etsy/product
5 optional parameters

Etsy listing id, the numeric id in a listing URL: etsy.com/listing/1215970085 is listing id 1215970085. Listing ids also come back on every row of GET /v1/etsy/shop/products and GET /v1/etsy/product/similar.

Full Etsy listing URL, for example https://www.etsy.com/listing/1215970085/custom-air-freshener. The listing id is extracted from the path.

Ship-to country as a two-letter code. Default US. Changes currency and copy language when the listing supports it.

ISO 4217 currency code for the displayed price. Default USD.

Listing copy locale, for example en-US, en-GB, fr, de. Default en-US.

Endpoints

What data does the Etsy API return?

Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.

Last updated September 2026

Maintained by the SocialCrawl team, reviewed September 2026

Productadvanced

Get an Etsy listing by id or URL

Shop Productsadvanced

List products in an Etsy shop

Product Similaradvanced

Get listings similar to an Etsy product

Search Suggestionsadvanced

Get Etsy search suggestions

What you get

What Etsy data can you get?

Every Etsy endpoint uses the same response envelope, so one parser handles the whole platform. These are fields returned by current public responses, subject to each endpoint's documented cache window.

Fields you get back in a Etsy response include:

  • title
  • url
  • description
Quickstart

How to scrape Etsy in 3 steps

No proxies, no headless browsers, no login sessions. Send one authenticated GET request and read structured JSON back.

  1. 1

    Get a free API key

    Create an account and copy your key from the dashboard. Signup includes 100 free credits, and no card is required.

  2. 2

    Call the Product endpoint

    Send a GET request with your key in the x-api-key header. Here is the full Etsy Product request:

    curl -H "x-api-key: YOUR_API_KEY" \
      "https://www.socialcrawl.dev/v1/etsy/product"
  3. 3

    Read the unified JSON

    The response comes back in the shared SocialCrawl schema. Where the endpoint supports them and the required source inputs are present, fields such as engagement_rate and content_category are filled in too. Your client can rely on the shared envelope while treating enriched fields as optional.

Requirements and limits

Requirements and limits

Everything you need to know before your first Etsy call.

Authentication
One API key, passed in the x-api-key request header. No OAuth flow, no app review, and no per-platform credentials to manage.
Pagination
List endpoints return a next_cursor and a has_more flag. Pass the cursor back to page through results, with the same contract on every platform.
Credits
Calls start at 5 credits and are deducted per request. Every account starts with 100 free credits, and credits never expire.
Rate limits
Two ceilings, both per API key and identical on every plan: 600 requests per minute and 50 simultaneous requests. Neither costs you a credit when it rejects a request, and past them your credit balance is the only throttle.
Pricing

How much does the Etsy API cost?

Simple credit-based pricing with no subscription. You pay per call, and the exact credit cost of every Etsy endpoint is listed below.

EndpointCredits per call
Product5 credits
Shop Products5 credits
Product Similar5 credits
Search Suggestions5 credits

Every account starts with 100 free credits, and no card is required.

At credit-pack pricing that works out to roughly £0.01 to £0.03 per call, and credits never expire.

Developer First

How do you scrape social media data in seconds?

The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 54 platforms covering 10B+ monthly active users.

One schema, every platform

Query 54 platforms with identical response structures. Write your integration once.

Computed fields, not just scraped

When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.

See your data before you code

Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}
+ 54 platforms
One API, 54 platforms

How does SocialCrawl handle 54 different platforms?

Social media scraping is hard. Schema normalization, authentication, rate limits, pagination. We handle all of it before your data arrives.

One schema, every platform

Write once, query them all.

54 platforms return 54 different JSON shapes. We normalize every response into one consistent structure.

Ready-to-use metrics

Metrics ready before you ask.

Normalized records include supported metrics such as engagement rate, estimated reach, content category, and language when the required source inputs are available.

Consistent pagination

One cursor, every platform.

Every platform paginates differently. We give you one consistent cursor-based system.

Freshness you control

Fresh when it matters. Free on repeat.

Cache misses fetch current public data. Identical requests are cached for 2 to 30 minutes by data type and cost 0 credits on a hit; send Cache-Control: no-cache for a billed refresh.

Things you'll never build

Auth, proxies, and rate limits, handled

Platform authentication, IP rotation, and rate limit management are all abstracted away. Just send a GET request.

Start for free
Reviews

What developers say

Rated 4.9 out of 5 from 200 developer reviews
The unified schema saved us weeks of integration work. One parser handles every platform.
Alex Chen, Full-Stack Developer
Our agents process social data from 54 platforms with zero platform-specific logic. One schema, end to end.
Sarah Kim, AI Engineer, AgentFlow
I paste an influencer's URL and get everything (followers, engagement rate, content categories) without touching code.
James Rivera, Marketing Director
We switched from building our own scrapers. SocialCrawl handles the hard stuff, we focus on insights.
Maria Santos, CTO, DataPulse
The computed fields alone (engagement_rate, estimated_reach, content_category) saved us an entire data pipeline.
David Park, Lead Data Scientist
Quick answers

How much does Etsy scraping cost?

SocialCrawl uses credit-based pricing: you pay per API call, and most Etsy endpoints cost just a few credits. Every account starts with 100 free credits. No subscriptions, no compute units, no credit card required.

See pricing

Is Etsy scraping legal?

SocialCrawl returns publicly available Etsy data. Courts have generally upheld scraping public data, most notably in hiQ v. LinkedIn, but compliance depends on your use case and jurisdiction. You are responsible for following applicable laws and platform terms.

Glossary

Common Etsy scraping terms

The phrases developers search for when they need Etsy data, and what each one means with SocialCrawl.

Etsy scraper API
A Etsy scraper API returns Etsy data as structured JSON without you running any scraping infrastructure. SocialCrawl handles the proxies, parsing, and format changes, so you call an endpoint and get clean fields back. Pricing starts at 5 credits per call.
Etsy data API
A Etsy data API is a programmatic way to read public Etsy data on demand. SocialCrawl exposes 4 Etsy endpoints behind one x-api-key, all sharing the same unified schema, so your integration never has to change per platform.
scrape Etsy
To scrape Etsy is to extract its public data programmatically instead of by hand. With SocialCrawl you scrape Etsy by sending a single authenticated request, and the response is normalised into the same JSON shape used across every platform.
Read the full API reference
FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
How much does the Etsy API cost?
Every Etsy endpoint costs 5 credits per call. Every account starts with 100 free credits, and there is no subscription. You only pay for the calls you make.
Is scraping Etsy data legal?
SocialCrawl returns publicly available Etsy data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with Etsy's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
Etsy scraping API vs the official Etsy API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call Etsy endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ready to start scraping Etsy data?

Get your API key and access all 4 Etsy endpoints in under 60 seconds.

Start for free

🤖 AI agent or LLM? Read this page as markdown