Etsy

Get Etsy search suggestions

Get the searches Etsy's search box suggests for a partial query, best first.

GET/v1/etsy/search/suggestions
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
querystringrequiredquery

Text to complete, as typed into Etsy's search box, e.g. `soap` or `leather wal`.

min 1 chars · max 100 chars

Response fields
11

Endpoint-specific response payload.

datalookupStatus
string

Suggestions always have an answer.

one of: found

dataquery
string

The text completed.

Searches Etsy suggests, best first; empty when it suggests none.

datasuggestions[]query
string

A suggested search, e.g. `soap dish`.

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/search/suggestions?query=soap" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Searches Etsy suggests for the text.