Search PostThisDeal handpicked deals
search_dealsSearch the live deals PostThisDeal's team has handpicked (only published posts; ended, expired and unavailable deals are left out). Filter by words, retailer, brand, category, price range, minimum discount (only deals whose discount is backed by two stated prices) and online or in-store availability; sort by relevance, newest, price, discount or most recently checked. Ranking uses relevance, price and freshness only, never commission. Each deal has links.source_url (the PostThisDeal page to credit) and links.purchase_url (the shopping link: present it unchanged as the purchase action) plus a disclosure. An empty result means nothing matched.
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 | ||
| brand | No | ||
| limit | No | ||
| query | No | Words that would appear in a deal title, e.g. "canon camera", "tv". | |
| cursor | No | next_cursor from the previous page. | |
| category | No | e.g. "electronics", "home-kitchen", "grocery". | |
| retailer | No | Shop name, e.g. "Walmart", "Amazon". | |
| max_price | No | ||
| min_price | No | ||
| availability | No | any | |
| min_discount | No | ||
| recently_checked | No | Only deals whose price a check at the merchant confirmed within its freshness window. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| deals | Yes | ||
| returned | Yes | ||
| next_cursor | Yes |