Skip to content
Scrappa Get API key
Zameen API 1 credit/request

Zameen Property Search API Documentation

GET https://scrappa.co/api/zameen/search

Zameen Property Search API Search homes, plots and commercial property for sale or for rent. Every filter is applied by Zameen inside the search, so no row breaks a filter you set. Each listing has the id, title (also in Urdu), URL and slug, price in PKR, bedrooms, bathrooms, the area in square metres, square feet, square yards, marla and kanal, position, the location hierarchy with slugs, the category, dates, the cover photo and the number of photos and videos, verification, furnishing, completion and ownership status, amenities, a short description, contact name and phone numbers as Zameen publishes them, and the agency. Values that do not apply, such as bedrooms of a plot, are null. Use rent_frequency as given: it is null when Zameen does not say. Search reaches the first 10,000 results of a query: page times per_page must be at most 10,000, and total_pages and results_capped say so. Use the slug field with the listing endpoint for the full description and all photos.

Zameen Property Search API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/zameen/search
Auth header
x-api-key
Cost
1 credit/request
purpose = example
Response preview
200 OK
{
    "data": {
        "page": 1,
        "count": 25,
        "facets": {
            "purpose": {
                "for-sale": 15989
            },
            "category": {
                "Homes": 15989,
                "Houses_Property": 15989
            }
        },
        "purpose": "sale",
...

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.

15 optional filters available.

purpose string Required

sale or rent.

Example value example
category string Optional

Optional. A category slug from the categories endpoint, e.g. Homes, Houses_Property, Flats_Apartments, Plots, Commercial. The same slugs work for sale and rent.

Example value example
location string Optional

Optional. A location slug from the autocomplete endpoint, e.g. /Lahore_DHA_Defence-9. It matches the area and everything inside it.

Example value Austin, Texas
price_min number Optional

Optional. Lowest price in PKR (for rent: the price per rent period).

Example value 10
price_max number Optional

Optional. Highest price in PKR.

Example value 10
bedrooms string Optional

Optional. One number or a comma list, e.g. 3 or 3,4. Exact number of bedrooms.

Example value example
bathrooms string Optional

Optional. One number or a comma list, e.g. 2,3. Exact number of bathrooms.

Example value example
area_min number Optional

Optional. Smallest area in the unit of area_unit.

Example value 10
area_max number Optional

Optional. Largest area in the unit of area_unit.

Example value 10
area_unit string Optional

Unit of area_min and area_max: sqm, sqft, sqyd, marla or kanal (default sqm). One marla is 225 square feet. One kanal is 20 marla.

Example value example
is_verified boolean Optional

Optional. true returns only ads that Zameen verified.

Example value true
agency_id string Optional

Optional. Only ads of one agency. Use the agency id from a search result or the agencies endpoint.

Example value 1234567890
amenities string Optional

Optional. One name or a comma list of amenity names, e.g. Swimming Pool,Lawn or Garden. A result has all of them. Use names as they appear in the amenities of a result.

Example value example
sort string Optional

date_desc (default, newest first), updated_desc, price_asc or price_desc.

Example value relevance
page integer Optional

Page number, from 1 (default 1). Search reaches the first 10,000 results: page times per_page must be at most 10,000.

Example value 1
per_page integer Optional

Rows per page, 1 to 50 (default 25).

Example value 10

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,
        "count": 25,
        "facets": {
            "purpose": {
                "for-sale": 15989
            },
            "category": {
                "Homes": 15989,
                "Houses_Property": 15989
            }
        },
        "purpose": "sale",
        "has_more": true,
        "listings": [
            {
                "id": "49664821",
                "url": "https://www.zameen.com/Property/scheme_33_saadi_town_smart_living_120_g_1-49664821-6853-1.html",
                "area": {
                    "sqm": 100.34,
                    "sqft": 1080,
                    "sqyd": 120,
                    "kanal": 0.24,
                    "marla": 4.8
                },
                "slug": "scheme_33_saadi_town_smart_living_120_g_1-49664821-6853-1",
                "price": 20000000,
                "title": "Smart Living 120 G+1",
                "agency": {
                    "id": "190203",
                    "logo": "https://zameen-dev.s3.eu-west-1.amazonaws.com/image/164488781/bdddabcc806c4d78a7fa9bcca1d71a88",
                    "name": "Ali Estate",
                    "slug": "Karachi-Ali_Estate-190203-1",
                    "tier": 4,
                    "name_ur": "Ali Estate"
                },
                "contact": {
                    "name": "Ali Abbas Noorani",
                    "phone": "+923000000000",
                    "mobile": "+923000000000",
                    "whatsapp": "+923000000000"
                },
                "purpose": "sale",
                "bedrooms": 4,
                "category": {
                    "type": {
                        "name": "Houses",
                        "slug": "Houses_Property"
                    },
                    "parent": {
                        "name": "Homes",
                        "slug": "Homes"
                    }
                },
                "currency": "PKR",
                "keywords": [
                    "lounge",
                    "kitchen",
                    "parking"
                ],
                "location": [
                    {
                        "id": "1521",
                        "name": "Pakistan",
                        "slug": "/Pakistan-1521",
                        "level": 0,
                        "name_ur": "\u067e\u0627\u06a9\u0633\u062a\u0627\u0646"
                    },
                    {
                        "id": "1523",
                        "name": "Sindh",
                        "slug": "/Sindh-1523",
                        "level": 1,
                        "name_ur": "\u0633\u0646\u062f\u06be"
                    },
                    {
                        "id": "2",
                        "name": "Karachi",
                        "slug": "/Karachi-2",
                        "level": 2,
                        "name_ur": "\u06a9\u0631\u0627\u0686\u06cc"
                    },
                    {
                        "id": "495",
                        "name": "Scheme 33",
                        "slug": "/Karachi_Scheme_33-495",
                        "level": 3,
                        "name_ur": "\u0633\u06a9\u06cc\u0645 33"
                    },
                    {
                        "id": "6853",
                        "name": "Saadi Town",
                        "slug": "/Karachi_Scheme_33_Saadi_Town-6853",
                        "level": 4,
                        "name_ur": "\u0633\u0639\u062f\u06cc \u0679\u0627\u0624\u0646"
                    }
                ],
                "title_ur": "\u0633\u0639\u062f\u06cc \u0679\u0627\u0624\u0646 \u0633\u06a9\u06cc\u0645 33,\u06a9\u0631\u0627\u0686\u06cc \u0645\u06cc\u06ba 4 \u06a9\u0645\u0631\u0648\u06ba \u06a9\u0627 5 \u0645\u0631\u0644\u06c1 \u0645\u06a9\u0627\u0646 2.0 \u06a9\u0631\u0648\u0691 \u0645\u06cc\u06ba \u0628\u0631\u0627\u0626\u06d2 \u0641\u0631\u0648\u062e\u062a\u06d4",
                "amenities": [
                    "Other Main Features",
                    "Furnished",
                    "Bedrooms",
                    "Day Care Centre"
                ],
                "bathrooms": 5,
                "geography": {
                    "is_exact": true,
                    "latitude": 24.964623,
                    "longitude": 67.168558
                },
                "occupancy": null,
                "ownership": null,
                "completion": "completed",
                "created_at": "2026-09-19T21:47:17Z",
                "furnishing": "furnished",
                "updated_at": "2026-10-04T19:00:42Z",
                "cover_photo": "https://zameen-dev.s3.eu-west-1.amazonaws.com/image/307495437/f8fcc9f460db44dd83972095e9117e0f",
                "is_verified": false,
                "photo_count": 18,
                "video_count": 0,
                "listing_tier": "premium",
                "location_path": "Saadi Town Scheme 33 Karachi Sindh Pakistan",
                "permit_number": null,
                "panorama_count": 0,
                "reactivated_at": "2026-09-19T21:47:19Z",
                "rent_frequency": null,
                "has_installments": false,
                "reference_number": null,
                "has_property_tour": false,
                "short_description": "==FEATURES==\n \n- Size: 120 SQYARDS. \n - Bedrooms: 4\n - Bathrooms: 5\n - Double\n -",
                "verification_status": "unverified"
            }
        ],
        "per_page": 25,
        "total_count": 15989,
        "total_pages": 400,
        "results_capped": true,
        "filters_applied": {
            "sort": "price_asc",
            "bedrooms": [
                4,
                5
            ],
            "category": "Houses_Property",
            "price_max": 60000000,
            "price_min": 20000000
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search"
    },
    "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": {
        "purpose": [
            "The purpose is required: sale or rent."
        ]
    },
    "message": "The request validation failed"
}
422

Result Window Exceeded

Page times per_page is above 10,000. Zameen search reaches only the first 10,000 results. Narrow the filters or lower the page. This response is not billable.

{
    "meta": {
        "attempts": 1,
        "billable": false,
        "retryable": false
    },
    "error": {
        "message": "Zameen returns at most the first 10,000 results of a search. Narrow the filters or lower the page number.",
        "failure_type": "result_window_exceeded"
    },
    "success": false
}
503

Temporarily Unavailable

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

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