OLX

OLX Ad Details API

One OLX ad by id or link on any of the seven OLX Europe sites: title, the full description as plain text, price (with the site's conversion where it converts), salary for job ads, condition, every parameter, category with breadcrumb, all photos, location (city, district, region with ids), created_at, refreshed_at, valid_to, status, promoted and OLX delivery flags, and the seller (id, business or private, business name for business sellers only, member since). An ad that does not exist and an ad that has ended answer the same 404. Costs 1 credit per request.

POST/api/v1/olx/offer

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

offer_idstring | integer

An OLX ad id: items[].id of a search, e.g. 1107557408. Send offer_id or url, not both.

Example: 1107557408

urlstring

An OLX ad link on any of the seven sites. The market follows the link; a link on one site with a different country is a 400.

Example: https://www.olx.pl/d/oferta/iphone-13-pro-128gb-graphite-pudelko-etui-szybki-ochronne-100-sprawny-CID99-ID1cXcha.html

countryenum<string>default:pl

The OLX site. Titles, parameters and labels come back in the site's language (Polish on pl; Russian by default on kz and uz), prices in its currency. When you send a url, the market follows the url.

Example: pl

pl — olx.pl, PLN, Polish. The default.
ro — olx.ro, RON, Romanian.
pt — olx.pt, EUR, Portuguese.
bg — olx.bg, EUR, Bulgarian.
ua — olx.ua, UAH, Ukrainian.
kz — olx.kz, KZT, Russian by default, Kazakh with language kk.
uz — olx.uz, UZS, Russian by default, Uzbek with language uz.

languageenum<string>

kz and uz only. olx.kz and olx.uz answer in Russian by default; kk returns Kazakh on kz and uz returns Uzbek (Latin) on uz. A 400 on the other five sites, which answer in their own language.

Example: kk

ru — Russian, the default on kz and uz.
kk — Kazakh, kz only.
uz — Uzbek, uz only.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

ad = client.olx.offer(offer_id=1107557408)["data"]
print(ad["title"], ad["price"]["value"], ad["price"]["currency"], ad["status"])
for p in ad["params"]:
    print(p["name"], "=", p["value"])
print("seller", ad["seller"]["id"], "business:", ad["seller"]["is_business"], "since", ad["seller"]["member_since"])

Response

"id": 1107557408,

"url": "https://www.olx.pl/d/oferta/iphone-13-pro-128gb-graphite-pudelko-etui-szybki-ochronne-100-sprawny-CID99-ID1cXcha.html",

"title": "iPhone 13 Pro 128GB Graphite | Pudełko + Etui + Szybki ochronne | 100% Sprawny",

"description": "TYLKO ODBIÓR OSOBISTY Cześć! Mam na sprzedaż flagowy smartphone iPhone 13 Pro w wersji 128 GB i klasycznym, eleganckim kolorze Graphite (Grafitowy). Telefon jest w 100% sprawny technicznie. Aparaty (w tym obiektyw tele 3x i tryb makro), płynny ekran ProMotion 120 Hz, Face ID, głośniki oraz płatności Apple Pay działają idealnie, jak w nowym urządzeniu. Sprzęt został w pełni przygotowany dla nowego właściciela – wylogowany z konta iCloud / Find My iPhone i wyzerowany do ustawień fabrycznych. Stan techniczny i wizualny: Model: iPhone 13 Pro (128 GB) – kolor Graphite. Stan wizualny: Bardzo dobry, dbano o niego od nowości. Bateria: 80% kondycji – oryginalne ogniwo Apple, spokojnie wytrzymuje cały dzień normalnego użytkowania. Stan techniczny: 100% sprawny, bez żadnych ukrytych wad. W bogatym zestawie znajduje się: 1. Smartfon iPhone 13 Pro 128 GB Graphite 2. Oryginalne pudełko ze zgodnym numerem IMEI 3. 2x Etui / pokrowiec ochronny 4. Zestaw dodatkowych szybek ochronnych na ekran (gratis)",

"salary": null,

"condition": "used",

"created_at": "2026-10-25T13:39:23.000Z",

"refreshed_at": "2026-10-25T13:41:50.000Z",

"valid_to": "2026-11-24T13:39:24.000Z",

"status": "active",

"is_active": true,

"is_business": false,

"is_promoted": true,

"is_highlighted": true,

"olx_delivery": false,

"is_job": false,

"country": "pl",

"language": "pl",

"currency": "PLN"

"response_time": 24061

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") ad = client.olx.offer(offer_id=1107557408)["data"] print(ad["title"], ad["price"]["value"], ad["price"]["currency"], ad["status"]) for p in ad["params"]: print(p["name"], "=", p["value"]) print("seller", ad["seller"]["id"], "business:", ad["seller"]["is_business"], "since", ad["seller"]["member_since"])