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.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Sort optional
sort Result order, for example newest.
newest
One of
relevance,newest,most_popular. Defaultrelevance.- Query, required
query Product or search words, for example AirPods Pro.
airpods
- Store optional
store Limit deals to a store, for example Amazon or Best Buy; leave blank for any store.
Amazon
Default
.- Max Results optional
max_results Maximum number of deals, for example 20.
50
Whole number from 1 to 50. Default
20.- Hide Expired optional
hide_expired Hide expired deals; for example true.
true
True or false. Default
true.
Input as JSON
{ "sort": "newest", "query": "airpods", "store": "Amazon", "max_results": 50, "hide_expired": true}Output
{ "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 } ]}Code
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}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "slickdeals.net/search_deals" , "input": { "sort": "newest", "query": "airpods", "store": "Amazon", "max_results": 50, "hide_expired": True }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "slickdeals.net/search_deals" , "input": { "sort": "newest", "query": "airpods", "store": "Amazon", "max_results": 50, "hide_expired": true } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run slickdeals.net/search_deals# with {"sort":"newest","query":"airpods","store":"Amazon","max_results":50,"hide_expired":true}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
slickdeals.net/search_deals- Returns
- deal title, price, currency, price as shown, original price, store, thumbs-up score, comments, posted time, expired, image, deal link, deal ID
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method slickdeals.net/search_deals with the inputs above.
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.
See more
All Slickdeals methodsLists 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.
slickdeals.net/list_popular_dealsSearches 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.
bestbuy.com/search_productsFinds 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.
reddit.com/search_postsSearches Kohl's products in site order and returns prices, offers, ratings and links for each result.
kohls.com/search_productsLists 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.
nintendo.com/list_dealsSearches 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.
macys.com/search_productsSearches 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.
aliexpress.com/search_productsSearches 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.
newegg.com/search_products