New: the Scrapier MCP server. Every scraper in Claude Code with one command. See how →
GET/api/v2/etsy-product-info-by-url/

Etsy Product Info by Url Scraper

One Etsy listing as typed JSON from its URL or ID: title, price, rating, favorites, stock, shipping, tags, materials and shop details. 1 credit per listing. No Etsy login, no proxies to manage.

Free API key · 1 credit per listing · failed calls free

Last updated
// GET /api/v2/etsy-product-info-by-url/?urls=https://www.etsy.com/listing/1215970085/custom-air-freshener · sample from the catalog
{
  "success": true,
  "data": {
    "urls": "https://www.etsy.com/listing/1215970085/custom-air-freshener",
    "product": {
      "input_url": "https://www.etsy.com/listing/1215970085/custom-air-freshener",
      "listing_id": "1215970085",
      "status": "active",
      "id": "1215970085",
      "url": "https://www.etsy.com/listing/1215970085/custom-air-freshener-picture-air",
      "title": "Custom Air Freshener, Picture Air Freshener, Cute Car Accessories, Photo Freshener, Car Freshies, Car Decor",
      "description": "NEW improved print quality! We're proud to offer the highest...",
      "seller": "TheFreshener",
      "brand": "TheFreshener",
      "price": {
        "current": 12.95,
        "original": 12.95,
        "currency": "USD",
        "discount_percent": 0,
        "min": 12.95,
        "max": 12.95
      },
      "rating": {
        "average": 5,
        "count": 14661
      },
      "image_urls": [
        "https://i.etsystatic.com/35332887/r/il/e41fa0/5469863166/il_fullxfull.5469863166_6sgn.jpg"
      ],
      "availability": "in_stock"
    },
    "next_cursor": null
  }
}
Copy for your AI agent
Quick answer

Scrapier's Etsy Product Info by Url Scraper returns one Etsy listing as JSON: title, price, rating, favorites, available_quantity, shipping, tags, materials and shop_url. It costs 1 credit per successful call. Send one listing URL or listing ID per call. No Etsy login is needed.

Every request is fetched live at call time · failed calls are free

Etsy Product Info by Url Scraper extracts the public data of one Etsy listing, one listing per call: title, description, current and original price, rating and review count, favorites, stock, shipping details, tags, materials, taxonomy path and the shop behind it. Choose the ship-to country, currency and language per request. Every response is structured JSON, ready to pass directly to an LLM or a product database. It is one of 6 Etsy endpoints on the same API key used by 12,000+ developers. Next, call similar products with the same listing ID.

What data can I extract with Etsy Product Info by Url Scraper?

Using this Etsy Product Info by Url Scraper, you can extract the following data from public Etsy listings:

Listing title
Description
Price, original price and discount
Rating and review count
Favorites
Stock and availability
Shipping cost and delivery estimate
Tags
Materials
Image URLs
Seller and brand
Shop URL
Bestseller and Star Seller flags
Listed date
Taxonomy path
Next-page cursor

Want the exact field names? See the example output.

Playground

Try Etsy Product Info by Url Scraper Live

Press Run to see the catalog sample. Add your API key and it runs a real call to the Scrapier API from your browser. The key is sent only to proxy.scrapier.io and never stored.

EtsyEtsy Product Info by UrlLive

Parameters
+ Run live with your API key
Response
Sample dataCatalog sample, run to see live data

How to use Etsy Product Info by Url Scraper

Hand it to your AI assistant, or run it yourself in five steps.

Copy to your AI assistant

Paste this into ChatGPT, Claude or Cursor and it knows how to call the scraper.

Use the Scrapier Etsy Product Info by Url Scraper to get public Etsy listings. Endpoint: GET https://proxy.scrapier.io/api/v2/etsy-product-info-by-url/?urls={urls} with header "X-API-Key: YOUR_API_KEY" and a 210-second timeout. Send one value per call in urls; for a list, make one call per value, at most 3 in parallel. It returns JSON under data.product: input_url, listing_id, status, id, url, title, description, seller, brand, price, rating, image_urls. Each successful call costs 1 credit; failed calls are free. If you support MCP, run: claude mcp add -t http scrapier https://mcp.scrapier.io/mcp --header "X-API-Key: YOUR_API_KEY" and call run_scrape with endpoint "etsy-product-info-by-url" (find it with search_endpoints).
Etsy Product Info by Url Scraper MCP Server

