# Blocket Bostad Landlord Profile API Documentation

Scrappa's `GET /api/blocket-bostad/landlord` returns the public profile of one Blocket Bostad landlord or agency by `uid`. Take the `uid` from `landlord.uid` on a listing.

## What you get

`uid`, `company_name`, `professional`, `pro_agent` and `premium` flags (agencies set `professional` or `pro_agent`), `main_platform`, `identity_confirmed`, `response_rate`, `response_time_hours`, `picture_url` (agencies only), `member_since`, `homes_count` and `homes` (the landlord's active homes with `id`, `rent` and `url`).

## Privacy

Private landlords are shown without a name, bio or picture. The last seen date, age, email, phone number and income are never returned.

- **Documentation:** [https://scrappa.co/docs/blocket-bostad-api/blocket_bostad_landlord](https://scrappa.co/docs/blocket-bostad-api/blocket_bostad_landlord)
- **API group:** Blocket Bostad API
- **Endpoint:** `GET https://scrappa.co/api/blocket-bostad/landlord`

## 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 |
| --- | --- | --- | --- |
| `uid` | string | Yes | Landlord uid from a listing, for example eht576q4. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/blocket-bostad/landlord?uid=eht576q4"
```

## Example response

```json
{
    "success": true,
    "data_source": "Blocket Bostad (Qasa)",
    "landlord": {
        "uid": "eht576q4",
        "company_name": "Example Bost\u00e4der AB",
        "professional": true,
        "pro_agent": false,
        "premium": true,
        "main_platform": "blocket",
        "identity_confirmed": true,
        "response_rate": 0.9,
        "response_time_hours": 4,
        "picture_url": "https://example.com/logo.jpg",
        "member_since": "2020-03-01T10:00:00Z",
        "homes_count": 1,
        "homes": [
            {
                "id": "1492340",
                "rent": 11200,
                "url": "https://qasa.com/se/sv/home/1492340"
            }
        ]
    },
    "meta": {
        "endpoint_family": "landlord",
        "billable": true,
        "attempts": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | Nothing exists with that identifier on Blocket Bostad (`not_found`). Non-billable. |
| 422 | Validation Error | A query parameter is missing, unknown or unusable. Unknown parameters are rejected, never ignored. Non-billable. |
| 503 | Upstream Unavailable | Blocket Bostad could not be reached after retries, answered with an error, or its area list is not available (`upstream_unavailable`, `upstream_blocked`, `parser_drift`, `area_list_unavailable`). Retryable and never billed. Clients are never rate limited. |

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