Slickdeals API

Slickdeals deals, coupon codes and feeds as JSON

Slickdeals is the largest US community deal site: members post deals, vote them up or down, and editors pick the best for the Frontpage.

no credit card1,000 free credits · instant API key · pay by card or crypto
Missing a Slickdeals endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
S
/slickdeals/v1

5 active endpoints. Every call is 2 credits.

  • POST/slickdeals/v1/search
  • POST/slickdeals/v1/deal
  • POST/slickdeals/v1/comments
  • POST/slickdeals/v1/feed
  • POST/slickdeals/v1/categories

What Slickdeals endpoints does ReefAPI ship?

5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

5 endpoints

search

2 cr

Search Slickdeals deals by keyword (or list every deal) with the site's own sort and filters.

required
—
optional
query, page, sort, min_price, max_price, min_discount, store_id, category_id, brand_id, rating, posted_within_days, hide_expired, forum_id

deal

2 cr

One Slickdeals deal in full.

required
deal_id
optional
resolve_store_url

comments

2 cr

The comments on one Slickdeals deal, page by page (15 top-level comments per page, with their…

required
deal_id
optional
page

feed

2 cr

The Slickdeals home page lists.

required
—
optional
feed, cursor, show_expired

categories

2 cr

Slickdeals category, store and brand ids with deal counts, as the site's search sidebar lists…

required
—
optional
query, category_id, posted_within_days

Every parameter, every allowed value →

Slickdeals API

4 of 5 endpoints, ready to run

View docs ↗

Newest Instant Pot deals

2 credits0 required · 2 optional
POST/slickdeals/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

How the Slickdeals API works

Slickdeals is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 585 engines.

02
Call
POST /slickdeals/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
2 credit per call

Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

From a product idea to the best current deal and its code

Find the ids, search with filters, then open the deal.

01categories?query=air%20fryer
GET/slickdeals/v1/categories?query=air%20fryer

Categories, stores and brands with deal counts for that keyword.

02search?query=air%20fryer&store_id=1&min_discount=30&sort=recent&hide_expired=true
GET/slickdeals/v1/search?query=air%20fryer&store_id=1&min_discount=30&sort=recent&hide_expired=true

Live Amazon air fryer deals at least 30% off, newest first, with price, list price, score and comments.

03deal?deal_id=<deal_id>&resolve_store_url=true
GET/slickdeals/v1/deal?deal_id=<deal_id>&resolve_store_url=true

Price, coupon code, shipping note, description, the store page link and the first comments.

04comments?deal_id=<deal_id>&page=2
GET/slickdeals/v1/comments?deal_id=<deal_id>&page=2

What the community says about it, 15 comments per page.

A filtered, coupon-aware deal list you can refresh every few minutes.

request
curl -X POST https://api.reefapi.com/slickdeals/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"instant pot","sort":"recent"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "slickdeals",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}

What a Slickdeals field actually contains

Fields that read differently from how they look. Every row was measured against live responses on 2026-10-18.

FieldWhat it holds
price, price_type, price_textThe deal price as Slickdeals prints it on the card, which it rounds: a $21.59-$25 deal shows $22. price is a number only for a plain price (fixed), "from $4" (from), "$1 each" (each), "$8 or less" (or_less) and "Free" (free, 0). Texts like "Buy 5, Get 40% Off", "2 for $2.50" or "$10 Statement Credit" stay in price_text with price null; 69 of 1,300 cards carried no price at all.
list_price, next_best_priceThe struck-through comparison price on the card, also rounded ($14.99 shows as $15). next_best_price holds the same value under the name our mydealz, hotukdeals and dealabs APIs use.
discount_pct, source_discount_pctdiscount_pct is computed from the two card prices; source_discount_pct is Slickdeals' own figure, worked out from its unrounded prices. They can differ by a point or two.
scoreThe deal score: thumbs up minus thumbs down. It can be negative. It is Slickdeals' counterpart of the temperature on Pepper sites, on a different scale.
voucher_codedeal only: the coupon code written into the deal text ("Apply promo code HJNEGXC7 at checkout"). It is null when the deal needs no code; 2 of 15 recent deals sampled had one.
extra_info, shipping_free, shipping_priceThe note printed next to the price ("+ Free S&H", "+ $10 S&H", "w/ S&S", "(In-Store Only)"). shipping_free and shipping_price are filled only when that note states them; pickup-only notes leave them null.
merchant, link_host, store_urlmerchant is the deal's store (id and name). deal adds link_host (the store's domain), deal_link (Slickdeals' 'Get Deal' link) and, with resolve_store_url, store_url: the store page that link opens, Slickdeals' affiliate parameters included.
total, total_cappedSlickdeals' own result count. It stops at 1000, so total_capped is true for broad searches; the categories call gives the uncapped counts per category, store and brand.

With the default relevance order Slickdeals' later result pages can repeat deals from earlier pages and end before the reported total ('instant pot': 229 of 388 reachable, about 30 repeats). sort=recent pages through every deal exactly once (388 of 388).

Slickdeals coverage, measured

Every number below was read from live responses on 2026-10-18 over three runs: 26 searches across keywords, categories, stores and filters, 22 deals, 12 comment pages, 15 feed pages and 12 facet calls, all answered.

Search to deal

12 of 12 search rows opened as the same deal with the same title, price text, list price, store, score and expired flag.

Store links

The store page behind the Get Deal button came back for 9 of 10 calls (Amazon, Walmart, Best Buy, Woot!); the miss was a Woot! deal before a fix, and the same deal returned its woot.com page afterwards.

Price check

On 324 cards whose title names a dollar amount, the card price matched it on 317; the other 7 list several items or a gift-card face value.

Filters

"instant pot" 388 deals: price $50-100 191, max $60 164, 50% off 107, Amazon 249, Frontpage 61, Popular 160, Fire 21, past 30 days 17, hide expired 43.

Paging

sort=recent: 388 of 388 deals, none repeated; three pages of "headphones" over $50: 40/40/40, none shared, none under $50. Popular and Hot Deals feeds: 3 pages, 300 deals, none repeated.

Fill

Across Tech, Home, Clothing, Grocery and Babies & Kids: title, store and score on every row; price on 184 of 200; list price on 166 of 200; coupon code on 2 of 15 deals read.

Limits

1000 results per search; about 10 entries per facet group; prices as rounded on the card; scores and views change by the minute.

What people build with Slickdeals

The jobs this data is most often used for.

5

endpoints

2

credits per call

01

Alert your users the moment a deal on a product or brand they follow hits the Slickdeals Frontpage.

02

Collect coupon codes and price drops by store for a deals newsletter or browser extension.

03

Measure how a brand's or retailer's promotions are received: score, views and comments per deal.

04

Track the lowest price the community found for a product over time.

What Slickdeals data costs

The cheapest call here is 2 credits, so $15/mo (Pro) buys 5,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 585 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/slickdeals/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"instant pot","sort":"recent"}'
python
import requests

