Skip to content
Scrappa Get API key
99acres API 1 credit/request

99acres Search API Documentation

GET https://scrappa.co/api/99acres/v1/search

99acres Search API returns the server-rendered property listings of a 99acres landing page as JSON. Pass the site's own landing slug that ends in -ffid (typology, locality, budget, buy or rent) and page through the results. Each property carries a heading, sub-heading, builder, price as a major-unit INR number plus a compact label, price per square foot, transaction type, possession status, RERA tag, tags, locality, city, coordinates and an absolute image and web URL. A valid empty result (page past the end) is a successful, billable response.

99acres Search API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/99acres/v1/search
Auth header
x-api-key
Cost
1 credit/request
slug = example
Response preview
200 OK
{
    "data": {
        "page": 2,
        "count": 23192,
        "filters": [],
        "has_more": true,
        "per_page": 25,
        "properties": [
            {
                "id": "r450099",
                "url": "https://www.99acres.com/m3m-jacob-and-co-residences-sector-97-noida-npxid-r450099",
                "city": "Noida",
                "rera": "RERA",
                "tags": [
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

1 optional filter available.

slug string Required

99acres landing slug ending in -ffid. Example: property-in-noida-ffid.

Example value example
page integer Optional

One-based page number. Page 2 and later append -page-{n} upstream. Example: 2.

Example value 1

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "page": 2,
        "count": 23192,
        "filters": [],
        "has_more": true,
        "per_page": 25,
        "properties": [
            {
                "id": "r450099",
                "url": "https://www.99acres.com/m3m-jacob-and-co-residences-sector-97-noida-npxid-r450099",
                "city": "Noida",
                "rera": "RERA",
                "tags": [
                    "No Brokerage",
                    "+30 Top Facilities"
                ],
                "type": "PROJECT",
                "image": "https://newprojects.99acres.com/projects/m3m_india/m3m_jacob_and_co/images/gi2uqbc_1763387010_674162207_med.jpg",
                "price": {
                    "max": 225642445,
                    "min": 80000000,
                    "label": "8 - 22.56 Cr",
                    "currency": "INR"
                },
                "state": "Uttar Pradesh",
                "heading": "M3M Jacob And Co Residences",
                "project": "M3M Jacob And Co Residences",
                "latitude": 28.53626,
                "locality": "Sector 97",
                "area_type": "super_built_up",
                "longitude": 77.35499,
                "possession": "New Launch (Completion in Jul, 2030)",
                "sub_heading": "3, 4, 5 BHK Apartment in Sector 97, Noida",
                "builder_name": "M3M India",
                "price_per_sqft": 32000,
                "transaction_type": "sale",
                "property_category": "residential"
            },
            {
                "id": "r410958",
                "url": "https://www.99acres.com/max-estates-128-sector-128-noida-npxid-r410958",
                "city": "Noida",
                "rera": "RERA",
                "tags": [
                    "No Brokerage",
                    "3D Floor Plans Available",
                    "+30 Top Facilities"
                ],
                "type": "PROJECT",
                "image": "https://newprojects.99acres.com/projects/max_estates/max_estates_128/images/ydrv2vt_1751263875_613360009_med.jpg",
                "price": {
                    "max": 327696000,
                    "min": 113485921,
                    "label": "11.35 - 32.77 Cr",
                    "currency": "INR"
                },
                "state": "Uttar Pradesh",
                "heading": "Max Estates 128",
                "project": "Max Estates 128",
                "latitude": 28.52824,
                "locality": "Sector 128",
                "area_type": "super_built_up",
                "longitude": 77.36122,
                "possession": "Under Construction (Completion in May, 2028)",
                "sub_heading": "4, 5 BHK Apartment in Sector 128, Noida",
                "builder_name": "Max Estates",
                "price_per_sqft": 26000,
                "transaction_type": "sale",
                "property_category": "residential"
            }
        ],
        "total_pages": 928
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A required parameter or a range is invalid. This response is not billable.

{
    "errors": {
        "slug": [
            "The slug field is required."
        ]
    },
    "message": "The request validation failed"
}
404

Not Found

99acres has no such landing slug. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "search"
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "The requested resource was not found."
    },
    "success": false
}
503

Upstream Unavailable

The upstream service is temporarily unavailable. Please retry shortly.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "99acres could not be reached. Please retry shortly."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.