Skip to content
Gridlode
Launching soonTravel, real estate, classifieds1 credit / listing

OLX Listings Search API

Listings from an OLX search on olx.pl, olx.ro, olx.pt, olx.bg, olx.ua, olx.kz, olx.uz or olx.com.br, by keywords, category path, city (or Brazilian state) and price range, or from any OLX results URL you copy from the browser: title, price, currency, negotiable flag and previous price, city, district, region, approximate coordinates, posted, refreshed and expiry dates, category, condition, every attribute OLX shows (with vehicles normalised to mileage in km, year, fuel, transmission, power and engine size), photos, promoted flag and seller type, 40 listings per OLX page (50 on olx.com.br) and up to 400 per call. Read from the search the signed-out site itself loads. Phone numbers are never collected, private sellers' names are pseudonymised unless you ask for them, and VINs and licence plates are removed. Billed per listing returned; blocked or failed requests are free.

GEThttps://api.gridlode.com/v1/classifieds/olx
Get an API keyReference docs
This engine is built and is waiting for a terms review of the target site before we switch it on. Join early access through the contact form and we'll email you on launch day.

Parameters

NameTypeDescription
countrystringOLX site: pl (olx.pl), ro (olx.ro), pt (olx.pt), bg (olx.bg), ua (olx.ua), kz (olx.kz), uz (olx.uz) or br (olx.com.br). Ignored when url is given.
Default: "pl"
One of: pl, ro, pt, bg, ua, kz, uz, br
querystringKeywords, e.g. 'iphone 13' or 'bmw x5'.
Default: null
categorystringCategory path as it appears in the site's URLs, e.g. 'motoryzacja/samochody' (olx.pl), 'auto-masini-moto-ambarcatiuni/autoturisme' (olx.ro) or 'autos-e-pecas/carros-vans-e-utilitarios' (olx.com.br).
Default: null
category_idstringNumeric OLX category id (not for olx.com.br). Overrides category.
Default: null
citystringCity to search in, e.g. 'Warszawa', 'Cluj-Napoca', 'Kyiv' (not for olx.com.br).
Default: null
statestringolx.com.br only: two-letter state code, e.g. 'sp' or 'rj'.
Default: null
urlstringAn OLX results URL copied from the browser, e.g. https://www.olx.pl/motoryzacja/samochody/warszawa/q-bmw/. Overrides country, query, category and city.
Default: null
price_minstringMinimum price in the site's currency.
Default: null
price_maxstringMaximum price in the site's currency.
Default: null
sortstringResult order (olx.com.br supports relevance and newest).
Default: "relevance"
One of: relevance, newest, price_asc, price_desc
filtersobjectExtra OLX filters (not for olx.com.br) as the site's own filter_* names, e.g. {"filter_float_year:from": "2015", "filter_enum_petrol[0]": "diesel"}.
pageintegerResults page to start from (40 per page; olx.com.br 50).
Default: 1
limitintegerMaximum listings to return (1-400).
Default: 40
include_promotedbooleanKeep promoted (paid top) listings, flagged promoted=true.
Default: true
include_descriptionbooleanAdd each listing's description text (phone numbers and e-mail addresses removed).
Default: false
include_seller_namesbooleanReturn private sellers' display names. Off by default: private sellers appear as 'Seller 1', 'Seller 2', ... Business sellers' names are always returned.
Default: false
max_ageintegerAccept a cached answer up to this many seconds old, billed at 50%. Default 0 (always fresh).

Response fields

    Code

    curl "https://api.gridlode.com/v1/classifieds/olx?country=pl&query=iphone%2013&limit=40" \
  -H "Authorization: Bearer $GRIDLODE_KEY"
    1 credit per listing
    One credit is $0.001 on the smallest pack, from $0.0003 on enterprise plans.
    Half price for cached data
    Cached for up to 1 h. Pass max_age to use it.
    Failed requests are free
    Blocks, timeouts and target errors never cost credits.

    Market reference: OLX partner APIs are for listing your own ads only; no public search API.

    Questions

    How much does the OLX Listings Search API cost?

    1 credit per listing. One credit costs $0.001 on the smallest pack and as little as $0.0003 on enterprise plans. Cached answers cost half and failed calls are free.

    Travel, real estate, classifieds

    Related APIs in this category

    All 11 in Travel, real estate, classifieds · 0 live
    Soon

    Airbnb Stays Search

    Airbnb stays for a destination, dates and guest count, exactly as a signed-out visitor's search shows them

    2 credits / listingDocs
    Soon

    Zillow Listings Search

    Homes for sale, for rent or recently sold on Zillow for a city, ZIP code or neighbourhood, or for any Zillow search URL you copy from the browser…

    3 credits / listingDocs
    Soon

    Craigslist Listings Search

    Listings from any Craigslist city site by category and keyword (bikes in austin, cars and trucks in sfbay, apartments in london)

    1 credit / listingDocs
    Soon

    AutoScout24 Car Listings

    Car listings from an AutoScout24 search (autoscout24.com, .de, .it, .fr, .nl, .be, .at or .es) by make and model, or from any AutoScout24 results URL…

    2 credits / listingDocs
    Soon

    Google Flights Search

    Flight options from Google Flights for a route and date, as a signed-out visitor sees them

    2 credits / requestDocs