Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the OLX Pakistan API page →

docs / olx-pk

OLX Pakistan

Pakistan's biggest classifieds site: cars, phones, property and bikes, with prices in PKR.

base /olx-pk/v15 endpoints

post/olx-pk/v1/search1 credit

Search live OLX Pakistan listings by keyword, category, city or area, price range in PKR and sort. Cars and bikes add make, model, year, kilometres, fuel, transmission and assembly; any category filter (body type, colour, PTA approval, bedrooms …) goes in `filters`. Each row: listing id, title, price, location down to the area, dates, attributes, seller name and verification, cover image and the listing URL, with the true total.

Parameter		Allowed / range	Description
query	optional	—	Keywords, matched like the site's search box (all words must appear).
category	optional	—	Category from `categories`: its external_id (84 = Cars, 1453 = Mobile Phones, 5 = Vehicles), the site's URL form (cars_c84), a unique slug (cars) or a slug path (vehicles/spare-parts). A parent category includes all its children.
location	optional	—	Province, city or area: a name (Lahore, Karachi, `DHA Defence, Karachi`), a location_id from `locations` (4060695 = Karachi) or the site's slug (karachi_g4060695). The resolved place is echoed in filters_applied.location.
price_min	optional	0–	Lowest price, PKR.
price_max	optional	0–	Highest price, PKR.
make	optional	—	Brand by name (Toyota, Honda, Suzuki, Apple, Samsung) or the site's code; needs category. Choices: category_fields.
model	optional	—	Model by name (Corolla GLI, Civic, 15 Pro Max) or code; needs make.
year_min	optional	1900–2100	Earliest model year.
year_max	optional	1900–2100	Latest model year.
km_min	optional	0–	Fewest kilometres driven.
km_max	optional	0–	Most kilometres driven.
fuel	optional	petrol · diesel · lpg · cng · hybrid · electric · reev · phev	Fuel (cars).
transmission	optional	automatic · manual	Gearbox (cars).
assembly	optional	local · imported	Locally assembled or imported (cars).
condition	optional	new · used	New or used, as the seller declared it.
filters	optional	—	Any other filter of the category, by the category's own vocabulary (category_fields lists them): {attribute: value}. A value is the published label or the site's code; a list means any of them; ranges take {min, max} or <attribute>_min / <attribute>_max. Needs category.
sort	optional	relevance · newest · oldest · price_asc · price_desc	Order. relevance (default with a query), newest (default without), oldest, price_asc, price_desc.
page = 1	optional	1–10000	Page, from 1.
limit = 25	optional	1–100	Rows per page (1-100). page × limit stops at 10 000, the site's own limit.
max_rotations = 3	optional	1–5	Attempts on a fresh datacentre exit when the search service stumbles (1-5).

Try in playground →

post/olx-pk/v1/listing1 credit

One OLX Pakistan listing in full by its id or URL: title, price in PKR, the whole description, every attribute (make, model, year, km, fuel, PTA status …), all images, location down to the area with coordinates, posting and refresh dates, and a seller summary (name, member since, verified, phone when the seller made it visible, active listings).

Parameter		Allowed / range	Description
listing_id	optional	—	The number after iid- in the listing URL (search rows carry it).
url	optional	—	An olx.com.pk listing URL.
include_seller = true	optional	—	Add the seller's profile (member since, visible phone; one extra request) and active listing count. false = only what the listing carries.
max_rotations = 3	optional	1–5	Attempts on a fresh datacentre exit when the search service stumbles (1-5).

Try in playground →

post/olx-pk/v1/categories1 credit

The OLX Pakistan category tree with live listing counts: Mobiles, Vehicles (cars, motorcycles, spare parts …), Property for sale and rent, Electronics, Bikes, Jobs, Animals, Furniture, Fashion and more, down to sub-category. Each node carries the external_id to pass as category to search.

Parameter		Allowed / range	Description
category	optional	—	Optional: only this category's subtree (external_id, slug or slug path).
depth	optional	0–5	Levels of children to include (default: all).

Try in playground →

post/olx-pk/v1/category_fields1 credit

The filters a category offers on OLX Pakistan, with every published choice: for Cars make (64 brands), model per make, year, kilometres, fuel, transmission, body type, colour, registration city, assembly …; for Mobile Phones brand, model, PTA approval, condition. Pass make to get its models.

Parameter		Allowed / range	Description
category	required	—	Category external_id or slug (84 = Cars, 1453 = Mobile Phones).
make	optional	—	A make (name or code) to list its models.

Try in playground →

post/olx-pk/v1/locations1 credit

OLX Pakistan places and their ids: provinces, the 231 cities, their areas and sub-areas, with live listing counts and coordinates. List a place's children, or find a place by name.

Parameter		Allowed / range	Description
parent	optional	—	List the places inside this one (a name or location_id). Without parent and query: the provinces.
query	optional	—	Find places by name (inside parent when given).
level	optional	province · city · area · sub_area	Only places of this level (e.g. city with no parent = all 231 cities).
limit = 100	optional	1–500	Most places returned (1-500), busiest first.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/olx-pk/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"Toyota Corolla","category":"84","limit":5}'

Response shape

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

Built for volume

5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?

We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support

2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance

Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.