Use this scraper from ChatGPT, Claude or Cursor. Point your assistant at Scrapier and it reads Etsy listings on its own: no glue code, no scraping logic in your prompts.

MCP setup →

Run it yourself

  1. Get your free Scrapier API keySign up at app.scrapier.io; the free tier lets you try it first.
  2. Open Etsy Product Info by Url Scraper in the catalogIt lives under Scrapers / Etsy, next to the other Etsy tools.
  3. Enter the listingPaste an Etsy listing URL such as https://www.etsy.com/listing/1215970085/custom-air-freshener or a bare listing ID in urls. Optionally set country, currency and language.
  4. Send your API requestOne GET with your key in the X-API-Key header, or one run_scrape call from your agent. This is how to scrape an Etsy product page without a browser. Set a 210-second client timeout.
  5. Save your resultsThe listing comes back as JSON in data.product: store it as is, or flatten it to CSV. A single listing has no further pages, so data.next_cursor is null.

How to scale to bulk Etsy listings

urls takes one listing per call, so for a list of listings you loop: one request per URL or ID. Run up to 3 requests in parallel per API key; above that the API answers 429 with a Retry-After header, and throttled calls cost nothing. Each call is 1 credit and failed calls are free, so 1,000 listings cost 1,000 credits, inside the Hobby plan's 15,000.

Features

This Etsy listing URL scraper turns a listing page into one record you can store, compare and monitor. It suits catalog enrichment, price checks, competitor research and any workflow that needs Etsy product data without parsing HTML.

It extracts, per listing
  • Priceprice with current, original, discount percent, min and max
  • Popularityfavorites, rating and reviews_count
  • Stockavailability and available_quantity
  • ShippingCost, origin, delivery estimate and returns in shipping
  • Metadatatags, materials and taxonomy_path
  • Localecountry, currency and language per request

Proxies, retries and parsing run on Scrapier's side, so you send one request and get JSON back, at 1 credit per listing and 0 credits for a failed call.

Use cases

  • Seller checks a competitor's listing for price, favorites and tags to decide how to title and price a similar product.
  • Catalog analyst pulls price, available_quantity and availability for a set of listings on a schedule to spot stock and price changes.
  • Market researcher reads taxonomy_path, materials and when_made across listings to compare how products in a niche are made and categorised.
  • Data engineer loads listing records into a warehouse, keyed by listing_id, with scraped_at on every row.
  • AI engineer gives an agent a tool that reads an Etsy listing, so it can answer questions about price, shipping and materials from the live page.

Running these from an agent? Use the MCP integration and let Claude or Cursor call the scraper directly.

Why choose this Scraper API?

Deep listing detail in one call.

One request returns price, stock, shipping, tags, materials and shop flags together, so you do not stitch several pages.

Your region and currency.

Set country, currency and language to see the listing as a buyer in that market does.

One key for Etsy and the rest of the catalog.

The same key and response envelope work across Scrapier's endpoints, so a search can feed a listing call without new code.

Input

The scraper takes one Etsy listing URL or bare listing ID per call in urls. It is required. Send parameters in the query string (GET) or as a JSON body (POST).

NameTypeRequiredDefaultDescription
urlsstringYes—An Etsy listing URL or bare listing ID. One record per call. Required. Aliases: url, listing_id, product_url, id
cursorstringNo—Not needed for a single listing; data.next_cursor is null. Pass a returned next_cursor back unchanged if one is ever given
countrystringNoUSShip-to country, ISO-2, default US. Locked into the cursor
currencystringNoUSDISO 4217 price currency, default USD. Locked into the cursor
languagestringNoen-USListing copy language, default en-US. Locked into the cursor
renderstringNoautoauto (default) uses HTTP with a browser fallback; http never uses a browser; browser
use_proxybooleanNotrueRoute through Scrapier's residential proxy pool, on by default. Leave as is
raw_databooleanNofalseReturn the raw upstream payloads under raw_responses instead of the formatted items

One listing per call: to read ten listings, make ten calls. Booleans are the strings true or false.

Example input

POST body · input.json
{
  "urls": "https://www.etsy.com/listing/1215970085/custom-air-freshener",
  "country": "US",
  "currency": "USD",
  "language": "en-US",
  "render": "auto",
  "use_proxy": "true",
  "raw_data": "false"
}

Error codes

