crawlbaseДокументация
Войти

OLX SERP

Превратите страницу результатов поиска или категории OLX в структурированный массив объявлений с метаданными пагинации. Передайте scraper=olx-serp в Crawling API с любым URL списка OLX.

Использование

Отправьте URL поиска или категории OLX в Crawling API с параметром scraper=olx-serp. Скрапер охватывает общий фронтенд OLX, поэтому одно и то же имя скрапера работает на всех рынках - меняется только домен в URL запроса.

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)

Пример входного URL

Любая страница результатов поиска, категории или запроса OLX. Несколько примеров по рынкам 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/

Скрапер olx-serp работает на общем фронтенде OLX на olx.pl, olx.ua, olx.pt, olx.ro, olx.bg, olx.kz и olx.uz - меняется только TLD в URL запроса. OLX ограничивает частоту запросов с IP-адресов дата-центров, но вы не выбираете пул прокси сами - Crawling API по умолчанию направляет запросы через свою резидентную сеть и автоматически выбирает лучший выходной узел для каждого запроса. Указывайте country= (например, country=PL для olx.pl) только когда вам нужна геолокация конкретного рынка.

Ответ

Скрапер возвращает объект JSON, описывающий страницу результатов, и массив объявлений items.

url
string
URL разобранной страницы результатов.
categoryId
integer | null
ID категории OLX для страницы результатов, если присутствует.
page
integer | null
Индекс текущей страницы результатов (с нуля).
totalPages
integer | null
Общее число страниц результатов, доступных для этого запроса.
totalCount
integer | null
Общее число объявлений, соответствующих запросу, на всех страницах.
itemCount
integer
Число объявлений, возвращённых на этой странице (длина items).
items
array
Массив объявлений на текущей странице результатов.
items[].id
integer | null
ID объявления OLX.
items[].title
string | null
Заголовок объявления.
items[].url
string | null
Канонический URL страницы отдельного объявления.
items[].price
object
Объект цены объявления.
items[].price.value
number | null
Числовое значение цены.
items[].price.currency
string | null
Код валюты ISO (например, PLN, UAH, EUR).
items[].price.currencySymbol
string | null
Отображаемый символ валюты (например, zł).
items[].price.displayValue
string | null
Форматированная цена в удобочитаемом виде, как показано на OLX.
items[].price.negotiable
boolean
Отметил ли продавец цену как договорную.
items[].price.free
boolean
Указано ли объявление как бесплатное.
items[].price.exchange
boolean
Готов ли продавец к обмену вместо оплаты наличными.
items[].location
object
Объект местоположения объявления.
items[].location.city
string | null
Название города.
items[].location.region
string | null
Название региона, воеводства или области.
items[].location.district
string | null
Район или микрорайон, если присутствует.
items[].location.path
string | null
Удобочитаемый путь местоположения (регион, город, район).
items[].location.latitude
number | null
Приблизительная широта.
items[].location.longitude
number | null
Приблизительная долгота.
items[].category
object
Объект категории объявления.
items[].category.id
integer | null
ID категории OLX для объявления.
items[].category.type
string | null
Slug типа категории (например, automotive).
items[].createdTime
string | null
Метка времени ISO 8601 публикации объявления.
items[].isPromoted
boolean
Является ли объявление платным/продвигаемым.
items[].isHighlighted
boolean
Выделено ли объявление визуально в результатах.
items[].isBusiness
boolean
Опубликовано ли объявление бизнес-аккаунтом.
items[].thumbnailUrl
string | null
URL миниатюры изображения объявления.

Пример ответа

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