Get Etsy search suggestions
Get the searches Etsy's search box suggests for a partial query, best first.
Headers
Get your API keyAPI key (`sfk_...`)
Text to complete, as typed into Etsy's search box, e.g. `soap` or `leather wal`.
min 1 chars · max 100 chars
Endpoint-specific response payload.
Suggestions always have an answer.
one of: found
The text completed.
Searches Etsy suggests, best first; empty when it suggests none.
A suggested search, e.g. `soap dish`.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
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
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.