StatusMeaningBilledFix
200Listing data returned in data.productYes—
400Bad or missing inputNoCheck urls: one value per call
401X-API-Key header missingNoAdd the header
402Out of credits (body has balance)NoTop up; retrying will not help
403Invalid or revoked API keyNoCheck the key in your dashboard
429ThrottledNoWait Retry-After seconds, then retry
5xxUpstream failure or timeoutNoRetry with backoff; set a 210 s client timeout

From the error reference. Any non-2xx response costs 0 credits.

Output

Typed JSON with the same schema on every call. One call returns the listing under product with 38 fields, inside the standard data envelope. Field names stay the same on every call. Set raw_data to true if you want the raw upstream payload instead.

Example output

200 OK · 1 credit · catalog sample
{
  "success": true,
  "data": {
    "urls": "https://www.etsy.com/listing/1215970085/custom-air-freshener",
    "product": {
      "input_url": "https://www.etsy.com/listing/1215970085/custom-air-freshener",
      "listing_id": "1215970085",
      "status": "active",
      "id": "1215970085",
      "url": "https://www.etsy.com/listing/1215970085/custom-air-freshener-picture-air",
      "title": "Custom Air Freshener, Picture Air Freshener, Cute Car Accessories, Photo Freshener, Car Freshies, Car Decor",
      "description": "NEW improved print quality! We're proud to offer the highest...",
      "seller": "TheFreshener",
      "brand": "TheFreshener",
      "price": {
        "current": 12.95,
        "original": 12.95,
        "currency": "USD",
        "discount_percent": 0,
        "min": 12.95,
        "max": 12.95
      },
      "rating": {
        "average": 5,
        "count": 14661
      },
      "image_urls": [
        "https://i.etsystatic.com/35332887/r/il/e41fa0/5469863166/il_fullxfull.5469863166_6sgn.jpg"
      ],
      "availability": "in_stock",
      "reviews_count": 14661,
      "seller_id": "35332887",
      "available_quantity": 80840,
      "favorites": 55433,
      "is_bestseller": true,
      "is_top_rated": true,
      "materials": [
        "Cotton"
      ],
      "taxonomy_path": "electronics_and_accessories.car_parts_and_accessories.car_accessories.car_air_fresheners",
      "when_made": "made_to_order",
      "user_id": "628346348",
      "is_star_seller": true,
      "is_etsys_pick": true,
      "state": "active",
      "tags": [
        "car freshener funny",
        "cute car air fresh",
        "funny car freshener"
      ],
      "section_name": "Custom Car Fresheners",
      "listed_on": "Sep 24, 2026",
      "created_at": "2026-09-24T11:07:33Z",
      "shop_url": "https://www.etsy.com/shop/TheFreshener",
      "shop_reviews_count": 19906,
      "urgency_signal": "In 20+ carts",
      "shipping": {
        "ships_from": "Jacksonville, FL",
        "origin_country": "US",
        "origin_region": "FL",
        "cost": 6.07,
        "cost_currency": "USD",
        "free_shipping": false,
        "free_shipping_threshold": 35,
        "estimated_delivery": "Sep 29-Oct 1",
        "accepts_returns": false,
        "accepts_exchanges": false
      },
      "country": "US",
      "currency": "USD",
      "language": "en-US",
      "scraped_at": "2026-09-24T13:31:17.054Z"
    },
    "next_cursor": null
  }
}

The catalog's sample response for urls=https://www.etsy.com/listing/1215970085/custom-air-freshener, labelled as a sample: live calls return the account's current values.

Listing

FieldTypeExampleDescription
product.idstring"1215970085"Listing ID
product.listing_idstring"1215970085"Listing ID, repeated as listing_id
product.input_urlstring"https://www.etsy.com/listing/1215970085/cus…"Your input, echoed on the row
product.urlstring"https://www.etsy.com/listing/1215970085/cus…"Canonical listing URL
product.titlestring"Custom Air Freshener, Picture Air Freshener…"Listing title
product.descriptionstring"NEW improved print quality! We're proud to …"Start of the listing description
product.statusstring"active"Listing status, for example active
product.statestring"active"Listing state, for example active
product.availabilitystring"in_stock"Stock status, for example in_stock
product.available_quantityinteger80840Units available
product.listed_onstring"Sep 24, 2026"Date the listing went live, as shown on the page
product.created_atstring"2026-09-24T11:07:33Z"Creation time, ISO 8601
product.when_madestring"made_to_order"When the item was made, for example made_to_order
product.taxonomy_pathstring"electronics_and_accessories.car_parts_and_a…"Etsy category path
product.section_namestring"Custom Car Fresheners"Shop section the listing belongs to
product.tagsarray3 itemsList of listing tags
product.materialsarray1 itemsList of materials
product.image_urlsarray1 itemsList of listing image URLs
product.urgency_signalstring"In 20+ carts"Urgency message shown on the page, for example In 20+ carts
product.languagestring"en-US"Language of the listing copy

