# Justdial — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-justdial-com-api-5c3e1247/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-justdial-com-api-5c3e1247/get_business_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-justdial-com-api-5c3e1247/search_businesses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-justdial-com-api-5c3e1247/search_caterers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-justdial-com-api-5c3e1247/search_doctors \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```