docs / olx

OLX API

base /olx/v18 endpoints

post/olx/v1/search1 credit

Keyword or category search with sort, location, price filters, offset pagination (limit=40).

Parameter		Allowed / range	Description
query	optional	—	Free-text keyword search. (search needs query OR category_id.)
category_id	optional	—	OLX numeric category id (discover via the categories / breadcrumbs actions). (search needs query OR category_id.)
country = pl	optional	pl · ua · bg · ro · pt · kz · uz	OLX country edition — each TLD is a fully separate marketplace. br/in/tr run on different stacks and are not supported.
sort_by	optional	relevance · created_at:desc · filter_float_price:asc · filter_float_price:desc	Result ordering. Common keys shown; other OLX sort keys are also accepted.
region_id	optional	—	Location filter: OLX numeric region id (discover via the filters action).
city_id	optional	—	Location filter: OLX numeric city id (discover via the filters action).
district_id	optional	—	Location filter: OLX numeric district id (discover via the filters action).
price_from	optional	—	Minimum price filter (in the marketplace's local currency).
price_to	optional	—	Maximum price filter (in the marketplace's local currency).
filters	optional	—	Advanced: extra raw OLX filter params as a key->value map (e.g. {"filter_enum_state": "used"}); keys come from the filters action.
offset = 0	optional	0–	Pagination offset (skip N results). Page forward with meta.next_offset.
limit = 40	optional	1–50	Results per page (1-50, default 40). Larger values are clamped to 50.

Try in playground →

post/olx/v1/offer1 credit

Offer detail by numeric id (no trailing slash on upstream path).

Parameter		Allowed / range	Description
id	required	—	OLX offer numeric id (the digits in an offer URL / a search result's id).
country = pl	optional	pl · ua · bg · ro · pt · kz · uz	OLX country edition — each TLD is a fully separate marketplace. br/in/tr run on different stacks and are not supported.

Try in playground →

post/olx/v1/categories1 credit

Category facets + filter suggestions from search metadata, plus global filter definitions.

Parameter		Allowed / range	Description
query	optional	—	Free-text keyword search. (search needs query OR category_id.)
category_id	optional	—	OLX numeric category id (discover via the categories / breadcrumbs actions). (search needs query OR category_id.)
country = pl	optional	pl · ua · bg · ro · pt · kz · uz	OLX country edition — each TLD is a fully separate marketplace. br/in/tr run on different stacks and are not supported.

Try in playground →

post/olx/v1/user_offers1 credit

Active offers for a seller user_id with offset pagination.

Parameter		Allowed / range	Description
user_id	required	—	OLX seller numeric id (an offer's seller_id / search result user.id).
country = pl	optional	pl · ua · bg · ro · pt · kz · uz	OLX country edition — each TLD is a fully separate marketplace. br/in/tr run on different stacks and are not supported.
offset = 0	optional	0–	Pagination offset (skip N results). Page forward with meta.next_offset.
limit = 40	optional	1–50	Results per page (1-50, default 40). Larger values are clamped to 50.

Try in playground →

post/olx/v1/suggested1 credit

Related/suggested offers for a given offer id.

Parameter		Allowed / range	Description
id	required	—	OLX offer numeric id (the digits in an offer URL / a search result's id).
country = pl	optional	pl · ua · bg · ro · pt · kz · uz	OLX country edition — each TLD is a fully separate marketplace. br/in/tr run on different stacks and are not supported.

Try in playground →

post/olx/v1/breadcrumbs1 credit

Category or offer breadcrumb trail.

Parameter		Allowed / range	Description
category_id	optional	—	OLX numeric category id (discover via the categories / breadcrumbs actions). (search needs query OR category_id.)
id	optional	—	OLX offer numeric id (alternative to category_id for breadcrumbs).
country = pl	optional	pl · ua · bg · ro · pt · kz · uz	OLX country edition — each TLD is a fully separate marketplace. br/in/tr run on different stacks and are not supported.

Try in playground →

post/olx/v1/user1 credit

Public seller profile by user id.

Parameter		Allowed / range	Description
user_id	required	—	OLX seller numeric id (an offer's seller_id / search result user.id).
country = pl	optional	pl · ua · bg · ro · pt · kz · uz	OLX country edition — each TLD is a fully separate marketplace. br/in/tr run on different stacks and are not supported.

Try in playground →

post/olx/v1/filters1 credit

Global filter attribute definitions keyed by filter_enum/filter_float names.

Parameter		Allowed / range	Description
country = pl	optional	pl · ua · bg · ro · pt · kz · uz	OLX country edition — each TLD is a fully separate marketplace. br/in/tr run on different stacks and are not supported.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/olx/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"iphone","country":"pl"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}