Slickdeals APIslickdeals.net ↗
Access frontpage deals, trending bargains, promo codes, forum threads, and deal details from Slickdeals.net via a structured JSON API.
What is the Slickdeals API?
The Slickdeals API exposes 6 endpoints covering frontpage deals, surging bargains, coupons, forum threads, keyword search, and individual deal detail pages. The get_deals endpoint returns an array of deal objects with fields like threadId, price, originalPrice, discount, store, votes, and isExpired, giving structured access to the community-voted deals Slickdeals surfaces daily across hundreds of retailers.
curl -X GET 'https://api.parse.bot/scraper/6028c288-28e1-44ff-8d02-2d1cfa1d37f7/get_deals?format_email=True&price_threshold=50' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace slickdeals-net-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.slickdeals_api import Slickdeals, DealSummary, Deal, SearchResult, Coupon, ForumThread
client = Slickdeals()
# Browse trending deals from the recommendation carousel
for deal in client.dealsummaries.trending(limit=5):
print(deal.title, deal.price, deal.votes, deal.is_fire)
# Get full details for the first trending deal
top_deal = next(iter(client.dealsummaries.trending(limit=1)))
detail = top_deal.details()
print(detail.title, detail.author, detail.views, detail.is_expired)
for comment in detail.comments[:3]:
print(comment.user, comment.text)
# Search for deals by keyword
for result in client.searchresults.search(query="laptop", limit=10):
print(result.title, result.price, result.store)
# List current frontpage deals filtered by price
for deal in client.dealsummaries.list(price_threshold=50.0):
print(deal.title, deal.store, deal.discount, deal.is_popular)
# List featured coupons
for coupon in client.coupons.list():
print(coupon.title, coupon.code, coupon.discount, coupon.views)
# Browse Hot Deals forum threads
for thread in client.forumthreads.list(forum_id=9, limit=20):
print(thread.title, thread.category, thread.replies, thread.views)
Extract current frontpage deals from Slickdeals. Returns an array of deal objects with title, price, store, votes, and other metadata. Optionally filters by price threshold and formats results as email text. No pagination; returns all current frontpage deals in a single response.
| Param | Type | Description |
|---|---|---|
| format_email | boolean | If true, includes a plain-text email summary of the top 10 deals in the response |
| price_threshold | number | Filter to only include deals with a numeric price below this value |
{
"type": "object",
"fields": {
"deals": "array of deal summary objects with threadId, title, price, originalPrice, discount, store, url, votes, comments, isExpired, datePosted, imageUrl, category, isPopular, isFire",
"email_text": "string containing formatted email text of top 10 deals (only present when format_email=true)"
},
"sample": {
"data": {
"deals": [
{
"url": "https://slickdeals.net/f/19603110-free-chomps-original-beef-stick-ends-july-30-2026",
"price": "Free",
"store": "Send Me a Sample",
"title": "Chomps Chicken Stick Sample (various)",
"votes": 81,
"isFire": false,
"category": null,
"comments": 24,
"discount": null,
"imageUrl": "https://static.slickdealscdn.com/attachment/5/2/4/7/9/450x450/20626125.thumb",
"threadId": 19603110,
"isExpired": false,
"isPopular": true,
"datePosted": "2026-06-09T01:34:58-07:00",
"originalPrice": ""
}
]
},
"status": "success"
}
}About the Slickdeals API
Frontpage and Trending Deals
The get_deals endpoint returns current frontpage deals with up to 15 fields per object, including title, price, originalPrice, discount, store, votes, comments, isExpired, and datePosted. Two optional parameters control output: price_threshold filters the array to deals below a numeric price, and format_email adds a pre-formatted plain-text summary of the top 10 deals as an email_text string in the response. The get_surging_deals endpoint returns a separate trending feed — the "Just For You" carousel — with the same object shape, including fire/popular flags and discount percentages useful for identifying fast-moving deals.
Search, Coupons, and Forums
The search endpoint accepts a required query string and an optional page integer for pagination. Results include title, price, store, and url per entry. Note that results may contain both deal entries and related comment entries sharing the same URL, so deduplication by URL may be necessary. The get_coupons endpoint returns featured promo codes from the Slickdeals frontpage, each with id, title, code, discount, views, storeUrl, and outclickUrl. The get_forum_deals endpoint retrieves thread listings with title, category, replies, views, and url; currently, only forum_id 9 (Hot Deals) is confirmed to return results.
Deal Detail Pages
The get_details endpoint accepts a full Slickdeals deal URL or a path beginning with /f/ and returns the richest data of any endpoint: title, price, description, author, votes, views, image, date_posted, is_expired, and up to 20 comments objects each containing user and text. This endpoint is suitable for building deal monitoring tools, alert systems, or archiving specific threads for later analysis.
The Slickdeals API is a managed, monitored endpoint for slickdeals.net — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when slickdeals.net changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official slickdeals.net API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a daily deal digest email by calling
get_dealswithformat_email=trueand delivering theemail_textresponse to a mailing list - Track price drops below a target amount using the
price_thresholdparameter onget_dealsto filter relevant deals - Monitor fast-moving bargains by polling
get_surging_dealsfor deals with highvotescounts and popular/fire flags - Create a browser extension that surfaces active promo codes using
get_couponsresponse fieldscode,discount, andstoreUrl - Search deals by product category keyword with
searchand aggregate results bystorefield to compare retailer pricing - Archive community discussion for a specific deal using
get_detailsto capturecomments,description,author, andis_expiredstatus - Pull Hot Deals forum threads with
get_forum_dealsto track which deal categories generate the mostrepliesandviews
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Slickdeals have an official developer API?+
What does `get_details` return that the other endpoints don't?+
get_details endpoint is the only one that returns description, author, and comments (up to 20, each with user and text). It also returns views, image, and is_expired as a boolean. Other endpoints like get_deals and get_surging_deals return summary-level fields only and do not include per-deal community comments or full description text.Are forum categories other than Hot Deals accessible via `get_forum_deals`?+
forum_id 9 (Hot Deals) is confirmed to return results. Other forum IDs are not currently supported. You can fork this API on Parse and revise it to add support for additional forum IDs once you identify the corresponding values.Does the `search` endpoint return deal scores or vote counts?+
search endpoint returns title, price, store, and url per result — vote counts and comment counts are not included. Those fields are available on individual deals via get_details. You can fork this API on Parse and revise the search endpoint to enrich results with additional fields.Can I retrieve historical or expired deals in bulk?+
get_details endpoint includes an is_expired boolean and datePosted for individual deal pages, and get_deals includes isExpired per object, but there is no endpoint for querying past deals by date range or expiration status. You can fork this API on Parse and revise it to add a historical deals endpoint.