OLX SERP · Crawlbase Dokumentation

Nutzung

Senden Sie die OLX-Such- oder Kategorie-URL mit dem Parameter scraper=olx-serp an die Crawling API. Der Scraper deckt das gemeinsame Frontend von OLX ab, sodass derselbe Scraper-Name über alle Märkte hinweg funktioniert - nur die Domain in der Request-URL ändert sich.

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)

Beispiel-Eingabe-URL

Jede OLX-Such-, Kategorie- oder Abfrage-Ergebnisseite. Einige Beispiele über OLX-Märkte hinweg:

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/

Der olx-serp-Scraper funktioniert auf dem gemeinsamen OLX-Frontend über olx.pl, olx.ua, olx.pt, olx.ro, olx.bg, olx.kz und olx.uz - nur die TLD in der Request-URL ändert sich. OLX drosselt Rechenzentrums-IPs, aber Sie wählen den Proxy-Pool nicht selbst - die Crawling API routet standardmäßig über ihr Residential-Netzwerk und wählt den besten Exit-Node pro Request automatisch. Übergeben Sie country= (z. B. country=PL für olx.pl) nur, wenn Sie die Geolokalisierung eines bestimmten Marktes benötigen.

Response

Der Scraper gibt ein JSON-Objekt zurück, das die Ergebnisseite und ein items-Array von Anzeigen beschreibt.

url

string

Die gescrapte Ergebnisseiten-URL.

categoryId

integer | null

OLX-Kategorie-ID der Ergebnisseite, sofern vorhanden.

page

integer | null

Nullbasierter Index der aktuellen Ergebnisseite.

totalPages

integer | null

Gesamtzahl der für diese Abfrage verfügbaren Ergebnisseiten.

totalCount

integer | null

Gesamtzahl der Anzeigen, die der Abfrage über alle Seiten hinweg entsprechen.

itemCount

integer

Anzahl der auf dieser Seite zurückgegebenen Anzeigen (Länge von items).

items

array

Array der Anzeigen auf der aktuellen Ergebnisseite.

items[].id

integer | null

OLX-Anzeigen-ID.

items[].title

string | null

Anzeigentitel.

items[].url

string | null

Kanonische URL der einzelnen Anzeigenseite.

items[].price

object

Preis-Objekt der Anzeige.

items[].price.value

number | null

Numerischer Preiswert.

items[].price.currency

string | null

ISO-Währungscode (z. B. PLN, UAH, EUR).

items[].price.currencySymbol

string | null

Anzeige-Währungssymbol (z. B. zł).

items[].price.displayValue

string | null

Menschenlesbarer, formatierter Preis wie auf OLX angezeigt.

items[].price.negotiable

boolean

Ob der Verkäufer den Preis als verhandelbar markiert hat.

items[].price.free

boolean

Ob die Anzeige als kostenlos gelistet ist.

items[].price.exchange

boolean

Ob der Verkäufer zu einem Tausch statt Barzahlung bereit ist.

items[].location

object

Standort-Objekt der Anzeige.

items[].location.city

string | null

Stadtname.

items[].location.region

string | null

Name der Region, Woiwodschaft oder Oblast.

items[].location.district

string | null

Bezirk oder Stadtteil, sofern vorhanden.

items[].location.path

string | null

Menschenlesbarer Standortpfad (Region, Stadt, Bezirk).

items[].location.latitude

number | null

Ungefährer Breitengrad.

items[].location.longitude

number | null

Ungefährer Längengrad.

items[].category

object

Kategorie-Objekt der Anzeige.

items[].category.id

integer | null

OLX-Kategorie-ID der Anzeige.

items[].category.type

string | null

Kategorietyp-Slug (z. B. automotive).

items[].createdTime

string | null

ISO-8601-Zeitstempel der Anzeigenerstellung.

items[].isPromoted

boolean

Ob die Anzeige eine bezahlte/beworbene Anzeige ist.

items[].isHighlighted

boolean

Ob die Anzeige in den Ergebnissen visuell hervorgehoben ist.

items[].isBusiness

boolean

Ob die Anzeige von einem Geschäftskonto erstellt wurde.

items[].thumbnailUrl

string | null

URL des Vorschaubilds der Anzeige.

Beispiel-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"
    }
  ]
}