# Yellowpages (India) — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/yellowpages-india/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/yellowpages-india/get-business-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/yellowpages-india/get-search-autocomplete \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/yellowpages-india/list-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/yellowpages-india/search-businesses \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","location":"<string>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.