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

99acres Listing API Documentation

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

99acres Listing API returns the full public record of one 99acres listing: price as a major-unit INR number, price per square foot, area, bedrooms, bathrooms, balconies, floor and total floors, facing, furnishing, availability, age, overlooking, power backup, brokerage, society and builder, locality, city, coordinates, the gallery images, rating, RERA tag and the SEO URL. Key on spid only; the SEO slug token rotates for the same listing and is optional.

99acres Listing API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/99acres/v1/listing
Auth header
x-api-key
Cost
1 credit/request
spid = example
Response preview
200 OK
{
    "data": {
        "property": {
            "id": "B93310802",
            "age": "1 to 5 Year Old",
            "url": "https://www.99acres.com/4-bhk-bedroom-apartment-flat-for-sale-in-apex-athena-sector-75-noida-2725-sqft-spid-B93310802",
            "area": {
                "sqft": 2725,
                "unit": "sqft",
                "label": "2725.0 sqft",
                "value": 2725
            },
            "city": "Noida",
            "rera": "RERA",
...

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.

spid string Required

Listing id, one letter plus 7-8 digits. Example: B93310802.

Example value example
slug string Optional

Optional SEO slug; omit it and the site redirects from the id alone.

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": {
        "property": {
            "id": "B93310802",
            "age": "1 to 5 Year Old",
            "url": "https://www.99acres.com/4-bhk-bedroom-apartment-flat-for-sale-in-apex-athena-sector-75-noida-2725-sqft-spid-B93310802",
            "area": {
                "sqft": 2725,
                "unit": "sqft",
                "label": "2725.0 sqft",
                "value": 2725
            },
            "city": "Noida",
            "rera": "RERA",
            "type": "PROPERTY",
            "floor": 8,
            "image": "https://imagecdn.99acres.com/media1/42371/2/847422597M-1790421175814.jpg",
            "price": {
                "max": 38100000,
                "min": 38100000,
                "label": "Rs 3.81 Cr",
                "currency": "INR"
            },
            "facing": "East",
            "images": [
                "https://imagecdn.99acres.com/media1/42371/2/847422597M-1790421175814.jpg",
                "https://imagecdn.99acres.com/media1/42371/1/847421427M-1790421100715.jpg"
            ],
            "posted": "Updated 6d ago by dealer",
            "rating": 3.6,
            "heading": "4 BHK Apartment / Flat for sale in Apex Athena Sector 75 Noida - 2725 Sqft- 8th floor (out of 25)",
            "project": "Apex Athena",
            "society": "Apex Athena",
            "bedrooms": 4,
            "latitude": 28.5761901,
            "locality": "Sector 75, Noida",
            "verified": true,
            "balconies": 4,
            "bathrooms": 5,
            "brokerage": false,
            "longitude": 77.3844317,
            "furnishing": "Semifurnished",
            "description": "The flat is facing the east direction. Containing 4 bedroom(s), 5 bathrooms and more than 3 balconies, this flat is spread over a super built up area of 2725 sq.Ft. This flat lies on the 8th level of a 25 storey building. Being a ready to move project, you can expect immediate possession of this 1-5 years old property. The beautifully designed ceramic flooring enhances the beauty of the flat. Moreover, this property offers close proximity to important landmarks such as close to metro station. Apex athena is designed very well to provide modern facilities such as swimming pool, gymnasium, club house, park, shopping centre, grocery shop, cctv surveillance, lift(s), security guard and maintenance staff.",
            "floor_label": "8th / 25 floors building",
            "image_count": 16,
            "overlooking": "Park,Main Road,Club",
            "availability": "Immediate",
            "builder_name": "Apex Group",
            "power_backup": "Full",
            "review_count": 5,
            "total_floors": 25,
            "price_per_sqft": 13981,
            "property_class": "A",
            "transaction_type": "sale",
            "property_category": "residential",
            "transaction_label": "Resale"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "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 listing. This response is not billable.

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