# Yelp (m.yelp.com) — 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 businesses and read detailed reviews on Yelp, then get autocomplete suggestions to find exactly what you're looking for. Access comprehensive business information including ratings, hours, and customer feedback all in one place.

**Category:** Food & Dining | **Website:** [m.yelp.com/](https://m.yelp.com/) | **Docs:** [parse.bot/marketplace/f90b7910-bfba-4d1e-bdde-f7d2df37ee49/m-yelp-com-api](https://parse.bot/marketplace/f90b7910-bfba-4d1e-bdde-f7d2df37ee49/m-yelp-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-m-yelp-com-api-f90b7910/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### autocomplete

Get autocomplete suggestions for search keywords. Returns suggested search terms and categories based on the text prefix and optional location context. Useful for building type-ahead search UIs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location context for suggestions (e.g. 'New York, NY'). |
| `text` | string | Yes | Search text prefix to autocomplete (e.g. 'sushi', 'thai', 'pizza'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-m-yelp-com-api-f90b7910/autocomplete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","text":"<string>"}'
```

### get_business_details

Get rich details for a specific business by its alias (slug). Returns structured business data including name, rating, review count, categories, location, hours, photos, and price range via Yelp's GraphQL API. Requires resolving the alias to an internal encrypted ID first (automatic).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `alias` | string | Yes | Business alias/slug (e.g. 'joes-pizza-new-york-148'). Obtainable from search_businesses results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-m-yelp-com-api-f90b7910/get_business_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"alias":"<string>"}'
```

### get_business_reviews

Get reviews for a specific business. Returns a flat list of reviews with text, rating, author info, and pagination cursor. Sorted by relevance by default. Each review includes full text, star rating, author display name, and creation date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `after` | string | No | Pagination cursor for next page of reviews. Obtained from previous response's end_cursor field. |
| `alias` | string | Yes | Business alias/slug (e.g. 'joes-pizza-new-york-148'). Obtainable from search_businesses results. |
| `limit` | integer | No | Number of reviews to return per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-m-yelp-com-api-f90b7910/get_business_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"after":"<string>","alias":"<string>","limit":"<integer>"}'
```

### search_businesses

Search for businesses by keyword and location. Returns a paginated list of matching businesses with name, alias (slug), and URL. Results are offset-paginated via the start parameter (increments of ~10). The total field reflects the count of results returned in the current page, not a site-wide total.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location to search in (e.g. 'New York, NY', 'San Francisco, CA'). |
| `query` | string | No | Search keyword or category (e.g. 'pizza', 'cafes', 'italian restaurants'). |
| `start` | integer | No | Pagination offset for results. Increments in steps of 10. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-m-yelp-com-api-f90b7910/search_businesses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","query":"<string>","start":"<integer>"}'
```