# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-wheresweed-com-api-6540a5ab/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-wheresweed-com-api-6540a5ab/get_business_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wheresweed-com-api-6540a5ab/get_business_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wheresweed-com-api-6540a5ab/get_business_menu \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wheresweed-com-api-6540a5ab/list_businesses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wheresweed-com-api-6540a5ab/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wheresweed-com-api-6540a5ab/list_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wheresweed-com-api-6540a5ab/list_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wheresweed-com-api-6540a5ab/search_site \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```