> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/etsy/search-suggestions>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/etsy/search-suggestions.mdx>

---

# Etsy Search Suggestions API

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

`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.

## Request

- **Endpoint:** `GET /v1/etsy/search/suggestions`
- **Credits:** 1 credit
Failed requests are free
A not-found answer is still charged
- **Input:** by partial query
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/etsy/search/suggestions/get)
- **Platform page:** [/platforms/etsy](https://www.socialfetch.dev/platforms/etsy)

## 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.
