# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/stacksocial/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/stacksocial/get-business-software-deals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/stacksocial/get-collection \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/stacksocial/get-lifetime-deals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/stacksocial/get-memberships \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/stacksocial/get-product-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/stacksocial/get-product-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/stacksocial/get-related-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/stacksocial/search-deals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.