# Wheresweed — 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.

> Find and compare cannabis dispensaries, delivery services, and products across Washington DC by browsing menus, deals, reviews, and categories to discover the best options near you. Access detailed business information, current promotions, and customer feedback all in one place to make informed purchasing decisions.

**Category:** Marketplaces | **Website:** [wheresweed.com/](https://wheresweed.com/) | **Docs:** [parse.bot/marketplace/6540a5ab-1a6c-4291-9f02-8f3b4f3c7fd4/wheresweed-com-api](https://parse.bot/marketplace/6540a5ab-1a6c-4291-9f02-8f3b4f3c7fd4/wheresweed-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/wheresweed/`
**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 deals

Get all active deals for a specific business.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Business URL slug (e.g. 'dcxprss'). Obtainable from list_businesses results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/wheresweed/get-business-deals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get business detail

Get complete business profile including hours, address, amenities, social media, menu categories, ratings breakdown, and active deals.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Business URL slug (e.g. 'dcxprss', 'ladder'). Obtainable from list_businesses results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/wheresweed/get-business-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get business menu

Get the product menu for a business. Returns products with pricing, strain info, and availability.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum products to return. |
| `offset` | integer | No | Number of products to skip. |
| `slug` | string | Yes | Business URL slug (e.g. 'ladder'). Obtainable from list_businesses results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/wheresweed/get-business-menu \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","slug":"<string>"}'
```

### List businesses

List dispensaries and delivery services. Returns paginated business listings with rating, location, delivery info, and open status. Results are ordered by featured level and relevance.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `business_type` | string | No | Filter by business type. Omitted returns all types. |
| `city` | string | No | City slug for filtering listings (e.g. 'washington-dc'). |
| `limit` | integer | No | Maximum number of results to return per page. |
| `offset` | integer | No | Number of results to skip for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/wheresweed/list-businesses \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"business_type":"<string>","city":"<string>","limit":"<integer>","offset":"<integer>"}'
```

### List categories

List all menu/product categories and subcategories for a business, with item counts per category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Business URL slug (e.g. 'dcxprss'). Obtainable from list_businesses results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/wheresweed/list-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### List deals

List active deals in a city. Returns deals with pricing, business info, category, and expiration. Ordered by promoted status and recency.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug for filtering deals. |
| `limit` | integer | No | Maximum deals to return. |
| `offset` | integer | No | Number of deals to skip for pagination. |
| `product_category` | string | No | Filter by product category (e.g. 'bud', 'edible', 'concentrate'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/wheresweed/list-deals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","limit":"<integer>","offset":"<integer>","product_category":"<string>"}'
```

### List reviews

List reviews for a business. Returns review text, per-category ratings breakdown, reviewer info, and vote counts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Business URL slug (e.g. 'dcxprss'). Obtainable from list_businesses results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/wheresweed/list-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Search site

Search across Where's Weed for businesses, locations, menu items, and strains. Returns grouped results by category with match counts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query text. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/wheresweed/search-site \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"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.