# 99acres Listing API Documentation

<p><strong>99acres Listing API</strong> 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 <code>spid</code> only; the SEO slug token rotates for the same listing and is optional.</p>

- **Documentation:** [https://scrappa.co/docs/99acres-api/99acres_listing](https://scrappa.co/docs/99acres-api/99acres_listing)
- **API group:** 99acres API
- **Endpoint:** `GET https://scrappa.co/api/99acres/v1/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `spid` | string | Yes | Listing id, one letter plus 7-8 digits. Example: B93310802. |
| `slug` | string | No | Optional SEO slug; omit it and the site redirects from the id alone. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a range is invalid. This response is not billable. |
| 404 | Not Found | 99acres has no such listing. This response is not billable. |
| 503 | Upstream Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)