# OLX Poland Listing API Documentation

<p><strong>OLX Poland Listing API</strong> returns one public olx.pl ad: id, url, title, full description, ISO 8601 times, numeric PLN price with currency and label, parsed parameters, seller type, location names with ids and all photo urls. Seller names, phone numbers and contact data are never returned. An unknown or expired id answers 404 and is never charged.</p>

- **Documentation:** [https://scrappa.co/docs/olx-pl-api/olx_pl_listing](https://scrappa.co/docs/olx-pl-api/olx_pl_listing)
- **API group:** OLX Poland API
- **Endpoint:** `GET https://scrappa.co/api/olx-pl/listing`

## 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 |
| --- | --- | --- | --- |
| `id` | integer | Yes | Ad id from the search endpoint. Example: 1105127075. |

## Example response

```json
{
    "data": {
        "id": 1105127075,
        "url": "https://www.olx.pl/d/oferta/lekki-rower-rozmiar-m-CID767-ID1cN02f.html",
        "price": {
            "label": "500 z\u0142",
            "value": 500,
            "currency": "PLN"
        },
        "title": "Lekki rower rozmiar M",
        "params": [
            {
                "key": "state",
                "name": "Stan",
                "value": "U\u017cywane"
            },
            {
                "key": "gender",
                "name": "P\u0142e\u0107",
                "value": "Uniseks"
            },
            {
                "key": "equipment",
                "name": "Wyposa\u017cenie dodatkowe",
                "value": "Lusterko, Elementy odblaskowe, Licznik"
            },
            {
                "key": "brand",
                "name": "Marka",
                "value": "Giant"
            },
            {
                "key": "braketype",
                "name": "Typ hamulca",
                "value": "Tarczowe hydrauliczne"
            },
            {
                "key": "framematerial",
                "name": "Materia\u0142 ramy",
                "value": "Karbon"
            }
        ],
        "photos": [
            "https://ireland.apollo.olxcdn.com/v1/files/2pz255v2pf7a2-PL/image;s=800x600"
        ],
        "location": {
            "city": "Krosno",
            "region": "Podkarpackie",
            "city_id": 9359,
            "region_id": 17
        },
        "created_at": "2026-10-15T13:26:07Z",
        "category_id": 1650,
        "description": "U\u017cywany rower giant informacje pod nr tel 79*****47",
        "seller_type": "private",
        "valid_until": "2026-11-14T13:28:11Z",
        "refreshed_at": "2026-10-15T13:30:49Z"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | OLX has no such public resource, for example an unknown or expired ad id. Never charged. |
| 500 | Parser Drift | OLX answered with a response shape this parser does not recognise. Never charged. |
| 503 | Upstream Unavailable | The upstream service is temporarily unavailable. Please 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)