# Valpak — 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 for restaurant coupons, store deals, and local service offers in your area by entering your zip code. Get instant access to current promotions from nearby businesses to save money on dining, shopping, and services.

**Category:** E-commerce | **Website:** [valpak.com/](https://valpak.com/) | **Docs:** [parse.bot/marketplace/8f95bd36-b4c7-41b1-a4e2-b983a06833f1/valpak-com-api](https://parse.bot/marketplace/8f95bd36-b4c7-41b1-a4e2-b983a06833f1/valpak-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-valpak-com-api-8f95bd36/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### search_local_coupons

Search for local coupons and deals near a US zip code. Returns brick-and-mortar business offers including restaurants, automotive services, personal care, home services, and more. Results are ordered by distance from the zip code center. An optional category narrows results to one business type. Each coupon includes the offer title, business name, distance, and a link to the full coupon details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Filter coupons by business category. Omitted returns all categories. |
| `zip_code` | string | Yes | 5-digit US ZIP code (e.g. 90210). Leading zeros preserved. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-valpak-com-api-8f95bd36/search_local_coupons \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","zip_code":"<string>"}'
```