crawlbaseDocs
Log in

OLX SERP

Turn an OLX search or category results page into a structured array of ads with pagination metadata. Pass scraper=olx-serp to the Crawling API with any OLX listing URL.

Usage

Send the OLX search or category URL to the Crawling API with the scraper=olx-serp parameter. The scraper covers OLX's shared frontend, so the same scraper name works across markets - only the domain in the request URL changes.

curl 'https://api.crawlbase.com/?token=YOUR_TOKEN' \
  --data-urlencode 'url=https://www.olx.pl/motoryzacja/samochody/' \
  --data-urlencode 'scraper=olx-serp' -G
from crawlbase import CrawlingAPI

api = CrawlingAPI({'token': 'YOUR_TOKEN'})
res = api.get(
    'https://www.olx.pl/motoryzacja/samochody/',
    {'scraper': 'olx-serp'}
)

import json
data = json.loads(res['body'])
const { CrawlingAPI } = require('crawlbase');
const api = new CrawlingAPI({ token: 'YOUR_TOKEN' });

const res = await api.get(
  'https://www.olx.pl/motoryzacja/samochody/',
  { scraper: 'olx-serp' }
);
const data = JSON.parse(res.body);
require 'crawlbase'
api = Crawlbase::API.new(token: 'YOUR_TOKEN')

res = api.get('https://www.olx.pl/motoryzacja/samochody/', scraper: 'olx-serp')
data = JSON.parse(res.body)

Example input URL

Any OLX search, category, or query results URL. A few examples across OLX markets:

https://www.olx.pl/motoryzacja/samochody/
https://www.olx.pl/nieruchomosci/mieszkania/wynajem/
https://www.olx.pl/oferty/q-iphone-15/
https://www.olx.ua/uk/list/
https://www.olx.pt/imoveis/
https://www.olx.ro/auto-masini-moto-ambarcatiuni/

The olx-serp scraper works on the shared OLX frontend across olx.pl, olx.ua, olx.pt, olx.ro, olx.bg, olx.kz, and olx.uz - only the TLD in the request URL changes. OLX rate-limits datacenter IPs, but you don't pick a proxy pool yourself - the Crawling API routes through its residential network by default and auto-selects the best exit per request. Pass country= (e.g. country=PL for olx.pl) only when you need a specific market's geo.

Response

The scraper returns a JSON object describing the results page and an items array of ads.

url
string
The results page URL that was scraped.
categoryId
integer | null
OLX category id for the results page, when present.
page
integer | null
Zero-based index of the current results page.
totalPages
integer | null
Total number of results pages available for this query.
totalCount
integer | null
Total number of ads matching the query across all pages.
itemCount
integer
Number of ads returned on this page (length of items).
items
array
Array of ads on the current results page.
items[].id
integer | null
OLX ad id.
items[].title
string | null
Ad title.
items[].url
string | null
Canonical URL of the individual ad page.
items[].price
object
Price object for the ad.
items[].price.value
number | null
Numeric price value.
items[].price.currency
string | null
ISO currency code (e.g. PLN, UAH, EUR).
items[].price.currencySymbol
string | null
Display currency symbol (e.g. zł).
items[].price.displayValue
string | null
Human-readable formatted price as shown on OLX.
items[].price.negotiable
boolean
Whether the seller marked the price as negotiable.
items[].price.free
boolean
Whether the ad is listed as free.
items[].price.exchange
boolean
Whether the seller is open to an exchange instead of cash.
items[].location
object
Location object for the ad.
items[].location.city
string | null
City name.
items[].location.region
string | null
Region, voivodeship, or oblast name.
items[].location.district
string | null
District or neighborhood, when present.
items[].location.path
string | null
Human-readable location path (region, city, district).
items[].location.latitude
number | null
Approximate latitude.
items[].location.longitude
number | null
Approximate longitude.
items[].category
object
Category object for the ad.
items[].category.id
integer | null
OLX category id for the ad.
items[].category.type
string | null
Category type slug (e.g. automotive).
items[].createdTime
string | null
ISO 8601 timestamp of when the ad was posted.
items[].isPromoted
boolean
Whether the ad is a paid/promoted listing.
items[].isHighlighted
boolean
Whether the ad is visually highlighted in results.
items[].isBusiness
boolean
Whether the ad was posted by a business account.
items[].thumbnailUrl
string | null
URL of the ad's thumbnail image.

Sample response

{
  "url": "https://www.olx.pl/motoryzacja/samochody/",
  "categoryId": 4,
  "page": 0,
  "totalPages": 25,
  "totalCount": 1000,
  "itemCount": 2,
  "items": [
    {
      "id": 915581849,
      "title": "BMW 320d F30 2016 xDrive - pełen serwis",
      "url": "https://www.olx.pl/d/oferta/bmw-320d-f30-2016-xdrive-IDABC12.html",
      "price": {
        "value": 45900,
        "currency": "PLN",
        "currencySymbol": "zł",
        "displayValue": "45 900 zł",
        "negotiable": true,
        "free": false,
        "exchange": false
      },
      "location": {
        "city": "Warszawa",
        "region": "Mazowieckie",
        "district": "Mokotów",
        "path": "Mazowieckie, Warszawa, Mokotów",
        "latitude": 52.2297,
        "longitude": 21.0122
      },
      "category": {
        "id": 4,
        "type": "automotive"
      },
      "createdTime": "2026-07-18T10:24:55+02:00",
      "isPromoted": true,
      "isHighlighted": false,
      "isBusiness": true,
      "thumbnailUrl": "https://ireland.apollo.olxcdn.com:443/v1/files/765inat2qu8k1-PL/image;s=1024x768"
    },
    {
      "id": 927067590,
      "title": "Audi A4 B9 2.0 TDI 2017 - bezwypadkowy",
      "url": "https://www.olx.pl/d/oferta/audi-a4-b9-20-tdi-2017-IDDEF34.html",
      "price": {
        "value": 62000,
        "currency": "PLN",
        "currencySymbol": "zł",
        "displayValue": "62 000 zł",
        "negotiable": false,
        "free": false,
        "exchange": false
      },
      "location": {
        "city": "Kraków",
        "region": "Małopolskie",
        "district": null,
        "path": "Małopolskie, Kraków",
        "latitude": 50.0647,
        "longitude": 19.945
      },
      "category": {
        "id": 4,
        "type": "automotive"
      },
      "createdTime": "2026-07-16T09:12:41+02:00",
      "isPromoted": false,
      "isHighlighted": false,
      "isBusiness": false,
      "thumbnailUrl": "https://ireland.apollo.olxcdn.com:443/v1/files/c0riwdwc88q11-PL/image;s=1024x768"
    }
  ]
}