crawlbaseDocs
Se connecter

OLX Item

Transformez une page d'annonce OLX unique en JSON structuré avec la description complète, les paramètres de l'annonce, les photos, la localisation et le vendeur. Passez scraper=olx-item à la Crawling API avec n'importe quelle URL d'annonce OLX.

Utilisation

Envoyez l'URL de l'annonce OLX individuelle à la Crawling API avec le paramètre scraper=olx-item. Les pages d'annonce se trouvent sous le chemin /d/. Le scraper couvre le frontend partagé d'OLX, de sorte que le même nom de scraper fonctionne sur tous les marchés - seul le domaine dans l'URL de requête change.

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)

Exemple d'URL d'entrée

N'importe quelle URL d'annonce OLX individuelle (le chemin de détail /d/). Quelques exemples sur les marchés d'OLX :

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

Le scraper olx-item fonctionne sur le frontend partagé d'OLX sur olx.pl, olx.ua, olx.pt, olx.ro, olx.bg, olx.kz et olx.uz - seul le TLD dans l'URL de requête change. OLX limite le débit des IP de centres de données, mais vous ne choisissez pas le pool de proxys vous-même - la Crawling API achemine par défaut via son réseau résidentiel et sélectionne automatiquement le meilleur point de sortie pour chaque requête. Passez country= (par ex. country=PL pour olx.pl) uniquement lorsque vous avez besoin de la géolocalisation d'un marché spécifique.

Réponse

Le scraper renvoie un objet JSON avec l'annonce complète, y compris ses paramètres, photos, localisation et vendeur.

url
string
L'URL de la page d'annonce analysée.
id
integer | null
ID de l'annonce OLX.
title
string | null
Titre de l'annonce.
description
string | null
Texte complet de la description de l'annonce tel que rédigé par le vendeur.
category
object
Objet catégorie de l'annonce.
category.id
integer | null
ID de catégorie OLX.
category.type
string | null
Slug du type de catégorie (par ex. automotive).
price
object
Objet prix de l'annonce.
price.value
number | null
Valeur numérique du prix.
price.currency
string | null
Code de devise ISO (par ex. PLN, UAH, EUR).
price.currencySymbol
string | null
Symbole de devise affiché (par ex. zł).
price.displayValue
string | null
Prix formaté et lisible tel qu'affiché sur OLX.
price.negotiable
boolean
Si le vendeur a marqué le prix comme négociable.
price.free
boolean
Si l'annonce est répertoriée comme gratuite.
price.exchange
boolean
Si le vendeur est ouvert à un échange plutôt qu'à un paiement en espèces.
itemCondition
string | null
État de l'article lorsqu'il est fourni (par ex. new, used).
params
array
Tableau des paramètres spécifiques à l'annonce (marque, année, kilométrage, taille, etc.).
params[].key
string | null
Clé de paramètre lisible par machine.
params[].name
string | null
Libellé de paramètre localisé tel qu'affiché sur OLX.
params[].value
string | null
Valeur de paramètre localisée.
params[].normalizedValue
string | null
Valeur normalisée adaptée au filtrage, lorsqu'elle est disponible.
location
object
Objet localisation de l'annonce.
location.city
string | null
Nom de la ville.
location.region
string | null
Nom de la région, de la voïvodie ou de l'oblast.
location.district
string | null
District ou quartier, si présent.
location.path
string | null
Chemin de localisation lisible (région, ville, district).
location.latitude
number | null
Latitude approximative.
location.longitude
number | null
Longitude approximative.
photos
array
Tableau des URL de photos en taille réelle de l'annonce.
seller
object
Objet vendeur de l'annonce.
seller.id
integer | null
ID du vendeur OLX.
seller.name
string | null
Nom d'affichage du vendeur.
seller.type
string | null
Type de vendeur (par ex. private, business).
seller.companyName
string | null
Nom d'entreprise enregistré pour les vendeurs professionnels.
seller.registeredAt
string | null
Horodatage ISO 8601 de l'inscription du vendeur sur OLX.
seller.lastSeenAt
string | null
Horodatage ISO 8601 de la dernière activité du vendeur.
contact
object
Objet options de contact de l'annonce.
contact.name
string | null
Nom de contact affiché sur l'annonce.
contact.phoneAvailable
boolean
Si un numéro de téléphone est disponible pour cette annonce.
contact.chatAvailable
boolean
Si le chat OLX est activé pour cette annonce.
contact.courier
boolean
Si la livraison/le service de coursier OLX est proposé.
contact.negotiation
boolean
Si le vendeur accepte la négociation du prix.
createdTime
string | null
Horodatage ISO 8601 de la publication de l'annonce.
lastRefreshTime
string | null
Horodatage ISO 8601 de la dernière actualisation de l'annonce par le vendeur.
validToTime
string | null
Horodatage ISO 8601 de l'expiration de l'annonce.
status
string | null
Statut de l'annonce (par ex. active, removed).
isActive
boolean
Si l'annonce est actuellement active.
isBusiness
boolean
Si l'annonce a été publiée par un compte professionnel.
isPromoted
boolean
Si l'annonce est une annonce payante/promue.
isHighlighted
boolean
Si l'annonce est visuellement mise en avant.

Exemple de réponse

{
  "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
}