Price and shipping

FieldTypeExampleDescription
product.priceobject{…}Object: current, original, currency, discount_percent, min and max
product.currencystring"USD"Price currency
product.countrystring"US"Ship-to country
product.shippingobject{…}Object: ships_from, origin_country, cost, free_shipping, estimated_delivery, accepts_returns and more

Ratings and popularity

FieldTypeExampleDescription
product.ratingobject{…}Object: average and count
product.reviews_countinteger14661Number of reviews
product.favoritesinteger55433Number of times favorited
product.is_bestsellerbooleantruetrue for a Bestseller listing
product.is_top_ratedbooleantruetrue for a top-rated listing
product.is_star_sellerbooleantruetrue when the shop is a Star Seller
product.is_etsys_pickbooleantruetrue for an Etsy's Pick

Shop

FieldTypeExampleDescription
product.sellerstring"TheFreshener"Shop name
product.brandstring"TheFreshener"Brand shown for the listing
product.seller_idstring"35332887"Shop ID
product.user_idstring"628346348"Seller's user ID
product.shop_urlstring"https://www.etsy.com/shop/TheFreshener"Shop URL
product.shop_reviews_countinteger19906Total reviews of the shop

Row context

FieldTypeExampleDescription
product.scraped_atstring"2026-09-24T13:31:17.054Z"UTC time the row was scraped

Response envelope and paging

FieldTypeExampleDescription
successbooleantruetrue on every 200 response
data.urlsstring"https://www.etsy.com/listing/1215970085/cus…"Your input, echoed back
data.next_cursornullnullPass back as cursor for the next page; null on the last page

How does it work?

01

Scrapier sends each request through its residential proxy pool (use_proxy, on by default), so you never manage IPs or proxy accounts.

02

Retries and parsing of Etsy's pages happen on Scrapier's side. You send one HTTP request and get typed JSON back.

03

Only publicly visible data is returned: what any visitor sees on Etsy without signing in. No Etsy account or cookie is used.

04

The schema is stable. When Etsy changes its pages, Scrapier updates the scraper; the field names in the result stay the same.

How do you integrate Etsy Product Info by Url Scraper into your stack?

It works with what you already use: any HTTP client, AI agents over MCP, and no-code automation tools. Code samples for cURL, Python and Node.js are on the API tab.

MCP integration for AI agents

claude mcp add -t http scrapier …

This registers the Scrapier MCP server, whose tools reach every Scrapier scraper, including etsy-product-info-by-url: the agent finds it with search_endpoints and calls it with run_scrape. Works with Claude Code, Cursor and Windsurf. MCP calls are billed like REST: 1 credit per successful call. Full MCP setup →

No-code tools (n8n, Make, LangChain)

n8n

Use the HTTP Request node with your Scrapier API key in an X-API-Key header and point it at /api/v2/etsy-product-info-by-url/ with a urls query parameter. Map the result list into the next node.

Make

Add an HTTP "Make a request" module with the same header and URL, and parse the response as JSON. Map title, price and favorites straight into Sheets, Airtable or your CRM.

LangChain

Wrap the endpoint in a requests-based tool, or load the Scrapier MCP server through LangChain's MCP adapters so the agent finds etsy-product-info-by-url with search_endpoints itself.

Pricing and Rate Limits

One Etsy listing costs 1 credit, so 1,000 listings cost 1,000 credits: $1.58 on the Pro plan. Failed and empty calls are not billed. Run up to 3 requests in parallel per key; above that the API answers 429 with a Retry-After header.

PlanMonthly priceCreditsListings includedPer 1,000 listings
Hobby$2915,00015,000$1.93
Pro$7950,00050,000$1.58
Scale$299250,000250,000$1.20
EnterpriseCustom volume and terms

Prices from the live billing page. See all plans and limits.

Call cost and timing

1credit per successful call
0credits for a failed call
3parallel requests per key
210srecommended client timeout

How we measure this

Credit cost, pagination and the sample come from the live catalog (GET /api/v2/endpoints, /etsy-product-info-by-url/, checked 9 Nov 2026). Concurrency and timeout guidance come from the rate limits page of the docs. Scrapier does not publish latency or success-rate figures for this endpoint, so none are shown here.

