# OLX Ad ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/olx/ad` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/olx-ad | ## Description Read one OLX ad from its id or URL. You get the asking price, the city, and the seller name. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/olx/ad' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### iPhone 17 Pro on olx.pl ```json { "id": 1042971205, "url": "https://www.olx.pl/d/oferta/apple-iphone-17-pro-256-gb-nowy-szczecin-zaplombowany-karta-sim-ul-baluki-4-szczecin-CID99-ID18Acsd.html", "image": "https://ireland.apollo.olxcdn.com:443/v1/files/u7efs2w88qtt-PL/image;s=3024x4032", "price": 4999, "title": "Apple iPhone 17 Pro 256 Gb NOWY Szczecin Zaplombowany Karta sim | ul. Bałuki 4 Szczecin", "images": [ "https://ireland.apollo.olxcdn.com:443/v1/files/u7efs2w88qtt-PL/image;s=3024x4032", "https://ireland.apollo.olxcdn.com:443/v1/files/dcr4lxvv6iy5-PL/image;s=1254x1254", "https://ireland.apollo.olxcdn.com:443/v1/files/35p9glqk148p3-PL/image;s=1086x1448" ], "region": "pl", "status": "active", "currency": "PLN", "latitude": 53.43138, "location": { "city": "Szczecin", "region": "Zachodniopomorskie", "district": "Centrum" }, "condition": "Nowe", "longitude": 14.54948, "seller_id": 25081589, "created_at": "2025-12-06T18:02:46+01:00", "negotiable": false, "parameters": [ { "name": "Stan", "value": "Nowe" }, { "name": "Model telefonu", "value": "iPhone 17 Pro" }, { "name": "Wbudowana pamięć", "value": "256GB" }, { "name": "Opcje SIM", "value": "Dual SIM (SIM + eSIM)" }, { "name": "Funkcje", "value": "Always on display, Rozpoznawanie twarzy, Szybkie ładowanie, Hot-Spot, Płatność NFC, Ładowanie indukcyjne" } ], "breadcrumbs": [ { "url": "https://www.olx.pl/", "name": "Strona główna" }, { "url": "https://www.olx.pl/elektronika/", "name": "Elektronika" }, { "url": "https://www.olx.pl/elektronika/telefony/", "name": "Telefony" }, { "url": "https://www.olx.pl/elektronika/telefony/smartfony-telefony-komorkowe/", "name": "Smartfony i telefony komórkowe" }, { "url": "https://www.olx.pl/elektronika/telefony/smartfony-telefony-komorkowe/iphone/", "name": "iPhone" }, { "url": "https://www.olx.pl/elektronika/telefony/smartfony-telefony-komorkowe/iphone/zachodniopomorskie/", "name": "iPhone - Zachodniopomorskie" }, { "url": "https://www.olx.pl/elektronika/telefony/smartfony-telefony-komorkowe/iphone/szczecin/", "name": "iPhone - Szczecin" }, { "url": "https://www.olx.pl/elektronika/telefony/smartfony-telefony-komorkowe/iphone/szczecin/?search%5Bdistrict_id%5D=731", "name": "iPhone - Centrum" } ], "description": "Apple iPhone 17 Pro 256 GB – , oryginalny produkt Apple Prezentowany telefon to w 100% oryginalny produkt firmy Apple. Urządzenie jest nowe – nieużywane, nieodnawiane, nienaprawiane i nieprzepakowywane. Wersja z dystrybucji europejskiej ze standardowym wejściem na KARTE SIM. Nie Obciążony ratami Najważniejsze informacje: Model: Apple iPhone 17 Pro Pojemność: 256 GB Kolor: zapytaj o dostępność Stan: nowy Gwarancja producenta 12 miesięcy Fabrycznie bez simlocka – działa z każdą siecią Polskie menu Brak blokad ratalnych i innych ograniczeń Szkło hartowane GRATIS Możliwość zabezpieczenia telefonu folią ochronną lub szkłem hartowanym na miejscu Zapłać mniej i zostaw swój stary telefon w rozliczeniu. Na telefony używane oferujemy 3 miesiące gwarancji. Na nowe iPhone – 12 miesięcy gwarancji, a na nowe urządzenia innych marek – aż 24 miesiące gwarancji. Zestaw zawiera: iPhone 17 Pro 256 GB Oryginalny kabel do ładowania Fabryczne pudełko (zgodne z numerem IMEI urządzenia) Dodatkowe informacje: Urządzenie nie było naprawiane ani aktywowane Pochodzi z oficjalnej dystrybucji Apple Możliwość odbioru osobistego w Szczecinie Przy zakupie wystawiamy potwierdzenie sprzedaży Dane kontaktowe i odbiór: GALAXY GSM PREMIUM ul. Edmunda Bałuki 4 70-464 Szczecin Godziny otwarcia: Poniedziałek – Piątek: 9:00 – 19:00 Sobota: 10:00 – 16:00", "is_business": true, "is_promoted": true, "seller_name": "Alex Martin", "refreshed_at": "2026-10-14T22:54:22+02:00", "price_display": "4 999 zł" } ``` ## Documentation ## Overview OLX Ad returns one classified listing as a flat object. Send the listing URL. ## Regions | `region` | Site | Search path | Usual currency | | --- | --- | --- | --- | | `pl` (default) | olx.pl | /oferty/ | PLN | | `ro` | olx.ro | /oferte/ | RON | | `pt` | olx.pt | /ads/ | EUR | | `bg` | olx.bg | /ads/ | EUR | | `ua` | olx.ua | /list/ | UAH | | `kz` | olx.kz | /list/ | KZT | | `uz` | olx.uz | /list/ | UZS | The listing URL host selects the region. ## Quickstart ``` GET https://api.piloterr.com/v2/olx/ad?query=https://www.olx.pl/d/oferta/apple-iphone-17-pro-256-gb-nowy-szczecin-zaplombowany-karta-sim-ul-baluki-4-szczecin-CID99-ID18Acsd.html ``` Placeholders: `query` such as the listing URL above, `region` such as `pl`. ## Parameters | Parameter | Type | Required | Placeholder | Description | | --- | --- | --- | --- | --- | | query | string | yes | listing URL | Listing URL | | region | string | no | `pl` | Ignored when `query` is a full URL | | return_page_source | boolean | no | `false` | Raw HTML | ## Response fields The object has id, title, url, price, price_display, currency, location, region, description, images, seller_name, and parameters. `price`, `currency`, `location`, and `region` stay on the object. ## Main use cases - Open the phone or car behind a search card - Store the local currency amount - Keep the location and the seller ## Error codes 400 invalid URL. 403 block page. 404 no parsable ad. 500 fetch failure.