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

99acres City Listings API Documentation

GET https://scrappa.co/api/99acres/v1/city-listings

99acres City Listings API returns the property cards of a 99acres city landing page (/{City}-Real-Estate.htm) as JSON. The page is a recommendation carousel, not a paged search, so there is no page parameter. Each card carries the listing id, a built heading, project, price as a major-unit INR number, price per square foot, area, bedrooms, bathrooms, locality, city, coordinates, an absolute image and web URL, and the verified flag.

99acres City Listings API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/99acres/v1/city-listings
Auth header
x-api-key
Cost
1 credit/request
city = example
Response preview
200 OK
{
    "data": {
        "city": "Delhi",
        "properties": [
            {
                "id": "89770168",
                "url": "https://www.99acres.com/2-bhk-bedroom-independent-builder-floor-for-sale-in-sector-14-dwarka-delhi-495-sqft-r1-spid-L89770168",
                "area": {
                    "unit": "sq.yards",
                    "label": "200 sq.yards",
                    "value": 200
                },
                "city": "Delhi South West",
                "type": "PROPERTY",
...

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.

city string Required

City token as it appears in the site URL, letters and hyphens only. Example: Delhi.

Example value example

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": {
        "city": "Delhi",
        "properties": [
            {
                "id": "89770168",
                "url": "https://www.99acres.com/2-bhk-bedroom-independent-builder-floor-for-sale-in-sector-14-dwarka-delhi-495-sqft-r1-spid-L89770168",
                "area": {
                    "unit": "sq.yards",
                    "label": "200 sq.yards",
                    "value": 200
                },
                "city": "Delhi South West",
                "type": "PROPERTY",
                "image": "https://imagecdn.99acres.com/media1/36574/5/731485890T-1774333042046.jpg",
                "price": {
                    "max": 3800000,
                    "min": 3800000,
                    "label": "Rs 38 L",
                    "currency": "INR"
                },
                "heading": "2 BHK Independent/Builder Floor, 2 Baths",
                "project": "PNM HOMES",
                "bedrooms": 2,
                "latitude": 28.6137768,
                "locality": "Sector 14 Dwarka, Delhi",
                "verified": true,
                "bathrooms": 2,
                "longitude": 77.0303903,
                "description": "Furnished two bedroom set with dinning hall\n Registered property & upto 90% home loan available\n Modular kitchen with chimney\n Fancy lights in all rooms, latest fall ceiling\n Electricity and water connections are available\n Separate water tank for each flat\n Delhi jal board & submersible both water are available\n Walking distance from metro station\n Markets, schools, hospitals all are within 1 km\n Car parking space avialable\n Lift facility with power back up\n 01 balcony\n Bathroom with modern facilities\n Branded fans with 2yr warranty in all rooms\n Wardrobe & tv panel\n Wallpaper & royal paint in all room\n 24x7 running water\n Branded electric fitting\n Anti skid tile flooring",
                "price_per_sqft": 19000,
                "transaction_type": "sale",
                "property_category": "residential"
            },
            {
                "id": "92548490",
                "url": "https://www.99acres.com/2-bhk-bedroom-apartment-flat-for-sale-in-sector-14-dwarka-delhi-650-sqft-spid-P92548490",
                "area": {
                    "unit": "sq.ft."
                },
                "city": "Delhi South West",
                "type": "PROPERTY",
                "image": "https://imagecdn.99acres.com/media1/39714/9/794289537T-1784012314235.jpg",
                "price": {
                    "max": 4000000,
                    "min": 4000000,
                    "label": "Rs 40 L",
                    "currency": "INR"
                },
                "heading": "2 BHK Residential Apartment, 2 Baths",
                "project": "Green Valley Homes",
                "bedrooms": 2,
                "latitude": 28.6220715,
                "locality": "Sector 14 Dwarka, Delhi",
                "bathrooms": 2,
                "longitude": 77.019749,
                "description": "Furnished 2 bedroom set with dinning hall\n Registered property & upto 90% home loan available\n Modular kitchen with chimney\n Fancy lights in all rooms, latest fall ceiling\n Separate electricity and water connections are available\n Separate water tank for each flat\n Delhi jal board & submersible both water supply are available\n Walking distance from metro station\n Markets, schools, hospitals all are within 500 km\n Car parking space available\n Lift facility with power back up\n Attached balcony\n Bathroom with modern facilities\n Branded fans with 2yr warranty in all rooms\n Modern wardrobes & tv panel\n Designer wallpaper & royal paint in all room\n 24x7 running water\n Branded electric fitting\n Anti skid tile flooring",
                "price_per_sqft": 6153,
                "transaction_type": "sale",
                "property_category": "residential"
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "city_listings"
    },
    "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 city. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "city_listings"
    },
    "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": "city_listings"
    },
    "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.