# Halo Oglasi Agency API Documentation

<p><strong>Halo Oglasi Agency API</strong> returns the public profile of an advertiser: name, description, address, city, register number, logo, the <code>advertiser_id</code> and the total number of ads, plus the first page of ads in the search item shape. Pass the <code>route</code> from the listing field <code>advertiser.profile_route</code>, such as <code>oglasi/real-house</code>. Use the agency-ads route with the <code>advertiser_id</code> for more pages and filters.</p><p>Phone numbers are not returned. A field the profile page does not show stays <code>null</code>. An unknown profile returns a 404 error. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/halooglasi-api/halooglasi_agency](https://scrappa.co/docs/halooglasi-api/halooglasi_agency)
- **API group:** Halo Oglasi API
- **Endpoint:** `GET https://scrappa.co/api/halooglasi/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 |
| --- | --- | --- | --- |
| `route` | string | Yes | Profile route from a listing (advertiser.profile_route) or the full halooglasi.com profile URL. |

## Example response

```json
{
    "data": {
        "ads": {
            "items": [
                {
                    "id": "5425647877013",
                    "url": "https://www.halooglasi.com/nekretnine/izdavanje-stanova/dvosoban-na-novoj-detelinari/5425647877013",
                    "path": "/nekretnine/izdavanje-stanova/dvosoban-na-novoj-detelinari/5425647877013",
                    "floor": 5,
                    "price": {
                        "amount": 500,
                        "currency": "EUR"
                    },
                    "rooms": 2,
                    "title": "Dvosoban na Novoj Detelinari",
                    "area_m2": 50,
                    "location": {
                        "area": "Op\u0161tina Novi Sad",
                        "city": "Novi Sad",
                        "places": [
                            "Novi Sad",
                            "Op\u0161tina Novi Sad",
                            "Nova Detelinara",
                            "Janka \u010cmelika"
                        ],
                        "street": "Janka \u010cmelika",
                        "micro_location": "Nova Detelinara"
                    },
                    "thumbnail": "https://img.halooglasi.com/slike/oglasi/Thumbs/261025/m/dvosoban-na-novoj-detelinari-5425647877013-71817436536.jpg",
                    "floor_label": "V",
                    "image_count": 20,
                    "price_per_m2": null,
                    "published_at": "2026-10-25",
                    "total_floors": 5,
                    "advertiser_type": "agency",
                    "has_map_position": true,
                    "short_description": "Dupleks stan za izdavanje od 50 m2 u ulici Janka \u010cmelika u Novom Sadu, na petom spratu zgrade sa liftom, deluje kao stan \u201cna sprat i po\u201d, taman..."
                }
            ],
            "pagination": {
                "page": 1,
                "per_page": 20,
                "total_count": 46,
                "total_pages": 3,
                "filtered_out": 0,
                "has_next_page": true,
                "duplicates_removed": 0
            }
        },
        "url": "https://www.halooglasi.com/oglasi/real-house",
        "city": "Novi Sad",
        "logo": "https://img.halooglasi.com/slike/logoi/84254083-d0d7-425c-aa1e-660d5be4a579.jpg",
        "name": "Real House",
        "route": "oglasi/real-house",
        "address": "Kosan\u010di\u0107 Ivana 8",
        "description": "Real House doo je porodi\u010dna firma \u010diji su osniva\u010di i suvlasnici Sanja i Vladimir Rafajlovi\u0107, bavimo se poslovima sa nekretninama u Novom Sadu i \u0161iroj okolini, l...",
        "total_count": 46,
        "advertiser_id": "20668",
        "register_number": "177"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agency"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter, a range or a combination is invalid. This response is not billable. |
| 404 | Not Found | The listing or profile no longer exists. This response is not billable. |
| 503 | Upstream Unavailable | Halo Oglasi 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)