Skip to main content
POST
OLX offers search

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
domain
enum<string>
default:olx.pl

Marketplace. Options: olx.pl = olx.pl (Poland), olx.ua = olx.ua (Ukraine), olx.ro = olx.ro (Romania), olx.bg = olx.bg (Bulgaria), olx.pt = olx.pt (Portugal), olx.kz = olx.kz (Kazakhstan), olx.uz = olx.uz (Uzbekistan)

Available options:
olx.pl,
olx.ua,
olx.ro,
olx.bg,
olx.pt,
olx.kz,
olx.uz
keyword
string

Search term. e.g. iphone

max_items
integer
default:25

Max items (up to 500)

Required range: 1 <= x <= 500
start_page
integer

Starting page (50 offers per page, up to 20)

Required range: 1 <= x <= 20
sort
enum<string>

Sort by. Options: relevance = Relevance, newest = Newest, oldest = Oldest, price_asc = Price: low to high, price_desc = Price: high to low

Available options:
relevance,
newest,
oldest,
price_asc,
price_desc
condition
enum<string>

Condition. Options: new = New, almost-new = Almost new, used = Used, refurbished = Refurbished, outlet = Outlet, damaged = Damaged, others = Others

Available options:
new,
almost-new,
used,
refurbished,
outlet,
damaged,
others
owner_type
enum<string>

Seller type. Options: private = Private sellers, business = Business sellers

Available options:
private,
business
category_id
integer

Category ID

Required range: x >= 1
min_price
number

Min price (marketplace currency)

max_price
number

Max price (marketplace currency)

region_id
integer

Region ID

Required range: x >= 1
city_id
integer

City ID

Required range: x >= 1
district_id
integer

District ID

Required range: x >= 1
distance
integer

Distance (km around the city)

Required range: x >= 0
user_id
integer

Seller user ID

Required range: x >= 1
has_delivery
boolean

OLX delivery only

Response

Run completed.

session_id
string

Session identifier for this run.

kind
string

Data source identifier for this endpoint.

domain
string
max_items
integer
start_page
integer
partial
boolean

True when the scrape stopped early and returned the records collected so far.

human
string

Markdown summary of the result, for display.

machine
object

Structured result payload.

total_points
integer

Points charged for this run.