# Funda Broker API Documentation

<p><strong>Funda Broker API Documentation</strong> Retrieve the public profile of one Funda broker office: name, affiliation, slogan, description, public business contact data, address, logo, photos, certificates, languages, services, specialties, team, opening hours and social links. Find the broker id in the broker field of the listing endpoint. An unknown broker id returns 404 and is not billable.</p>

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

## 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. Take it from broker.id of the listing endpoint. |

## Example response

```json
{
    "data": {
        "broker": {
            "id": 4212,
            "url": "https://www.funda.nl/makelaar/4212/",
            "logo": "https://cloud.funda.nl/valentina_media/142/464/341.jpg?options=fit=scale-down,width=720",
            "name": "Naober Makelaars",
            "images": [
                "https://cloud.funda.nl/valentina_media/227/554/135.jpg?options=fit=scale-down,width=2160"
            ],
            "region": "coevorden",
            "slogan": "Naober Makelaars, uw makelaar in regio Coevorden.",
            "social": {
                "facebook": "https://www.facebook.com/naobermakelaars"
            },
            "contact": {
                "email": "info@naobermakelaars.nl",
                "phone": "0524-525490",
                "address": {
                    "city": "COEVORDEN",
                    "street": "Printer",
                    "postal_code": "7741 ME",
                    "house_number": "9",
                    "house_number_addition": "C"
                },
                "website": "https://www.naobermakelaars.nl"
            },
            "services": [
                "Verkoop",
                "Aankoop",
                "Taxaties"
            ],
            "employees": [
                {
                    "name": "John Sch\u00fcrmann A-RMT",
                    "role": "AssistentMakelaar"
                },
                {
                    "name": "Sabine Bakker",
                    "role": "OfficeManager"
                }
            ],
            "languages": [
                "Nederlands",
                "Engels",
                "Duits"
            ],
            "affiliation": "NVM",
            "description": "U kiest toch voor resultaat? Wij ook.\n\nWanneer u uw woning wilt verkopen of een woning wilt kopen en u zoekt daarvoor hu...",
            "office_type": "Pro",
            "reviews_url": "https://www.funda.nl/makelaars/coevorden/4212/beoordelingen/",
            "specialties": [
                "Nieuwbouw",
                "Woningfotografie"
            ],
            "certificates": [
                "VastgoedCert",
                "Nederlands Register Vastgoed Taxateurs",
                "Nederlands Woning Waarde Instituut"
            ],
            "has_listings": true,
            "opening_hours": [
                {
                    "day": "monday",
                    "times": [
                        {
                            "to": "12:00",
                            "from": "09:00"
                        },
                        {
                            "to": "17:00",
                            "from": "13:00"
                        }
                    ],
                    "by_appointment": false
                },
                {
                    "day": "tuesday",
                    "times": [
                        {
                            "to": "12:00",
                            "from": "09:00"
                        },
                        {
                            "to": "17:00",
                            "from": "13:00"
                        }
                    ],
                    "by_appointment": false
                },
                {
                    "day": "wednesday",
                    "times": [
                        {
                            "to": "12:00",
                            "from": "09:00"
                        },
                        {
                            "to": "17:00",
                            "from": "13:00"
                        }
                    ],
                    "by_appointment": false
                },
                {
                    "day": "thursday",
                    "times": [
                        {
                            "to": "12:00",
                            "from": "09:00"
                        },
                        {
                            "to": "17:00",
                            "from": "13:00"
                        }
                    ],
                    "by_appointment": false
                },
                {
                    "day": "friday",
                    "times": [
                        {
                            "to": "12:00",
                            "from": "09:00"
                        },
                        {
                            "to": "17:00",
                            "from": "13:00"
                        }
                    ],
                    "by_appointment": false
                }
            ],
            "short_description": "Naober Makelaars is een allround makelaarskantoor. We weten alles van de lokale ..."
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "broker"
    },
    "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)