Get Etsy listing
Get an Etsy listing by id or URL, with its price and sale price, pictures, category, materials, shop, rating, newest reviews and shipping origin.
Headers
Get your API keyAPI key (`sfk_...`)
Etsy listing id, e.g. `1136507412`: the number in a listing's address. A listing URL such as https://www.etsy.com/listing/1136507412/ is also accepted.
Endpoint-specific response payload.
Whether the item was found. `not_found` covers an id or name that doesn't exist and a listing or shop that was removed or closed (Etsy doesn't tell those apart).
one of: found, not_found
The listing asked for.
The listing when found; otherwise null.
Listing id.
The listing's Etsy address.
Listing title.
The seller's description, as plain text with line breaks.
Price as shown, in `currency`, e.g. `26.25`: the sale price when the listing is on sale.
≥ 0
Price before the sale, when the listing is on sale; otherwise null.
≥ 0
ISO 4217 currency code of the prices, e.g. `USD`.
Lowest price across the listing's options (sizes, colours, personalisation), in `currency`.
≥ 0
Highest price across the listing's options, in `currency`.
≥ 0
Stock status, e.g. `in_stock` or `out_of_stock`, from the listing's offer.
How many the shop has available, when Etsy says.
≥ 0
Pictures, in the listing's order.
Full-size picture.
Small picture.
The listing's video, when it has one.
Category from the top level down, e.g. `["Jewelry", "Earrings", "Hoop Earrings"]`.
Materials the seller lists, e.g. `Silver/Yellow Gold/Opal`.
The shop selling the listing.
Numeric shop id, e.g. `10204022`.
Shop name: pass it as `shop` to the shop listings endpoint.
The shop's Etsy address.
The shop's icon.
The listing's own average review rating, 0 to 5; null when it has no reviews. Never the shop's rating.
≥ 0 · ≤ 5
How many reviews of this listing the rating counts; 0 when it has none.
≥ 0
The newest reviews the listing page shows (up to 4).
Stars, 1 to 5.
≥ 0 · ≤ 5
Day the review was written, `YYYY-MM-DD`.
What the buyer wrote.
The buyer's first name or user name, as Etsy shows it.
Where the listing ships from.
ISO 3166 country code, e.g. `US`.
State or region code, e.g. `CA`.
Shipping to the US, in `currency`; `0` for free shipping.
≥ 0
The shop's frequently asked questions, as the listing shows them.
The question.
The shop's answer.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/etsy/listing?listing=1136507412" \
-H "x-api-key: YOUR_API_KEY"Responses
The listing, or `not_found`.