# Slickdeals API

> Slickdeals returns community-posted deal listings and prices as a workflow and API.

List popular deals returns current Frontpage and popular deals or current category deals, with optional category and result count.

- Page: https://fous.com/workflows/slickdeals
- Handle: `@slickdeals`
- Category: [Commerce](https://fous.com/workflows/category/commerce)
- Source website: https://slickdeals.net
- Last verified: Sep 29, 2026
- Fous is not affiliated with Slickdeals.

## Methods

### List popular deals

Operation `list_popular_deals`, version 1. 1 credit per call.

List current Slickdeals Frontpage deals in site order, followed by popular deals when needed, or browse a category’s current deals. Expired deals are excluded.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `category` | string | no | `"tech"` | Deal category, for example tech; all lists Frontpage and popular deals. |
| `max_results` | integer | no | `5` | Maximum deals to return, for example 25. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "category": {
      "enum": [
        "all",
        "tech",
        "home",
        "clothing",
        "grocery",
        "travel",
        "video_games",
        "health_and_beauty"
      ],
      "type": "string",
      "default": "all",
      "description": "Deal category, for example tech; all lists Frontpage and popular deals.",
      "examples": [
        "tech",
        "video_games",
        "all"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum deals to return, for example 25.",
      "x-fous-developer": true,
      "examples": [
        5,
        50,
        25
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "category": "tech",
      "max_results": 5
    },
    {
      "category": "video_games",
      "max_results": 5
    },
    {
      "category": "tech",
      "max_results": 50
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `deals` | array |  |  |
| `deals[].price` | number or null | `1` | Deal price in USD, when a single price is shown. |
| `deals[].store` | string or null | `"Shutterfly"` |  |
| `deals[].title` | string or null | `"Shutterfly: Personalized Photo Magnets (4 Sizes)"` |  |
| `deals[].deal_id` | string or null | `"20071596"` |  |
| `deals[].category` | string or null | `"Tech & Electronics"` |  |
| `deals[].currency` | string | `"USD"` |  |
| `deals[].deal_url` | string or null | `"https://slickdeals.net/f/20071596-shutterfly-personalized-photo-magnets-4-sizes-1-free-s-h"` |  |
| `deals[].image_url` | string or null | `"https://slickdeals.net/attachment/4/5/4/3/2/5/200x200/21740685.thumb"` |  |
| `deals[].posted_at` | string or null | `"2026-09-28T19:36:31+00:00"` | Posted date and time as ISO 8601 with offset when shown. |
| `deals[].comment_count` | integer or null | `2` |  |
| `deals[].original_price` | number or null | `12` | Original price in USD, if shown. |
| `deals[].price_as_shown` | string or null | `"$1"` |  |
| `deals[].thumbs_up_score` | integer or null | `43` |  |

**Example input**

```json
{
  "category": "tech",
  "max_results": 5
}
```

**Example output**

```json
{
  "deals": [
    {
      "price": 1,
      "store": "Shutterfly",
      "title": "Shutterfly: Personalized Photo Magnets (4 Sizes)",
      "deal_id": "20071596",
      "category": "Tech & Electronics",
      "currency": "USD",
      "deal_url": "https://slickdeals.net/f/20071596-shutterfly-personalized-photo-magnets-4-sizes-1-free-s-h",
      "image_url": "https://slickdeals.net/attachment/4/5/4/3/2/5/200x200/21740685.thumb",
      "posted_at": "2026-09-28T19:36:31+00:00",
      "comment_count": 2,
      "original_price": 12,
      "price_as_shown": "$1",
      "thumbs_up_score": 43
    },
    {
      "price": 7.99,
      "store": "Woot!",
      "title": "Woot! Razer & More Gaming Deals: Razer Gigantus V2 Cloth Mouse Pad (Large)",
      "deal_id": "20061522",
      "category": "Tech & Electronics",
      "currency": "USD",
      "deal_url": "https://slickdeals.net/f/20061522-woot-razer-more-gaming-deals-razer-gigantus-v2-cloth-mouse-pad-large-8-more-free-s-h-w-prime",
      "image_url": "https://slickdeals.net/attachment/3/3/7/7/0/1/3/7/200x200/21713232.thumb",
      "posted_at": "2026-09-28T05:05:41+00:00",
      "comment_count": 2,
      "original_price": 14.99,
      "price_as_shown": "$7.99",
      "thumbs_up_score": 37
    },
    {
      "price": 13.49,
      "store": "Walgreens Photo",
      "title": "Walgreens Photo Offer: 3-Pk TilePix 8\"x8\" Customized Photo Framed Prints",
      "deal_id": "20067177",
      "category": "Tech & Electronics",
      "currency": "USD",
      "deal_url": "https://slickdeals.net/f/20067177-walgreens-photo-3-pk-8-x-8-tilepix-customized-photo-framed-prints-13-49-free-store-pickup",
      "image_url": "https://slickdeals.net/attachment/8/6/6/3/0/200x200/21732690.thumb",
      "posted_at": "2026-09-27T18:05:56+00:00",
      "comment_count": 3,
      "original_price": 45,
      "price_as_shown": "$13.49",
      "thumbs_up_score": 47
    }
  ]
}
```

### Search deals

Operation `search_deals`, version 1. 1 credit per call.

Search community-posted Slickdeals deals by product or keyword. Store and expiration filters follow the deal listings; prices may be missing when a post does not show one.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `sort` | string | no | `"newest"` | Result order, for example newest. |
| `query` | string | yes | `"AirPods Pro"` | 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. |
| `max_results` | integer | no | `50` | Maximum number of deals, for example 20. |
| `hide_expired` | boolean | no | `true` | Hide expired deals; for example true. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "enum": [
        "relevance",
        "newest",
        "most_popular"
      ],
      "type": "string",
      "default": "relevance",
      "description": "Result order, for example newest.",
      "examples": [
        "newest",
        "most_popular"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Product or search words, for example AirPods Pro.",
      "examples": [
        "AirPods Pro",
        "airpods",
        "zzxqvnonexistentfoobar92874632"
      ]
    },
    "store": {
      "type": "string",
      "default": "",
      "description": "Limit deals to a store, for example Amazon or Best Buy; leave blank for any store.",
      "examples": [
        "Amazon",
        "Best Buy"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of deals, for example 20.",
      "x-fous-developer": true,
      "examples": [
        50,
        10
      ]
    },
    "hide_expired": {
      "type": "boolean",
      "default": true,
      "description": "Hide expired deals; for example true.",
      "examples": [
        true,
        false
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "AirPods Pro"
    },
    {
      "sort": "newest",
      "query": "airpods",
      "store": "Amazon",
      "max_results": 50,
      "hide_expired": true
    },
    {
      "sort": "most_popular",
      "query": "airpods",
      "store": "Best Buy",
      "max_results": 10,
      "hide_expired": false
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `deals` | array |  | Matching deals in requested order. |
| `deals[].price` | number or null | `200` | Listed deal price in USD, if shown. |
| `deals[].store` | string or null | `"Best Buy"` | Store name, if given. |
| `deals[].title` | string | `"Apple AirPods Pro 3 Wireless Active Noise Cancelling Earbuds"` | Deal title. |
| `deals[].deal_id` | string | `"19403235"` | Slickdeals deal ID. |
| `deals[].expired` | boolean | `true` | Whether the deal is expired. |
| `deals[].currency` | string | `"USD"` | Price currency. |
| `deals[].deal_link` | string | `"https://slickdeals.net/f/19403235-apple-airpods-pro-3-wireless-active-noise-cancelling-earbuds-200-free-s-h"` | Deal page link. |
| `deals[].posted_at` | string or null | `"2026-04-09T22:18:07-07:00"` | Date and time the deal was posted (ISO 8601 with offset). |
| `deals[].image_link` | string or null | `"https://static.slickdealscdn.com/attachment/3/6/9/5/2/8/450x450/20121324.thumb"` | Deal image link, if shown. |
| `deals[].comment_count` | integer | `52` | Number of comments. |
| `deals[].original_price` | number or null | `250` | Original listed price in USD, if shown. |
| `deals[].price_as_shown` | string or null | `"$200"` | Deal price text as shown. |
| `deals[].thumbs_up_score` | integer | `221` | Net thumbs-up score. |

**Example input**

```json
{
  "sort": "most_popular",
  "query": "airpods",
  "store": "Best Buy",
  "max_results": 10,
  "hide_expired": false
}
```

**Example output**

```json
{
  "deals": [
    {
      "price": 200,
      "store": "Best Buy",
      "title": "Apple AirPods Pro 3 Wireless Active Noise Cancelling Earbuds",
      "deal_id": "19403235",
      "expired": true,
      "currency": "USD",
      "deal_link": "https://slickdeals.net/f/19403235-apple-airpods-pro-3-wireless-active-noise-cancelling-earbuds-200-free-s-h",
      "posted_at": "2026-04-09T22:18:07-07:00",
      "image_link": "https://static.slickdealscdn.com/attachment/3/6/9/5/2/8/450x450/20121324.thumb",
      "comment_count": 52,
      "original_price": 250,
      "price_as_shown": "$200",
      "thumbs_up_score": 221
    },
    {
      "price": 116,
      "store": "Best Buy",
      "title": "Open Box Excellent: Apple AirPods Pro 2 Wireless ANC Earbuds w/ USB-C MagSafe Case",
      "deal_id": "18099382",
      "expired": true,
      "currency": "USD",
      "deal_link": "https://slickdeals.net/f/18099382-open-box-excellent-apple-airpods-pro-2-wireless-anc-earbuds-w-usb-c-magsafe-case-116-free-shipping-more",
      "posted_at": "2025-02-04T10:20:53-08:00",
      "image_link": "https://static.slickdealscdn.com/attachment/8/4/0/9/0/5/1/450x450/17039968.thumb",
      "comment_count": 328,
      "original_price": 170,
      "price_as_shown": "$116",
      "thumbs_up_score": 216
    },
    {
      "price": 100,
      "store": "Best Buy",
      "title": "Get $15 Best Buy eGift Card with",
      "deal_id": "17917449",
      "expired": true,
      "currency": "USD",
      "deal_link": "https://slickdeals.net/f/17917449-get-15-best-buy-egift-card-with-100-apple-gift-card-purchase-physical-or-digital",
      "posted_at": "2024-11-22T23:30:54-08:00",
      "image_link": "https://static.slickdealscdn.com/attachment/4/2/8/1/6/450x450/16619346.thumb",
      "comment_count": 224,
      "original_price": 115,
      "price_as_shown": "$100 Apple Gift Card Purchase",
      "thumbs_up_score": 196
    }
  ]
}
```

## Quick start

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@slickdeals",
  "visibility": "public",
  "operation": "list_popular_deals",
  "version": 1,
  "input": {
    "category": "tech",
    "max_results": 5
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

body = json.loads("{\n  \"api\": \"@slickdeals\",\n  \"visibility\": \"public\",\n  \"operation\": \"list_popular_deals\",\n  \"version\": 1,\n  \"input\": {\n    \"category\": \"tech\",\n    \"max_results\": 5\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=120) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify({
  "api": "@slickdeals",
  "visibility": "public",
  "operation": "list_popular_deals",
  "version": 1,
  "input": {
    "category": "tech",
    "max_results": 5
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

Or describe the data in plain language: send `{"api":"@slickdeals","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## Use cases

- Find community deals for a product or keyword
- Filter deal searches by store
- Browse current deals by category
- Compare listed deal prices and original prices
- Review deal comment counts and thumbs-up scores

## FAQ

### Is Fous affiliated with Slickdeals?

No. Fous is not affiliated with Slickdeals. This workflow reads the public slickdeals.net website and returns its data.

### How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

### Do I need a Slickdeals account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from slickdeals.net when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.

### What deals match a product or keyword?

Search deals returns matching community-posted deals and accepts optional store and expiration filters.

### What are the current popular deals?

List popular deals returns current Frontpage deals in site order, followed by popular deals when needed.

### What current deals are in a category?

List popular deals returns current deals for a chosen category.

## Related

- [Amazon API](https://fous.com/workflows/amazon.md): Amazon returns publicly shown product listings, prices, details, ratings, reviews, current best sellers, and Today's Deals; availability and content vary by store, location, and access.
- [Best Buy API](https://fous.com/workflows/best-buy.md): Best Buy returns US electronics and appliance listings, prices, deals, specifications, images, reviews, and nearby store pickup and shipping details; prices and availability can change by location and before checkout.
- [AliExpress API](https://fous.com/workflows/aliexpress.md): AliExpress returns product listings and selected product details, including prices, variants, reviews, and destination-specific shipping options shown for the displayed variant.
- [Kohl's API](https://fous.com/workflows/kohls.md): Shop products and deals on Kohl's.
- [eBay API](https://fous.com/workflows/ebay.md): eBay provides listings, listing details, seller reputation and newest feedback; shipping varies by destination, and some details or counts may be missing or approximate.
- [Macy's API](https://fous.com/workflows/macys.md): Shop Macy's products and sales.
- [Newegg API](https://fous.com/workflows/newegg.md): Newegg provides US computer and electronics listings, with product details and selected public offers whose prices, availability, stock, and shipping can change or may not be displayed.
- [Flipkart API](https://fous.com/workflows/flipkart.md): Flipkart shows current product listings and prices, with available product details and location-dependent delivery estimates that may be unavailable for some listings or PIN codes.
- [All Commerce workflows](https://fous.com/workflows/category/commerce)