Etsy hub

Etsy Search Suggestions API

What Etsy's search box suggests as a buyer types.

GET /v1/etsy/search/suggestions

1 credit Failed requests are free A not-found answer is still charged

About this endpoint

GET /v1/etsy/search/suggestions answers the searches Etsy's search box suggests for a partial query, best first. query is the text typed so far, up to 100 characters, such as soap or leather wal.

data.suggestions lists about 11 suggestions, each with its query, such as soap dish. The list is empty when Etsy suggests nothing. Use it to find the words buyers search with, for listing titles and tags.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Etsy Search Suggestions API FAQ

What can I use the suggestions for?

Keyword research: the suggestions are searches buyers make, so they show which words to put in listing titles and tags, and how a niche is searched for.

Does it return listings?

No. It returns the suggested searches only. Read a listing with GET /v1/etsy/listing, or a shop's listings with GET /v1/etsy/shop/listings.

What if Etsy suggests nothing?

data.suggestions is an empty list. lookupStatus is always found here: an empty list is an answer, not a missing item.

How many credits does a call cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.