# Slickdeals API: Search deals > Searches community-posted Slickdeals deals by product or keyword, optionally limited to a store and hiding expired deals, ordered by relevance, newest or most popular. Unofficial. Not affiliated with or endorsed by Slickdeals. - Page: https://fous.com/methods/slickdeals.net/search-deals - Method: `slickdeals.net/search_deals`, version 1 - Website: slickdeals.net - Returns: deal title, price, currency, price as shown, original price, store, thumbs-up score, comments, posted time, expired, image, deal link, deal ID - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 3, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `sort` | string | no | `"newest"` | Result order, for example newest. One of "relevance", "newest", "most_popular". Default "relevance". | | `query` | string | yes | `"airpods"` | Product or search words, for example AirPods Pro. | | `store` | string | no | `"Amazon"` | Limit deals to a store, for example Amazon or Best Buy; leave blank for any store. Default "". | | `max_results` | integer | no | `50` | Maximum number of deals, for example 20. Default 20. | | `hide_expired` | boolean | no | `true` | Hide expired deals; for example true. Default true. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "sort": "newest", "query": "airpods", "store": "Amazon", "max_results": 50, "hide_expired": true } ``` Its output: ```json { "deals": [ { "price": 5.99, "store": "Amazon", "title": "[2 Pack] 20W USB C Charger Block Fast Charging Dual Ports Adapter $5.99", "deal_id": "20070216", "expired": false, "currency": "USD", "deal_link": "https://slickdeals.net/f/20070216-2-pack-20w-usb-c-charger-block-fast-charging-dual-ports-adapter-5-99", "posted_at": "2026-09-28T07:38:59-07:00", "image_link": "https://static.slickdealscdn.com/attachment/7/9/3/8/8/9/1/450x450/21734781.thumb", "comment_count": 0, "original_price": 6.99, "price_as_shown": "$5.99", "thumbs_up_score": 0 }, { "price": 89, "store": "Amazon", "title": "$89* | Apple AirPods 4 Wireless Earbud Headphones at Amazon", "deal_id": "20061720", "expired": false, "currency": "USD", "deal_link": "https://slickdeals.net/f/20061720-89-apple-airpods-4-wireless-earbud-headphones-at-amazon", "posted_at": "2026-09-25T09:46:00-07:00", "image_link": "https://static.slickdealscdn.com/attachment/1/1/7/1/5/2/7/450x450/21713832.thumb", "comment_count": 7, "original_price": 129, "price_as_shown": "$89", "thumbs_up_score": 2 }, { "price": 15, "store": "Amazon", "title": "Prime Members: Baseus Retractable USB-C Cable (2.5W Wireless Charger & 100W 5A Fast Charging) $15 + Free Shipping w/ Prime or orders $35+", "deal_id": "20058594", "expired": false, "currency": "USD", "deal_link": "https://slickdeals.net/f/20058594-prime-members-baseus-retractable-usb-c-cable-2-5w-wireless-charger-100w-5a-fast-charging-15-free-shipping-w-prime-or-orders-35", "posted_at": "2026-09-24T17:25:03-07:00", "image_link": "https://static.slickdealscdn.com/attachment/3/4/2/9/3/0/8/450x450/21705189.thumb", "comment_count": 1, "original_price": 24, "price_as_shown": "$15", "thumbs_up_score": 1 } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"slickdeals.net/search_deals","input":{"sort":"newest","query":"airpods","store":"Amazon","max_results":50,"hide_expired":true}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find the most popular active deals on a 65-inch OLED TV at Best Buy, top 10 please - What are the newest Slickdeals posts for Nintendo Switch 2 games? Include expired ones too. - Show me current deals on Dyson cordless vacuums with prices, original prices, and thumbs-up scores - Search slickdeals.net for Samsung T7 portable SSD deals at Amazon, sorted by relevance, max 15 results - Any recent bargains on Weber gas grills from Home Depot? Sort newest first, hide expired, give me up to 25. ## Input schema ```json { "type": "object", "required": [ "query" ], "properties": { "sort": { "enum": [ "relevance", "newest", "most_popular" ], "type": "string", "default": "relevance", "description": "Result order, for example newest." }, "query": { "type": "string", "minLength": 1, "description": "Product or search words, for example AirPods Pro." }, "store": { "type": "string", "default": "", "description": "Limit deals to a store, for example Amazon or Best Buy; leave blank for any store." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum number of deals, for example 20." }, "hide_expired": { "type": "boolean", "default": true, "description": "Hide expired deals; for example true." } } } ``` ## Output schema ```json { "type": "object", "required": [ "deals" ], "properties": { "deals": { "type": "array", "items": { "type": "object", "required": [ "title", "price", "currency", "price_as_shown", "original_price", "store", "thumbs_up_score", "comment_count", "posted_at", "expired", "image_link", "deal_link", "deal_id" ], "properties": { "price": { "type": [ "number", "null" ], "description": "Listed deal price in USD, if shown." }, "store": { "type": [ "string", "null" ], "description": "Store name, if given." }, "title": { "type": "string", "description": "Deal title." }, "deal_id": { "type": "string", "description": "Slickdeals deal ID.", "x-fous-developer": true }, "expired": { "type": "boolean", "description": "Whether the deal is expired." }, "currency": { "enum": [ "USD" ], "type": "string", "description": "Price currency." }, "deal_link": { "type": "string", "description": "Deal page link." }, "posted_at": { "type": [ "string", "null" ], "description": "Date and time the deal was posted (ISO 8601 with offset)." }, "image_link": { "type": [ "string", "null" ], "description": "Deal image link, if shown." }, "comment_count": { "type": "integer", "description": "Number of comments." }, "original_price": { "type": [ "number", "null" ], "description": "Original listed price in USD, if shown." }, "price_as_shown": { "type": [ "string", "null" ], "description": "Deal price text as shown." }, "thumbs_up_score": { "type": "integer", "description": "Net thumbs-up score." } }, "additionalProperties": false }, "description": "Matching deals in requested order." } }, "additionalProperties": false } ``` ## See more - [Slickdeals API: List popular deals](https://fous.com/methods/slickdeals.net/list-popular-deals.md): Lists current Slickdeals Frontpage deals in site order, followed by popular deals when needed, with each deal's category, or browses one category's current deals. Expired deals are left out. - [Best Buy API: Search products](https://fous.com/methods/bestbuy.com/search-products.md): Searches Best Buy US products with an optional price range, sort order and page. Prices and availability come from public listings and may vary by location. - [Reddit API: Search posts](https://fous.com/methods/reddit.com/search-posts.md): Finds public Reddit posts by topic, optionally in one community, for a time window and sort order. Returns up to 100 posts in Reddit search order with score, comment count, text and link. - [Kohl's API: Search products](https://fous.com/methods/kohls.com/search-products.md): Searches Kohl's products in site order and returns prices, offers, ratings and links for each result. - [Nintendo API: List eShop deals](https://fous.com/methods/nintendo.com/list-deals.md): Lists discounted Nintendo Switch and Switch 2 games, sorted by biggest discount, lowest price or ending soonest. Covers the US, Canada and Latin American stores and excludes downloadable add-ons. - [Macy's API: Search products](https://fous.com/methods/macys.com/search-products.md): Searches Macy's products in the site's order with optional USD price bounds, sale-only results and sorting. Prices for products with a range use the lowest shown price. - [AliExpress API: Search products](https://fous.com/methods/aliexpress.com/search-products.md): Searches AliExpress listings by product words, shipping destination, price range and sort order. Unpriced promotional cards are omitted; free shipping is marked only when the listing explicitly says so. - [Newegg API: Search products](https://fous.com/methods/newegg.com/search-products.md): Searches Newegg US for computer parts and electronics, with optional USD price range, seller restriction and sorting. Returns products in the order shown on the results page. - [All Slickdeals methods](https://fous.com/methods/slickdeals.net.md)