# Search Count

Get total listing count for a placeId + distribution + estateType using Immowelt BFF.

- **Documentation:** [https://scrappa.co/docs/immowelt-api/immowelt_count](https://scrappa.co/docs/immowelt-api/immowelt_count)
- **API group:** Immowelt API
- **Endpoint:** `GET https://scrappa.co/api/immowelt/count`

## 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 |
| --- | --- | --- | --- |
| `place_id` | string | Yes | Immowelt placeId (e.g. "AD08DE8634" for Berlin) |
| `distribution` | string | No | Rent or Buy (default: Rent) |
| `estate_type` | string | No | Apartment or House (default: Apartment) |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/immowelt/count?place_id=AD08DE8634&distribution=Rent&estate_type=Apartment"
```

## Example response

```json
{
    "success": true,
    "total_count": 5132
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 400 | Invalid Location | The supplied Immowelt place_id is validly formatted but could not be resolved to a place with coordinates. |
| 401 | Unauthorized | API key is missing or invalid. |
| 422 | Validation Error | One or more query parameters failed validation. |
| 429 | Upstream Rate Limited | Immowelt or the proxy path returned a rate limit response while resolving count data. |
| 502 | Upstream Error | Immowelt returned a non-success response while resolving place data or the search count. |
| 503 | Proxy Or Upstream Unavailable | The count request exhausted its endpoint-local proxy/timeout budget before a successful Immowelt response. |

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