crawlbaseDocs
Anmelden

OLX Item

Verwandeln Sie eine einzelne OLX-Anzeigenseite in strukturiertes JSON mit der vollständigen Beschreibung, den Anzeigenparametern, Fotos, Standort und Verkäufer. Übergeben Sie scraper=olx-item an die Crawling API mit einer beliebigen OLX-Anzeigen-URL.

Nutzung

Senden Sie die einzelne OLX-Anzeigen-URL mit dem Parameter scraper=olx-item an die Crawling API. Anzeigenseiten liegen unter dem Pfad /d/. 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/d/oferta/bmw-320d-f30-2016-xdrive-IDABC12.html' \
  --data-urlencode 'scraper=olx-item' -G
from crawlbase import CrawlingAPI

api = CrawlingAPI({'token': 'YOUR_TOKEN'})
res = api.get(
    'https://www.olx.pl/d/oferta/bmw-320d-f30-2016-xdrive-IDABC12.html',
    {'scraper': 'olx-item'}
)

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/d/oferta/bmw-320d-f30-2016-xdrive-IDABC12.html',
  { scraper: 'olx-item' }
);
const data = JSON.parse(res.body);
require 'crawlbase'
api = Crawlbase::API.new(token: 'YOUR_TOKEN')

res = api.get('https://www.olx.pl/d/oferta/bmw-320d-f30-2016-xdrive-IDABC12.html', scraper: 'olx-item')
data = JSON.parse(res.body)

Beispiel-Eingabe-URL

Jede einzelne OLX-Anzeigen-URL (der /d/-Detailpfad). Einige Beispiele über OLX-Märkte hinweg:

https://www.olx.pl/d/oferta/bmw-320d-f30-2016-xdrive-IDABC12.html
https://www.olx.ua/d/uk/obyavlenie/planka-IDVDALa.html
https://www.olx.pt/d/anuncio/iphone-15-pro-IDXYZ99.html

Der olx-item-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 mit der vollständigen Anzeige zurück, einschließlich ihrer Parameter, Fotos, Standort und Verkäufer.

url
string
Die gescrapte Anzeigenseiten-URL.
id
integer | null
OLX-Anzeigen-ID.
title
string | null
Anzeigentitel.
description
string | null
Vollständiger Anzeigenbeschreibungstext, wie vom Verkäufer verfasst.
category
object
Kategorie-Objekt der Anzeige.
category.id
integer | null
OLX-Kategorie-ID.
category.type
string | null
Kategorietyp-Slug (z. B. automotive).
price
object
Preis-Objekt der Anzeige.
price.value
number | null
Numerischer Preiswert.
price.currency
string | null
ISO-Währungscode (z. B. PLN, UAH, EUR).
price.currencySymbol
string | null
Anzeige-Währungssymbol (z. B. zł).
price.displayValue
string | null
Menschenlesbarer, formatierter Preis wie auf OLX angezeigt.
price.negotiable
boolean
Ob der Verkäufer den Preis als verhandelbar markiert hat.
price.free
boolean
Ob die Anzeige als kostenlos gelistet ist.
price.exchange
boolean
Ob der Verkäufer zu einem Tausch statt Barzahlung bereit ist.
itemCondition
string | null
Artikelzustand, sofern angegeben (z. B. new, used).
params
array
Array anzeigenspezifischer Parameter (Marke, Baujahr, Kilometerstand, Größe usw.).
params[].key
string | null
Maschinenlesbarer Parameterschlüssel.
params[].name
string | null
Lokalisierte Parameterbezeichnung wie auf OLX angezeigt.
params[].value
string | null
Lokalisierter Parameterwert.
params[].normalizedValue
string | null
Normalisierter Wert, geeignet zum Filtern, sofern verfügbar.
location
object
Standort-Objekt der Anzeige.
location.city
string | null
Stadtname.
location.region
string | null
Name der Region, Woiwodschaft oder Oblast.
location.district
string | null
Bezirk oder Stadtteil, sofern vorhanden.
location.path
string | null
Menschenlesbarer Standortpfad (Region, Stadt, Bezirk).
location.latitude
number | null
Ungefährer Breitengrad.
location.longitude
number | null
Ungefährer Längengrad.
photos
array
Array von Fotos-URLs in voller Größe für die Anzeige.
seller
object
Verkäufer-Objekt der Anzeige.
seller.id
integer | null
OLX-Verkäufer-ID.
seller.name
string | null
Anzeigename des Verkäufers.
seller.type
string | null
Verkäufertyp (z. B. private, business).
seller.companyName
string | null
Eingetragener Firmenname für Geschäftsverkäufer.
seller.registeredAt
string | null
ISO-8601-Zeitstempel der Registrierung des Verkäufers bei OLX.
seller.lastSeenAt
string | null
ISO-8601-Zeitstempel der letzten Aktivität des Verkäufers.
contact
object
Kontaktoptionen-Objekt der Anzeige.
contact.name
string | null
In der Anzeige angezeigter Kontaktname.
contact.phoneAvailable
boolean
Ob eine Telefonnummer für diese Anzeige verfügbar ist.
contact.chatAvailable
boolean
Ob der OLX-Chat für diese Anzeige aktiviert ist.
contact.courier
boolean
Ob OLX-Kurier/Lieferung angeboten wird.
contact.negotiation
boolean
Ob der Verkäufer Preisverhandlungen akzeptiert.
createdTime
string | null
ISO-8601-Zeitstempel der Anzeigenerstellung.
lastRefreshTime
string | null
ISO-8601-Zeitstempel der letzten Auffrischung der Anzeige durch den Verkäufer.
validToTime
string | null
ISO-8601-Zeitstempel des Anzeigenablaufs.
status
string | null
Anzeigenstatus (z. B. active, removed).
isActive
boolean
Ob die Anzeige derzeit aktiv ist.
isBusiness
boolean
Ob die Anzeige von einem Geschäftskonto erstellt wurde.
isPromoted
boolean
Ob die Anzeige eine bezahlte/beworbene Anzeige ist.
isHighlighted
boolean
Ob die Anzeige visuell hervorgehoben ist.