r = requests.post(
    "https://api.reefapi.com/slickdeals/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "instant pot",
  "sort": "recent"
},
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Slickdeals.

Get a free key →
Does Slickdeals have an official API?▾

Not a public one. This API reads the same data the slickdeals.net pages show to a logged-out visitor and returns it as JSON.

Do I need a Slickdeals account?▾

No. Deals, prices, coupon codes, scores, comments and feeds are all public on slickdeals.net. Account-only things such as your own votes, saved deals or deal alerts are not included.

Can I get the coupon code of a deal?▾

Yes. deal returns voucher_code (and voucher_codes when the deal lists several), read from the deal text, and the full description it came from.

How do I follow the Frontpage or Popular deals?▾

Call feed with feed=frontpage, popular, hot_deals or fire_deals, then pass next_cursor to go back in time. Frontpage pages are whole days; the first page covers the last 24 hours and repeats part of the second, so keep deal_id as your key.

Which filters work?▾

All of these narrow the results on Slickdeals itself ('instant pot', 388 deals): price 50-100 gives 191, minimum discount 50 gives 107, Amazon only 249, Frontpage deals 61, Fire deals 21, past 30 days 17, hide expired 43. Sort by relevance, newest, score, last comment, price low or price high.

Where do I get store, category and brand ids?▾

The categories call lists them with deal counts, for all deals or for a keyword, and lists a category's subcategories when you pass its id. Common ones: store 1 Amazon, 439 Walmart, 92 Best Buy, 201 Target; category 40 Tech & Electronics, 286 Home & Home Improvement, 9 Computers.

How many results can I get for one search?▾

40 per page and at most 1000 per search, which is where Slickdeals stops. Narrow with filters or a posting window to reach older deals.

How fresh is the data?▾

Every call reads slickdeals.net live; nothing is cached. Scores, views and comment counts change by the minute on new deals.

What is the Slickdeals API?▾

Slickdeals API is a ReefAPI endpoint group for slickdeals deals as json: search with the site's filters, full deal pages with coupon codes, comments, and the frontpage, popular and hot deals feeds. It returns live JSON through POST requests under /slickdeals/v1.

Is the Slickdeals API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. Slickdeals calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Slickdeals login or account?▾

No login to Slickdeals is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Slickdeals data?▾

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Slickdeals API use?▾

Slickdeals actions currently cost 2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Slickdeals from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call slickdeals actions with the same key, credit pool and JSON envelope used by normal REST requests.

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 584 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-18.