Etsy Product Info by Url Scraper vs the Official Etsy API

FeatureScrapier Etsy scraperDIY Etsy scraping
Access neededOne Scrapier API keyYour own proxies, parser and servers
Which dataOne Etsy listing by URL or ID, as Etsy shows itWhatever your parser extracts
Fields returned38 fields per listing: price, rating, favorites, stock, shipping, tags and shop flagsWhatever you build and maintain
SetupSign up, copy a key, send a requestWrite selectors, handle blocks and retries
Cost1 credit per listing, from $1.20 per 1,000 callsProxy, server and engineering time

If you need a fully custom crawler or already run your own scraping stack, DIY gives more control; Scrapier suits teams that want one key and one JSON shape across many platforms.

Frequently asked questions

What fields does Etsy Product Info by Url Scraper return?

Each listing has title, price, rating, favorites, available_quantity, shipping, tags, materials, seller and shop_url, plus flags such as is_bestseller and is_star_seller: 38 fields in data.product. Each call costs 1 credit.

Is there an Etsy API for listings?

Scrapier's Etsy Product Info by Url Scraper is a REST endpoint at /api/v2/etsy-product-info-by-url/: send a listing URL or ID and your key in the X-API-Key header, and get JSON back. It costs 1 credit per listing and failed calls are free.

How do I get an Etsy listing's price in another currency?

Set currency to an ISO 4217 code such as EUR or GBP, and country to the ship-to country, for example DE. The listing is then read for that market. Both settings are locked into the cursor, and the default is USD with US shipping.

Does it return shipping and stock details?

Yes. The shipping object holds ships_from, origin_country, cost, free_shipping, estimated_delivery and returns and exchanges flags, and available_quantity with availability shows stock. Values are those Etsy displays for the ship-to country you chose.

Can I scrape an Etsy product page with a listing ID instead of a URL?

Yes. Pass the bare numeric listing ID, such as 1215970085, in urls and the scraper resolves the listing. The response carries the canonical listing URL in url and your input in input_url, so you can match rows back to your list.

What can I send as input to Etsy Product Info by Url Scraper?

Send an Etsy listing URL, for example https://www.etsy.com/listing/1215970085/custom-air-freshener, or just the numeric listing ID in urls. It takes one value per call. Optional country, currency and language settings change how the listing is shown.

Does Etsy Product Info by Url Scraper require an Etsy account or login?

No. Etsy Product Info by Url Scraper uses no Etsy account or cookies: you send your Scrapier API key in the X-API-Key header and your input, and get JSON back. Only publicly visible data is returned.

How fast does Etsy Product Info by Url Scraper run?

Scrapier does not publish a latency figure for this endpoint. Each call reads Etsy live, so timing depends on the page. Set a client timeout of 210 seconds, as the docs recommend for every endpoint.

What happens if the input is wrong or Etsy returns nothing?

If a call fails, the API returns a non-2xx status and costs 0 credits. In code, check the status, then skip that input or retry it later. Throttled calls (429 with a Retry-After header) are free as well, so retry loops cost nothing.

Does Etsy Product Info by Url Scraper work with Claude, ChatGPT and other AI agent tools?

Yes. Connect the Scrapier MCP server with claude mcp add -t http scrapier https://mcp.scrapier.io/mcp and your API key in an X-API-Key header; it works in Claude Code, Cursor and Windsurf. The agent finds etsy-product-info-by-url with search_endpoints and calls it with run_scrape. Any agent that can call an HTTP endpoint can use the REST API directly.

How much does it cost to run Etsy Product Info by Url Scraper 1,000 times?

1,000 credits, because each call is 1 credit. That is about $1.93 on Hobby, $1.58 on Pro and $1.20 on Scale, at the plans' price per credit. Failed calls are free.

How do I use Etsy Product Info by Url Scraper with Python?

For an Etsy scraper in Python, send a GET request with the requests library to https://proxy.scrapier.io/api/v2/etsy-product-info-by-url/ with params={"urls": "https://www.etsy.com/listing/1215970085/custom-air-freshener"}, your key in the X-API-Key header and timeout=210. Read r.json()["data"]["product"]: it is already JSON, so no HTML parsing is needed.

Your feedback

Found a bug or missing a field? Let us know. Write to support@scrapier.io and the team replies to every report.

Get started

Start Scraping Etsy Listings

Public Etsy listings as JSON, 1 credit each, from REST or MCP.