Beispiel-Response

{
  "url": "https://www.olx.pl/d/oferta/bmw-320d-f30-2016-xdrive-IDABC12.html",
  "id": 915581849,
  "title": "BMW 320d F30 2016 xDrive - pełen serwis",
  "description": "Sprzedam BMW 320d F30, rok 2016, xDrive. Pełna historia serwisowa, bezwypadkowy, jeden właściciel.",
  "category": {
    "id": 4,
    "type": "automotive"
  },
  "price": {
    "value": 45900,
    "currency": "PLN",
    "currencySymbol": "zł",
    "displayValue": "45 900 zł",
    "negotiable": true,
    "free": false,
    "exchange": false
  },
  "itemCondition": "used",
  "params": [
    {
      "key": "make",
      "name": "Marka",
      "value": "BMW",
      "normalizedValue": "bmw"
    },
    {
      "key": "year",
      "name": "Rok produkcji",
      "value": "2016",
      "normalizedValue": "2016"
    },
    {
      "key": "mileage",
      "name": "Przebieg",
      "value": "142 000 km",
      "normalizedValue": "142000"
    }
  ],
  "location": {
    "city": "Warszawa",
    "region": "Mazowieckie",
    "district": "Mokotów",
    "path": "Mazowieckie, Warszawa, Mokotów",
    "latitude": 52.2297,
    "longitude": 21.0122
  },
  "photos": [
    "https://ireland.apollo.olxcdn.com:443/v1/files/765inat2qu8k1-PL/image;s=1024x768",
    "https://ireland.apollo.olxcdn.com:443/v1/files/a1b2c3d4e5f6-PL/image;s=1024x768"
  ],
  "seller": {
    "id": 8842013,
    "name": "Auto Komis Premium",
    "type": "business",
    "companyName": "Auto Komis Premium Sp. z o.o.",
    "registeredAt": "2019-03-11T00:00:00+01:00",
    "lastSeenAt": "2026-07-21T18:42:00+02:00"
  },
  "contact": {
    "name": "Auto Komis Premium",
    "phoneAvailable": true,
    "chatAvailable": true,
    "courier": false,
    "negotiation": true
  },
  "createdTime": "2026-07-18T10:24:55+02:00",
  "lastRefreshTime": "2026-07-21T08:05:12+02:00",
  "validToTime": "2026-08-18T10:24:55+02:00",
  "status": "active",
  "isActive": true,
  "isBusiness": true,
  "isPromoted": true,
  "isHighlighted": false
}