Search deals
search_dealsFind current offers PostThisDeal tracks that match a need and budget. Results are the best of the offers PostThisDeal tracks, not every store. Each carries its freshness (confirmed, due, overdue or not independently verified), a status block with the separate facts (verification: independent|merchant|none; freshness; availability; price: matched|changed|variable|unknown; publication), conditions and unknowns. Withdrawn offers are never returned. Give memberships to leave out prices the shopper cannot get.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_deals"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | ||
| limit | No | ||
| query | No | What the shopper wants, in words that would appear in a product title. | |
| country | No | ISO 3166-1 alpha-2 country of delivery. | |
| category | No | Category slug. | |
| currency | No | ISO 4217, default USD. | |
| retailer | No | Retailer slug, e.g. walmart, target, amazon. | |
| max_price | No | Budget for one item. | |
| fresh_only | No | Only offers confirmed inside the freshness window right now (use this before calling a price current). | |
| memberships | No | Programmes the shopper holds: amazon_prime, walmart_plus, target_circle_360, target_circle_card, costco_member, sams_club, kohls_rewards, student, store_card. Omit if unknown. | |
| verified_only | No | Only offers whose price was confirmed at the retailer at some point (the confirmation may be due for a re-check: read freshness.state). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| total | No | ||
| offers | No |