# Zameen Categories API Documentation

<p><strong>Zameen Categories API</strong> List the three category groups (Homes, Plots, Commercial) and their types with id, slug, name and Urdu name. Use a slug as the category parameter of the search endpoint.</p>

- **Documentation:** [https://scrappa.co/docs/zameen-api/zameen_categories](https://scrappa.co/docs/zameen-api/zameen_categories)
- **API group:** Zameen API
- **Endpoint:** `GET https://scrappa.co/api/zameen/categories`

## 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.

## Example response

```json
{
    "data": {
        "categories": [
            {
                "id": "2",
                "name": "Plots",
                "slug": "Plots",
                "level": 0,
                "name_ur": "\u067e\u0644\u0627\u0679\u0633",
                "children": [
                    {
                        "id": "11",
                        "name": "Commercial Plots",
                        "slug": "Commercial_Plots",
                        "level": 1,
                        "name_ur": "\u06a9\u0645\u0631\u0634\u0644 \u067e\u0644\u0627\u0679",
                        "children": []
                    },
                    {
                        "id": "12",
                        "name": "Residential Plots",
                        "slug": "Residential_Plots",
                        "level": 1,
                        "name_ur": "\u0631\u06c1\u0627\u0626\u0634\u06cc \u067e\u0644\u0627\u0679",
                        "children": []
                    }
                ]
            },
            {
                "id": "3",
                "name": "Commercial",
                "slug": "Commercial",
                "level": 0,
                "name_ur": "\u06a9\u0645\u0631\u0634\u0644",
                "children": [
                    {
                        "id": "15",
                        "name": "Shops",
                        "slug": "Retail_Shops",
                        "level": 1,
                        "name_ur": "\u062f\u06a9\u0627\u0646\u0627\u062a",
                        "children": []
                    },
                    {
                        "id": "16",
                        "name": "Buildings",
                        "slug": "Buildings",
                        "level": 1,
                        "name_ur": "\u0639\u0645\u0627\u0631\u062a\u06cc\u06ba",
                        "children": []
                    }
                ]
            },
            {
                "id": "1",
                "name": "Homes",
                "slug": "Homes",
                "level": 0,
                "name_ur": "\u06af\u06be\u0631",
                "children": [
                    {
                        "id": "8",
                        "name": "Flats",
                        "slug": "Flats_Apartments",
                        "level": 1,
                        "name_ur": "\u0641\u0644\u06cc\u0679",
                        "children": []
                    },
                    {
                        "id": "9",
                        "name": "Houses",
                        "slug": "Houses_Property",
                        "level": 1,
                        "name_ur": "\u0645\u06a9\u0627\u0646\u0627\u062a",
                        "children": []
                    }
                ]
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "categories"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 503 | Temporarily Unavailable | Zameen did not answer or refused the request after several attempts. This response is not billable. Retry after a short pause. |

## 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)