# Funda Broker Reviews API Documentation

<p><strong>Funda Broker Reviews API Documentation</strong> Retrieve the published reviews of one Funda broker office: posting date, transaction type, review text and the scores for expertise, local market knowledge, price and quality, and service and guidance, plus the average score and review count when available. A broker without reviews returns an empty reviews list.</p>

- **Documentation:** [https://scrappa.co/docs/funda-api/funda_broker_reviews](https://scrappa.co/docs/funda-api/funda_broker_reviews)
- **API group:** Funda API
- **Endpoint:** `GET https://scrappa.co/api/funda/broker/reviews`

## 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 |
| --- | --- | --- | --- |
| `broker_id` | integer | Yes | Funda broker office number as an integer, e.g. 4212. |

## Example response

```json
{
    "data": {
        "reviews": [
            {
                "text": "Ons huis is snel verkocht! De makelaar gaf tips  het huis foto \u201cklaar\u201d te maken en dacht mee over de prijs,  om mijn huis snel te verkopen. \nEr was goed contact en overleg",
                "scores": {
                    "average": 10,
                    "expertise": 10,
                    "price_and_quality": 10,
                    "service_and_guidance": 10,
                    "local_market_knowledge": 10
                },
                "posted_at": "2026-10-17T12:03:13Z",
                "transaction_type": "Sale"
            }
        ],
        "summary": {
            "average": 9.5,
            "review_count": 72,
            "selectivity_percentage": 98
        },
        "broker_id": 4212
    },
    "meta": {
        "billable": true,
        "endpoint_family": "broker_reviews"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. No upstream request is made. This response is not billable. |
| 404 | Broker Not Found | No Funda broker exists for the requested id. This response is not billable and is not retried. |
| 502 | Unexpected Response | Funda returned data in an unexpected shape. This response is not billable. Retry later. |
| 503 | Funda Unavailable | Funda could not be reached or blocked the request after retries. This response is not billable. Retry shortly. |

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