# 99acres Filter Landings API Documentation

<p><strong>99acres Filter Landings API</strong> returns a 99acres filter landing page (BHK, budget, property type, locality) as JSON. It shares the same server-rendered surface, response shape and pagination as the search endpoint, and exists as its own route so the filter landing has its own documentation and playground example. A valid empty result is a successful, billable response.</p>

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

## 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 |
| --- | --- | --- | --- |
| `slug` | string | Yes | 99acres filter landing slug ending in -ffid. Example: 2-bhk-flats-in-noida-ffid. |
| `page` | integer | No | One-based page number. Example: 1. |

## Example response

```json
{
    "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": "filter_landings"
    },
    "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 filter landing. 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)