> **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/gumroad/search-suggestions>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/gumroad/search-suggestions.mdx>

---

# Gumroad Search Suggestions API

Up to five autocomplete product suggestions, or the marketplace's trending products for an empty query.

`GET /v1/gumroad/search/suggestions` takes an optional `query` and answers `{ data, meta }` with `data.lookupStatus` always `found`, `data.query` and `data.products`. Each suggestion has `name`, `url`, `sellerName` and `thumbnailUrl`.

The list is capped at five, which is the size of the search box's own dropdown. An empty or omitted `query` returns the trending products the search box shows before typing. There is no paging because the list is a fixed-size completion, not a catalog walk. Use the search route when you need a full page of matches.

## Request

- **Endpoint:** `GET /v1/gumroad/search/suggestions`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by query
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/search/suggestions/get)
- **Platform page:** [/platforms/gumroad](https://www.socialfetch.dev/platforms/gumroad)

## FAQ

### How is this different from search?

Suggestions are a fixed-size autocomplete list of up to five products for a search box. Search returns a paged catalog answer with total, facets and 1 to 100 rows. Use suggestions for type-ahead and search for results.

### What does an empty query return?

An empty or omitted query returns Gumroad's trending products, the same list the search box shows before a person types. query in the response is null in that case.

### What fields does each suggestion have?

name, url, sellerName and thumbnailUrl. It is a small record for a dropdown, not a full product record; call the product route by URL when you need price, ratings or options.

### Can a suggestion have no URL?

Yes. url and thumbnailUrl are nullable, so handle a missing product link the same way you would handle an empty list.

### How many credits does a suggestions request 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.