# Yellowpages (India) — 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 across India and discover detailed information like contact details, addresses, and services from YellowPages.in's comprehensive business directory. Find relevant business categories with autocomplete suggestions to quickly locate the leads and companies you're looking for.

**Category:** Business Directories | **Website:** [yellowpages.in/](https://yellowpages.in/) | **Docs:** [parse.bot/marketplace/a3273927-760a-4e65-aca6-2f30ebbc7d72/yellowpages-in-api](https://parse.bot/marketplace/a3273927-760a-4e65-aca6-2f30ebbc7d72/yellowpages-in-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-yellowpages-in-api-a3273927/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_business_detail

Get detailed information for a specific business including full address, phone, email, website, GPS coordinates, and opening hours. The business URL path can be obtained from search_businesses results or get_search_autocomplete suggestions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The business page path (e.g. '/b/nasir-ali-plumber-bahadurpura-hyderabad/290211885'). Can be obtained from search_businesses results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yellowpages-in-api-a3273927/get_business_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_search_autocomplete

Get autocomplete suggestions for a search query, returning both category and business matches for the given location. Useful for discovering valid search terms before calling search_businesses.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | Yes | City for context-aware suggestions (e.g. 'Hyderabad', 'Mumbai'). |
| `query` | string | Yes | Search fragment to autocomplete (e.g. 'plumb', 'rest'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yellowpages-in-api-a3273927/get_search_autocomplete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","query":"<string>"}'
```

### list_categories

List all business categories available on YellowPages.in. Returns hundreds of category names with their listing page URLs. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yellowpages-in-api-a3273927/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_businesses

Search for businesses by keyword and location. Uses the site's category search to find matching businesses in the specified Indian city. Returns structured business listings with contact information. The query must match a known category on the site; use get_search_autocomplete to discover valid category terms. Returns up to ~25 results for a single category match.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of business results to return. |
| `location` | string | Yes | City or area to search in (e.g. 'Hyderabad', 'Delhi', 'Mumbai'). |
| `query` | string | Yes | Business type or keyword to search for (e.g. 'plumbers', 'hotels', 'restaurants'). |

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