Skip to content
Scrappa Get API key
Housing.com API 1 credit/request

Housing.com Agent Listings API Documentation

GET https://scrappa.co/api/housing-com/agent/listings

Housing.com Agent Listings API List the properties one agent or agency offers, in the same row shape as the search endpoint. Send the listings_hash from the agent endpoint or from sellers[].listings_hash of a search row. Choose buy or rent and page through the results with 30 rows per page. An agent without properties for the service answers an empty list with total_count 0.

Housing.com Agent Listings API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/housing-com/agent/listings
Auth header
x-api-key
Cost
1 credit/request
listings_hash = example
Response preview
200 OK
{
    "data": {
        "page": 1,
        "size": 30,
        "count": 1,
        "service": "buy",
        "has_more": true,
        "listings": [
            {
                "url": "https://housing.com/in/buy/resale/page/19915623-2-bhk-apartment-in-powai-for-rs-22600000",
                "area": {
                    "unit": "sq.ft",
                    "display": "816 sq.ft",
                    "built_up": 816
...

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.

2 optional filters available.

listings_hash string Required

The listings_hash of the agent, e.g. A14wpbtac7czuar3d8pu9s14fd.

Example value example
service string Optional

buy or rent. Default buy.

Example value example
page integer Optional

Page number, 1 or more. Every page holds up to 30 rows. Default 1.

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": 1,
        "size": 30,
        "count": 1,
        "service": "buy",
        "has_more": true,
        "listings": [
            {
                "url": "https://housing.com/in/buy/resale/page/19915623-2-bhk-apartment-in-powai-for-rs-22600000",
                "area": {
                    "unit": "sq.ft",
                    "display": "816 sq.ft",
                    "built_up": 816
                },
                "tags": [
                    "rera_verified"
                ],
                "type": "resale",
                "badge": null,
                "label": null,
                "price": {
                    "max": 22600000,
                    "min": 22600000,
                    "unit": null,
                    "amount": 22600000,
                    "deposit": null,
                    "display": "\u20b92.26 Cr",
                    "currency": "INR",
                    "brokerage": 0,
                    "total_rent": null,
                    "maintenance": null,
                    "lock_in_period": null,
                    "deposit_display": null,
                    "brokerage_display": null,
                    "maintenance_display": null
                },
                "title": "2 BHK Flat",
                "images": [
                    "https://is1-2.housingcdn.com/01c16c28/6a5f741b156c840848969d9cc9c4a15e/v0/version/2_bhk_apartment-for-sale-powai-Mumbai-bedroom_one.jpg",
                    "https://is1-3.housingcdn.com/01c16c28/1f3fc4ad93a72d5ee00d09cb2bf7f425/v0/version/2_bhk_apartment-for-sale-powai-Mumbai-bedroom_two.jpg",
                    "https://is1-3.housingcdn.com/01c16c28/b774a5af70aec36c58a075b9d04a59ac/v0/version/2_bhk_apartment-for-sale-powai-Mumbai-living_room.jpg"
                ],
                "parking": 1,
                "sellers": [
                    {
                        "id": "0cf195fc-c33e-43f5-b24a-8c9f57a20ca9",
                        "firm": "Truva",
                        "name": "Truva",
                        "type": "Seller",
                        "badge": "ULTRA",
                        "image": null,
                        "is_paid": true,
                        "designation": "Housing Ultra",
                        "is_certified": false,
                        "phone_masked": "72080.....",
                        "listings_hash": "A14wpbtac7czuar3d8pu9s14fd",
                        "customers_served": "300+"
                    }
                ],
                "bedrooms": 2,
                "features": [
                    {
                        "id": "builtUpArea",
                        "label": "Built Up Area",
                        "value": "816 sq.ft"
                    },
                    {
                        "id": "avgPrice",
                        "label": "Avg. Price",
                        "value": "\u20b927.7 K/sq.ft"
                    },
                    {
                        "id": "formattedPerUnitPrice",
                        "label": "Formatted per unit price",
                        "value": "\u20b927.7k/sq.ft."
                    }
                ],
                "insights": [
                    {
                        "id": "apartments",
                        "label": null,
                        "value": "816 sq.ft built up area"
                    }
                ],
                "location": {
                    "city": {
                        "id": "1ca99c33e3d8b987ccf1",
                        "name": "Mumbai",
                        "slug": "mumbai"
                    },
                    "state": {
                        "id": "82b2a9c2e9b437c9ffdc",
                        "name": "Maharashtra",
                        "slug": "maharashtra"
                    },
                    "region": {
                        "id": "7318a08bb6570a26e893",
                        "name": "Mumbai Metropolitan Region",
                        "slug": "mmr"
                    },
                    "address": "Chandivali, Powai",
                    "latitude": 19.106359,
                    "locality": {
                        "id": "dce9290ec3fe8834a293",
                        "name": "Powai",
                        "slug": "powai"
                    },
                    "longitude": 72.900993,
                    "sublocality": {
                        "id": "af22f9b1a43e2a457582",
                        "name": "Chandivali",
                        "slug": "chandivali"
                    },
                    "address_parts": []
                },
                "subtitle": "816 sq.ft built up area",
                "bathrooms": 2,
                "is_active": true,
                "posted_at": "2026-10-05T14:29:04Z",
                "developers": [],
                "furnishing": "Unfurnished",
                "highlights": [
                    "Club House",
                    "Community Hall",
                    "Gymnasium"
                ],
                "listing_id": "19915623",
                "updated_at": "2026-10-05T08:59:05.000Z",
                "cover_image": {
                    "alt": "Gallery Cover Image of 816 Sq.ft 2 BHK Apartment / Flat for sale in Godrej Urban Park, Powai for Rs. 22600000",
                    "url": "https://is1-2.housingcdn.com/01c16c28/6a5f741b156c840848969d9cc9c4a15e/v0/version/2_bhk_apartment-for-sale-powai-Mumbai-bedroom_one.jpg"
                },
                "description": "This well-designed 2 BHK apartment in Godrej Urban Park, Chandivali offers a comfortable and modern living experience. The home features a spacious balcony with open city views, allowing plenty of natural light and ve...",
                "emi_display": "\u20b91.12 Lacs",
                "image_count": 23,
                "is_verified": true,
                "verified_at": "2026-09-16T17:43:08.000Z",
                "brochure_url": null,
                "is_certified": false,
                "nearby_places": [
                    {
                        "name": "Gopal Sharma International School",
                        "type": "school",
                        "distance_km": 1.15
                    },
                    {
                        "name": "Zynova Shalby Hospital",
                        "type": "hospital",
                        "distance_km": 2.05
                    }
                ],
                "review_rating": null,
                "configurations": [
                    {
                        "area": 816,
                        "label": "2 BHK",
                        "price": 22600000,
                        "area_type": "Built Up Area",
                        "area_unit": "sq.ft",
                        "rera_status": null,
                        "price_display": "\u20b9 2.26 Cr",
                        "property_type": "Apartment"
                    }
                ],
                "digital_tour_url": null,
                "possession_status": null,
                "original_listing_id": "19915623",
                "is_under_construction": false
            }
        ],
        "total_count": 59
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agent_listings",
        "duplicates_removed": 0
    },
    "success": true
}

Errors

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

422

Validation Error

A required parameter is missing or invalid. This response is not billable.

{
    "errors": {
        "city": [
            "A city is required, e.g. Mumbai. Use the cities endpoint for the list."
        ]
    },
    "message": "The request validation failed"
}
503

Temporarily Unavailable

Housing.com did not answer or refused the request after several attempts. This response is not billable. Retry after a short pause.

{
    "meta": {
        "attempts": 3,
        "billable": false,
        "retryable": true
    },
    "error": {
        "message": "Housing.com data is temporarily unavailable. Please retry.",
        "failure_type": "upstream_timeout"
    },
    "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.