# Zoopla Market Activity

Return available sales activity and average price information for a geographic area, date range, and property type.

- **Documentation:** [https://scrappa.co/docs/zoopla-api/zoopla_market_activity](https://scrappa.co/docs/zoopla-api/zoopla_market_activity)
- **API group:** Zoopla API
- **Endpoint:** `GET https://scrappa.co/api/zoopla/market-activity`

## 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 |
| --- | --- | --- | --- |
| `geo` | string | Yes | Geographic identifier for the area. |
| `range_months` | string | No | Time range: THREE_MONTHS, SIX_MONTHS, TWELVE_MONTHS, FIVE_YEARS, TEN_YEARS, or ALL. Defaults to TWELVE_MONTHS. |
| `house_type` | string | No | Property type: ALL, DETACHED, SEMI_DETACHED, FLAT, or TERRACED. Defaults to ALL. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/zoopla/market-activity?geo=m1&range_months=TWELVE_MONTHS&house_type=ALL"
```

## Example response

```json
{
    "success": true,
    "geo_string": "m1",
    "range_months": "TWELVE_MONTHS",
    "house_type": "ALL",
    "properties_sold": 126,
    "average_price_paid": 236054,
    "data_available": true,
    "upstream_error": null
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 401 | Unauthorized | Authentication is required to use this endpoint. |
| 422 | Validation Error | One or more input parameters are missing or invalid. |
| 404 | Integration Disabled | This integration is currently disabled on the server. Availability is switched per environment, so it can be off during a staged rollout. |
| 500 | Internal Error | The request could not be processed because of a fault in this service, not the data source. No credit is charged. |
| 503 | Unusable Upstream Response | The data source answered but the response could not be used: empty, oversized, undecodable, or carrying errors with no usable data. No credit is charged. |
| 503 | Upstream Unavailable | The data source could not complete this request. Try again later. |

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