Endpoint Playground
Searches Etsy listings across shops for the required keywords `q`, in Etsy's default relevance order. Page with `offset` (default 0) and `limit` (default 36, max 100). The response gives the total match `count`, and each result has listing id, title, URL, image, price, shop name and rating, quantity and sold-out flag. Read `currency`, since it is not fixed to USD.
14 Oct 2026: 28 results; 11 fields had a value in every checked item.
Sample value profiles: price: 22.53 to 80.78, median 40; title: “Personalized ceramic mug, Handmade heart thumb rest coffee…” and 27 other values; url: etsy.com.
curl 'https://api.crawlora.net/api/v1/etsy/search?q=handmade+mug' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | Yes | handmade mug | Search keywords |
| offset | integer | No | 0-based result offset | |
| limit | integer | No | Page size (default 36, max 100) |
{
"code": 200,
"msg": "OK",
"data": {
"query": "handmade mug",
"offset": 0,
"count": 112886,
"results": [
{
"listing_id": "4474501681",
"title": "Custom Mermaid Mug, Crystal Handle, Mothers Day Gift",
"shop_id": "7894049",
"shop_name": "MerakiDesigned",
"price": "5371901",
"price_int": 5371901,
"currency": "VND",
"url": "https://www.etsy.com/listing/4474501681/handmade-ceramic-mermaid-mug-gold",
"quantity": 7,
"is_sold_out": false
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.