# Justdial — 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 and discover local Indian businesses across categories like restaurants, doctors, and caterers with instant access to contact information, ratings, reviews, and service details. Find the perfect service provider in your area with comprehensive business listings and verified customer feedback.

**Category:** Business Directories | **Website:** [justdial.com/](https://justdial.com/) | **Docs:** [parse.bot/marketplace/5c3e1247-ae9a-412d-aff3-192dd2b9cf18/justdial-com-api](https://parse.bot/marketplace/5c3e1247-ae9a-412d-aff3-192dd2b9cf18/justdial-com-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/justdial/`
**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 details

Get comprehensive details for a specific business.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name where the business is located. |
| `docid` | string | Yes | Unique document ID of the business as returned by search results (e.g., '011PXX11.XX11.YYMMDDHHMMSS.XXXX'). |
| `slug` | string | Yes | Business slug or short URL identifier found in Justdial listing URLs (e.g., 'DT-abc123' or 'Business-Name-City'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/justdial/get-business-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","docid":"<string>","slug":"<string>"}'
```

### Search businesses

Search for catering and event businesses by city and keyword category. Returns a paginated list of business listings with contact details, ratings, and location info. Each page returns up to 10 results. The underlying API is optimized for the Caterers category; other keywords may return empty results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name in India (e.g., Delhi, Mumbai, Bangalore, Chennai, Hyderabad). |
| `keyword` | string | Yes | Category or business type to search for. Reliably supported: 'Caterers'. Other food/event keywords may work depending on the city. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/justdial/search-businesses \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","keyword":"<string>","page":"<integer>"}'
```

### Search caterers

Search for caterers and event service providers in a specified Indian city. Returns up to 10 business listings per call with contact details, ratings, addresses, and working hours. Equivalent to calling search_businesses with keyword='Caterers'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name in India (e.g., Delhi, Mumbai, Bangalore, Chennai, Hyderabad). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/justdial/search-caterers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### Search doctors

Search for doctors and medical practitioners in a specified city. Equivalent to calling search_businesses with keyword='Doctors'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/justdial/search-doctors \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"city":"<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.