# Retailmenot — 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 grocery and retail coupons, promo codes, and cash back offers across thousands of merchants to find the best deals before you shop. Get instant access to current discounts and savings opportunities tailored to your favorite stores and products.

**Category:** E-commerce | **Website:** [retailmenot.com/](https://retailmenot.com/) | **Docs:** [parse.bot/marketplace/13b99958-e9b3-4de3-aae1-100bf017113c/retailmenot-com-api](https://parse.bot/marketplace/13b99958-e9b3-4de3-aae1-100bf017113c/retailmenot-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-retailmenot-com-api-13b99958/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_store_coupons

Fetches all current coupons from a specific store's RetailMeNot page. Accepts a store_slug (e.g. 'target.com') and returns the same coupon object shape as search_coupons plus a scraped_at ISO 8601 timestamp indicating when the response was generated. Makes up to 2 requests: one for the store page and one to reveal coupon codes. When codes_only is true, only coupons with an actual promo code string are included in results; sales, cash back, and other non-code offers are excluded.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `codes_only` | boolean | No | When true, only coupons with an actual promo code are returned. Sales, cash back, and other non-code offers are excluded from the results and from the total count. |
| `store_slug` | string | Yes | Store identifier as it appears in the RetailMeNot URL path (e.g. 'target.com', 'amazon.com'). Discoverable via get_stores endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-retailmenot-com-api-13b99958/get_store_coupons \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"codes_only":"<boolean>","store_slug":"<string>"}'
```

### get_stores

Discovers all store pages from RetailMeNot's sitemap.xml. Returns a list of stores with their slug, derived name, and full URL. Makes a single request to the sitemap; no sub-sitemaps are followed. Typically returns ~6000+ stores.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-retailmenot-com-api-13b99958/get_stores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_coupons

Search for coupons and promo codes by keyword. Resolves the query to the best matching category or store page on RetailMeNot, then returns all available coupons from that page. Results include coupon codes, sales, and cash back offers with discount amounts and store attribution. For coupon-type offers, the actual promo code string is included when available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search term for finding coupons (e.g. 'grocery', 'pizza', 'electronics'). Matched against RetailMeNot categories and store names. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-retailmenot-com-api-13b99958/search_coupons \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```