Search Gumroad products
gumroad_products_searchSearch Gumroad products by query, category, tags, price, rating, and file type to find digital products matching specific buyer criteria. Supports sorting and pagination for targeted product research.
Instructions
Search Gumroad products by text, category, tags, price, rating and file type. Optional inputs: query, sort, category, tags, fileTypes and 7 more. Returns a list (use cursor when paginated).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "gumroad_products_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, 1 to 1,000. Default: 1. A search stops at 10,000 results; narrow the query or add filters for deeper pages. | |
| sort | No | How results are ordered. `hot_and_new` narrows the set to recent products with traction; the others only reorder it. Default: Gumroad's default order. | |
| tags | No | Tag names, OR-ed. Up to 10. | |
| limit | No | Rows per page, 1 to 100. Default: 20. | |
| query | No | Search text, in any language. Empty or omitted browses every product. | |
| cursor | No | Cursor from `page.nextCursor` of the previous response. It only works with the same filters; start again without it. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| category | No | Category path from the categories endpoint, e.g. `3d/3d-modeling`. An unknown path is not rejected; Gumroad ignores the filter and the results are unfiltered. | |
| maxPrice | No | Maximum price in whole units of the product's own currency, e.g. `10` for $10, not cents. The filter compares a tier or suggested price, so a row's listed price can differ. A EUR product is compared in EUR. | |
| minPrice | No | Minimum price in whole units of the product's own currency, e.g. `5` for $5, not cents. The filter compares a tier or suggested price, so a row's listed price can differ. A EUR product is compared in EUR. | |
| fileTypes | No | File types such as `pdf`, OR-ed. Up to 10. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| minRating | No | Only products rated at least this many stars, 1 to 5. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. | |
| attributeFilters | No | Category attribute filters of the form `name:value`, e.g. `product_type:script`. Requires `category`; up to 10. |