# 99acres — 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.

> 99acres provides 3 callable API endpoints through the Parse marketplace.

**Category:** Real Estate | **Website:** [99acres.com/](https://99acres.com/) | **Docs:** [parse.bot/marketplace/00ed32de-ec22-4522-830e-8bbfd80e9e46/99acres-com-api](https://parse.bot/marketplace/00ed32de-ec22-4522-830e-8bbfd80e9e46/99acres-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-99acres-com-api-00ed32de/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_project_detail

Get details of a real estate project including configurations, pricing, RERA details, and USPs. Searches the project's city listings to find the project by ID extracted from the URL. The URL must contain a project ID in the format -npxid-r<id>. Requires multiple page fetches internally so is slower than search endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Project URL containing the project ID in the format ...-npxid-r<id> (e.g., https://www.99acres.com/ivory-county-sector-115-noida-npxid-r400436). Obtain URLs from search_projects results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-99acres-com-api-00ed32de/get_project_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### search_projects

Search for new launch or under-construction real estate projects in a given Indian city. Returns a paginated list of projects with basic details including builder name, price range, RERA number, and a details URL for drill-down via get_project_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | City to search in, hyphenated for multi-word names (e.g., noida, mumbai, bangalore, gurgaon) |
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-99acres-com-api-00ed32de/search_projects \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>"}'
```

### search_properties

Search for real estate properties for sale or rent in a specific Indian city. Returns a paginated list of properties with details including price, area, bedrooms, locality, and seller info. Filters by transaction type, property type, bedrooms, and price range. Results are ordered by the site's default relevance ranking.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bedrooms` | string | No | Number of bedrooms filter, comma-separated values (e.g., 2,3) |
| `location` | string | No | City or locality to search in, hyphenated for multi-word names (e.g., noida, mumbai, bangalore, gurgaon, navi-mumbai, greater-noida) |
| `max_price` | integer | No | Maximum price filter in INR |
| `min_price` | integer | No | Minimum price filter in INR |
| `page` | integer | No | Page number for pagination |
| `property_type` | string | No | Type of property |
| `transaction_type` | string | No | Type of transaction |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-99acres-com-api-00ed32de/search_properties \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bedrooms":"<string>","location":"<string>","max_price":"<integer>","min_price":"<integer>","page":"<integer>","property_type":"<string>","transaction_type":"<string>"}'
```