Endpoint Playground
Lists the listings in an Etsy shop, identified by the required `id` (a numeric shop id or a shop name). Narrow with `q` to filter within the shop's own catalogue, and page with `offset` (default 0) and `limit` (default 24). Each listing has its id, title, URL, image, price, currency, quantity, shop rating and sold-out flag.
14 Oct 2026: 24 listings; 11 fields had a value in every checked item.
Sample value profiles: price: 51.25 to 462.76, median 105.05; url: etsy.com; title: median 138 characters.
curl 'https://api.crawlora.net/api/v1/etsy/shop/gaguatelier/listings' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| id (path) | string | Yes | gaguatelier | Numeric Etsy shop id or shop name |
| q | string | No | Keyword filter within the shop's own catalog | |
| offset | integer | No | 0-based listing offset | |
| limit | integer | No | Page size (default 24) |
{
"code": 200,
"msg": "OK",
"data": {
"shop_id": "87654321",
"shop_name": "gaguatelier",
"query": "mug",
"offset": 0,
"listings": [
{
"listing_id": "1044347578",
"title": "Handmade Ceramic Mug",
"price": "$29.99",
"price_int": 2999,
"currency": "USD"
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.