Gumroad Search Suggestions API
Up to five autocomplete product suggestions, or the marketplace's trending products for an empty query.
GET /v1/gumroad/search/suggestions1 credit Failed requests are free
About this endpoint
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.
Gumroad Search Suggestions API 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.