# Stacksocial — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse deals from StackSocial to find discounts on software, products, and memberships, with access to product details, reviews, and related recommendations. Discover lifetime deals and business software offers across multiple collections.

**Category:** E-commerce | **Website:** [stacksocial.com/](https://stacksocial.com/) | **Docs:** [parse.bot/marketplace/62769b7c-df08-4991-8f9e-742a8e195b5a/stacksocial-com-api](https://parse.bot/marketplace/62769b7c-df08-4991-8f9e-742a8e195b5a/stacksocial-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-stacksocial-com-api-62769b7c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_business_software_deals

Retrieve business software deals from the 'apps-software-business' collection. Returns paginated results. Shortcut for get_collection with slug='apps-software-business'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stacksocial-com-api-62769b7c/get_business_software_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_collection

Browse all deals in a named collection or category by its slug. Returns paginated results with collection name and flat page info fields. Use page and limit params to paginate through large collections.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Items per page. |
| `page` | integer | No | Page number. |
| `slug` | string | Yes | Collection slug (e.g. 'lifetime-deals', 'apps-software-business', 'memberships'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stacksocial-com-api-62769b7c/get_collection \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","slug":"<string>"}'
```

### get_lifetime_deals

Retrieve current lifetime deals from the 'lifetime-deals' collection. Returns paginated results. Shortcut for get_collection with slug='lifetime-deals'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stacksocial-com-api-62769b7c/get_lifetime_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_memberships

Retrieve membership deals (Costco, BJ's, Sam's Club, magazine subscriptions) from the 'memberships' collection. Returns paginated results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stacksocial-com-api-62769b7c/get_memberships \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_product_detail

Get full details of a specific deal/product by its slug. Includes HTML description, specifications, brand, variant options (different subscription lengths or tiers), and pricing. Returns stale_input if the slug does not match any product.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product slug (e.g. 'adguard-vpn-5-yr-subscription'). Obtain from search_deals or get_collection results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stacksocial-com-api-62769b7c/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_product_reviews

Get user reviews for a specific product by its slug. Returns reviewer name, numeric rating, review text, and ISO date. Empty array if no reviews exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of reviews to return. |
| `slug` | string | Yes | Product slug (e.g. 'adguard-vpn-5-yr-subscription'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stacksocial-com-api-62769b7c/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","slug":"<string>"}'
```

### get_related_products

Get up to 6 recommended products related to the specified product. Excludes the product itself from results. Useful for showing alternatives or complementary deals.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product slug to get recommendations for (e.g. 'adguard-vpn-5-yr-subscription'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stacksocial-com-api-62769b7c/get_related_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### search_deals

Full-text search over StackSocial deals by keyword. Returns matching products sorted by best sellers. Each result includes pricing, discount percentage, ratings, and category tags. The limit param controls result count (max ~50). No cursor-based pagination; a single page is returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |
| `query` | string | Yes | Search keyword (e.g. 'VPN', 'productivity', 'AI tools'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stacksocial-com-api-62769b7c/search_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```