# Imobiliare.ro Agency Profile API Documentation

Retrieve a public agency or developer profile: name, legal name, description, logo, address, public contact data and the listings the profile page offers (id, title and price). The listing part shows only the offers the page itself lists and can be incomplete. Pass the profile URL or the slug of the agency. Agency names and slugs come from the agency field of search results and from the contact section of a listing. There is no separate public page for single agents: the agent name comes with the listing detail.

- **Documentation:** [https://scrappa.co/docs/imobiliare-ro-api/imobiliare_ro_agency](https://scrappa.co/docs/imobiliare-ro-api/imobiliare_ro_agency)
- **API group:** Imobiliare.ro API
- **Endpoint:** `GET https://scrappa.co/api/imobiliare-ro/agency`

## 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 |
| --- | --- | --- | --- |
| `url` | string | No | Agency or developer profile URL, e.g. https://www.imobiliare.ro/agentie/habitat-group-estate. Use url or slug. |
| `slug` | string | No | Profile slug, e.g. habitat-group-estate. Use url or slug. |
| `kind` | string | No | agency (default) or developer. Used with slug. |
| `id` | integer | No | Optional numeric agency id that some profile URLs carry after the slug. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/imobiliare-ro/agency?slug=habitat-group-estate"
```

## Example response

```json
{
    "success": true,
    "data": {
        "agency": {
            "name": "HABITAT GROUP ESTATE",
            "legal_name": "HABITAT GROUP & PROJECT MANAGEMENT SRL",
            "type": "RealEstateAgent",
            "url": "https://www.imobiliare.ro/agentie/habitat-group-estate",
            "description": "HABITAT GROUP ESTATE este o agen\u021bie imobiliar\u0103 \u00een Bucure\u0219ti.",
            "listings": [
                {
                    "id": 276135922,
                    "title": "Apartament 4 Camere Decomandat, 113 mp 2 bai 3 balcoane etaj 1 Zona Grand Arena",
                    "price_amount": 190405,
                    "price_currency": "EUR"
                }
            ],
            "listings_partial": true
        }
    },
    "meta": {
        "endpoint_family": "agency",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | The listing or profile does not exist. Not billed. |
|  | Error | Imobiliare.ro could not be reached right now. Not billed. |
|  | Error | Imobiliare.ro refused the request. Not billed. |
|  | Error | Imobiliare.ro returned an unexpected payload or a filter was not applied. Not billed. |

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