crawlbaseDocs
Se connecter

OLX SERP

Transformez une page de résultats de recherche ou de catégorie OLX en un tableau structuré d'annonces avec métadonnées de pagination. Passez scraper=olx-serp à la Crawling API avec n'importe quelle URL de liste OLX.

Utilisation

Envoyez l'URL de recherche ou de catégorie OLX à la Crawling API avec le paramètre scraper=olx-serp. 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/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)

Exemple d'URL d'entrée

N'importe quelle page de résultats de recherche, de catégorie ou de requête OLX. Quelques exemples sur les marchés d'OLX :

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/

Le scraper olx-serp 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 décrivant la page de résultats et un tableau items d'annonces.

url
string
L'URL de la page de résultats analysée.
categoryId
integer | null
ID de catégorie OLX de la page de résultats, si présent.
page
integer | null
Index (base zéro) de la page de résultats actuelle.
totalPages
integer | null
Nombre total de pages de résultats disponibles pour cette requête.
totalCount
integer | null
Nombre total d'annonces correspondant à la requête sur toutes les pages.
itemCount
integer
Nombre d'annonces renvoyées sur cette page (longueur de items).
items
array
Tableau des annonces de la page de résultats actuelle.
items[].id
integer | null
ID de l'annonce OLX.
items[].title
string | null
Titre de l'annonce.
items[].url
string | null
URL canonique de la page d'annonce individuelle.
items[].price
object
Objet prix de l'annonce.
items[].price.value
number | null
Valeur numérique du prix.
items[].price.currency
string | null
Code de devise ISO (par ex. PLN, UAH, EUR).
items[].price.currencySymbol
string | null
Symbole de devise affiché (par ex. zł).
items[].price.displayValue
string | null
Prix formaté et lisible tel qu'affiché sur OLX.
items[].price.negotiable
boolean
Si le vendeur a marqué le prix comme négociable.
items[].price.free
boolean
Si l'annonce est répertoriée comme gratuite.
items[].price.exchange
boolean
Si le vendeur est ouvert à un échange plutôt qu'à un paiement en espèces.
items[].location
object
Objet localisation de l'annonce.
items[].location.city
string | null
Nom de la ville.
items[].location.region
string | null
Nom de la région, de la voïvodie ou de l'oblast.
items[].location.district
string | null
District ou quartier, si présent.
items[].location.path
string | null
Chemin de localisation lisible (région, ville, district).
items[].location.latitude
number | null
Latitude approximative.
items[].location.longitude
number | null
Longitude approximative.
items[].category
object
Objet catégorie de l'annonce.
items[].category.id
integer | null
ID de catégorie OLX de l'annonce.
items[].category.type
string | null
Slug du type de catégorie (par ex. automotive).
items[].createdTime
string | null
Horodatage ISO 8601 de la publication de l'annonce.
items[].isPromoted
boolean
Si l'annonce est une annonce payante/promue.
items[].isHighlighted
boolean
Si l'annonce est visuellement mise en avant dans les résultats.
items[].isBusiness
boolean
Si l'annonce a été publiée par un compte professionnel.
items[].thumbnailUrl
string | null
URL de la vignette de l'annonce.

Exemple de réponse

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