Etsy

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.

GET/v1/etsy/listing
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
listingstringrequiredquery

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.

Response fields
47

Endpoint-specific response payload.

datalookupStatus
string

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

datalistingId
string

The listing asked for.

The listing when found; otherwise null.

datalistinglistingId
string

Listing id.

datalistingurl
string

The listing's Etsy address.

datalistingtitle
string

Listing title.

datalistingdescription
stringnullable

The seller's description, as plain text with line breaks.

datalistingprice
numbernullable

Price as shown, in `currency`, e.g. `26.25`: the sale price when the listing is on sale.

≥ 0

datalistingoriginalPrice
numbernullable

Price before the sale, when the listing is on sale; otherwise null.

≥ 0

datalistingcurrency
stringnullable

ISO 4217 currency code of the prices, e.g. `USD`.

datalistingminPrice
numbernullable

Lowest price across the listing's options (sizes, colours, personalisation), in `currency`.

≥ 0

datalistingmaxPrice
numbernullable

Highest price across the listing's options, in `currency`.

≥ 0

datalistingavailability
stringnullable

Stock status, e.g. `in_stock` or `out_of_stock`, from the listing's offer.

datalistingquantity
integernullable

How many the shop has available, when Etsy says.

≥ 0

Pictures, in the listing's order.

datalistingimages[]url
string

Full-size picture.

datalistingimages[]thumbnailUrl
stringnullable

Small picture.

datalistingvideoUrl
stringnullable

The listing's video, when it has one.

Category from the top level down, e.g. `["Jewelry", "Earrings", "Hoop Earrings"]`.

datalistingcategoryPath[]
stringoptional
datalistingmaterial
stringnullable

Materials the seller lists, e.g. `Silver/Yellow Gold/Opal`.

The shop selling the listing.

datalistingshopshopId
stringnullable

Numeric shop id, e.g. `10204022`.

datalistingshopname
string

Shop name: pass it as `shop` to the shop listings endpoint.

datalistingshopurl
string

The shop's Etsy address.

datalistingshoplogoUrl
stringnullable

The shop's icon.

datalistingrating
numbernullable

The listing's own average review rating, 0 to 5; null when it has no reviews. Never the shop's rating.

≥ 0 · ≤ 5

datalistingreviewCount
integernullable

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).

datalistingreviews[]rating
numbernullable

Stars, 1 to 5.

≥ 0 · ≤ 5

datalistingreviews[]date
stringnullable

Day the review was written, `YYYY-MM-DD`.

datalistingreviews[]text
stringnullable

What the buyer wrote.

datalistingreviews[]author
stringnullable

The buyer's first name or user name, as Etsy shows it.

Where the listing ships from.

datalistingshipsFromcountry
stringnullable

ISO 3166 country code, e.g. `US`.

datalistingshipsFromregion
stringnullable

State or region code, e.g. `CA`.

datalistingshippingPrice
numbernullable

Shipping to the US, in `currency`; `0` for free shipping.

≥ 0

The shop's frequently asked questions, as the listing shows them.

datalistingfaqs[]question
string

The question.

datalistingfaqs[]answer
string

The shop's answer.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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`.