Etsy

Etsy Search API

Search Etsy listings with price, rating, shop and shipping, filterable by price band, free shipping and sale status. Costs 2 credits per request.

POST/api/v1/etsy/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

Search terms.

Example: ceramic mug

pageinteger

Results page, 1-based.

sortenum<string>default:relevance

relevance (Etsy's own default), lowest_price, highest_price or most_recent.

min_pricenumber

Minimum price, in the marketplace currency (USD).

max_pricenumber

Maximum price, in the marketplace currency (USD).

free_shippingboolean

Only listings that offer free shipping.

on_saleboolean

Only listings currently discounted.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
result = client.etsy.search("ceramic mug", sort="most_recent")
print(result)

Response

"query": "ceramic mug",

"page": 1,

"count": 12

"response_time": 4700

}