# imot.bg Agency API Documentation

<p><strong>imot.bg Agency API</strong> returns the profile of an agency (name, address, phone, logo, member since) with one page of its listings for sale or for rent, 40 per page, in the same shape as search items. Use the <code>id</code> from the agencies directory or from a search item as <code>agency</code>. An unknown agency returns 404.</p>

- **Documentation:** [https://scrappa.co/docs/imot-bg-api/imot_bg_agency](https://scrappa.co/docs/imot-bg-api/imot_bg_agency)
- **API group:** imot.bg API
- **Endpoint:** `GET https://scrappa.co/api/imot-bg/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 |
| --- | --- | --- | --- |
| `agency` | string | Yes | Agency name as in its imot.bg address, for example ajaximoti for ajaximoti.imot.bg. |
| `deal` | string | No | sale (default) or rent. |
| `page` | integer | No | One-based page number (default 1). |

## Example response

```json
{
    "data": {
        "deal": "sale",
        "items": [
            {
                "id": "1a175320169418285",
                "url": "https://ajaximoti.imot.bg/obiava-1a175320169418285-prodava-ednostaen-apartament-grad-sofiya-druzhba-2",
                "floor": {
                    "label": "3-\u0442\u0438 \u0435\u0442. \u043e\u0442 5",
                    "total": 5,
                    "number": 3
                },
                "phone": "0886093992",
                "price": {
                    "amount": 101936,
                    "currency": "EUR"
                },
                "title": "\u041f\u0440\u043e\u0434\u0430\u0432\u0430 1-\u0421\u0422\u0410\u0415\u041d",
                "agency": {
                    "id": "ajaximoti",
                    "url": "https://ajaximoti.imot.bg",
                    "logo": null,
                    "name": "\u0410\u042f\u041a\u0421 \u041d\u0415\u0414\u0412\u0418\u0416\u0418\u041c\u0418 \u0418\u041c\u041e\u0422\u0418",
                    "address": null
                },
                "photos": [
                    "https://cdn3.focus.bg/imot/photosimotbg/1/285/1a175320169418285_HH.jpg"
                ],
                "summary": "52 \u043a\u0432.\u043c, 3-\u0442\u0438 \u0435\u0442. \u043e\u0442 5, \u0429\u0435 \u0431\u044a\u0434\u0435 \u0432\u044a\u0432\u0435\u0434\u0435\u043d \u0432 \u0435\u043a\u0441\u043f\u043b\u043e\u0430\u0442\u0430\u0446\u0438\u044f 2027 \u0433., \u0415\u0434\u043d\u043e\u0441\u0442\u0430\u0435\u043d \u0430\u043f\u0430\u0440\u0442\u0430\u043c\u0435\u043d\u0442 \u0432 \u043a\u0432. \u0414\u0440\u0443\u0436\u0431\u0430 2 \u043d\u043e\u0432\u043e \u0441\u0442\u0440\u043e\u0438\u0442\u0435\u043b\u0441\u0442\u0432\u043e, \u043e\u0442\u043b\u0438\u0447\u043d\u0430 \u043b\u043e\u043a\u0430\u0446\u0438\u044f \u0434\u043e \u043c\u0435\u0442\u0440\u043e \u041f\u0440\u0435\u0434\u043b\u0430\u0433\u0430\u043c\u0435 \u0437\u0430 \u043f\u0440\u043e ...",
                "area_sqm": 52,
                "location": "\u0433\u0440\u0430\u0434 \u0421\u043e\u0444\u0438\u044f, \u0414\u0440\u0443\u0436\u0431\u0430 2",
                "deal_type": "sale",
                "promotion": [],
                "price_text": "101 936 \u20ac",
                "year_built": 2027,
                "photo_count": 2,
                "property_type": "1-\u0421\u0422\u0410\u0415\u041d",
                "is_private_seller": false
            },
            {
                "id": "1a178669544836705",
                "url": "https://ajaximoti.imot.bg/obiava-1a178669544836705-prodava-ednostaen-apartament-grad-sofiya-krastova-vada",
                "floor": {
                    "label": "1-\u0432\u0438 \u0435\u0442. \u043e\u0442 4",
                    "total": 4,
                    "number": 1
                },
                "phone": "0882059990",
                "price": {
                    "amount": 137899,
                    "currency": "EUR"
                },
                "title": "\u041f\u0440\u043e\u0434\u0430\u0432\u0430 1-\u0421\u0422\u0410\u0415\u041d",
                "agency": {
                    "id": "ajaximoti",
                    "url": "https://ajaximoti.imot.bg",
                    "logo": null,
                    "name": "\u0410\u042f\u041a\u0421 \u041d\u0415\u0414\u0412\u0418\u0416\u0418\u041c\u0418 \u0418\u041c\u041e\u0422\u0418",
                    "address": null
                },
                "photos": [
                    "https://imotstatic2.focus.bg/imot/photosimotbg/1/705/1a178669544836705_QW.jpg",
                    "https://imotstatic2.focus.bg/imot/photosimotbg/1/705/1a178669544836705_2w.jpg"
                ],
                "summary": "44 \u043a\u0432.\u043c, 1-\u0432\u0438 \u0435\u0442. \u043e\u0442 4, \u0412\u044a\u0432\u0435\u0434\u0435\u043d \u0432 \u0435\u043a\u0441\u043f\u043b\u043e\u0430\u0442\u0430\u0446\u0438\u044f 2025 \u0433., \u0412\u042a\u0417\u041c\u041e\u0416\u041d\u041e\u0421\u0422 \u0417\u0410 \u041f\u041e\u041a\u0423\u041f\u041a\u0410 \u041d\u0410 \u041f\u041e\u0414\u0417\u0415\u041c\u041d\u041e \u041f\u0410\u0420\u041a\u041e\u041c\u042f\u0421\u0422\u041e. \u041f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u044f\u043c\u0435 \u0432\u0438 \u043d\u0430\u043f\u044a\u043b\u043d\u043e \u0440\u0435\u043c\u043e\u043d\u0442\u0438\u0440\u0430\u043d \u0438 \u043e\u0431\u0437\u0430\u0432\u0435\u0434\u0435\u043d \u0435\u0434\u043d\u043e\u043f\u0440\u043e ...",
                "area_sqm": 44,
                "location": "\u0433\u0440\u0430\u0434 \u0421\u043e\u0444\u0438\u044f, \u041a\u0440\u044a\u0441\u0442\u043e\u0432\u0430 \u0432\u0430\u0434\u0430",
                "deal_type": "sale",
                "promotion": [
                    "VIP"
                ],
                "price_text": "137 899 \u20ac",
                "year_built": 2025,
                "photo_count": 11,
                "property_type": "1-\u0421\u0422\u0410\u0415\u041d",
                "is_private_seller": false
            }
        ],
        "agency": {
            "id": "ajaximoti",
            "url": "https://ajaximoti.imot.bg",
            "logo": "https://www.imot.bg/images/logos/big/ajaximoti.pic",
            "name": "\u0410\u042f\u041a\u0421 \u041d\u0415\u0414\u0412\u0418\u0416\u0418\u041c\u0418 \u0418\u041c\u041e\u0422\u0418",
            "phone": "0882763390",
            "address": "\u043e\u0431\u043b\u0430\u0441\u0442 \u0421\u043e\u0444\u0438\u044f, \u0433\u0440. \u0421\u043e\u0444\u0438\u044f, \u0443\u043b\u0438\u0446\u0430 \u0411\u043e\u0440\u043e\u0432\u043e 52 ,\u0432\u0445.\u0413",
            "member_since": 2022
        },
        "pagination": {
            "page": 1,
            "has_next": true,
            "per_page": 40,
            "result_cap": 1000,
            "total_pages": 4,
            "filtered_out": 0,
            "total_results": null,
            "total_results_is_lower_bound": false
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agency"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a range is invalid. This response is not billable. |
| 404 | Not Found | The agency was not found. This response is not billable. |
| 503 | Upstream Unavailable | imot.bg could not be reached or returned data that does not match the request. This response is not billable and is retryable. |

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