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

OLX Item

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

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

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

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)

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

Любой URL отдельного объявления OLX (путь деталей /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

Скрапер olx-item работает на общем фронтенде 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 с полным объявлением, включая его параметры, фото, местоположение и продавца.

url
string
URL разобранной страницы объявления.
id
integer | null
ID объявления OLX.
title
string | null
Заголовок объявления.
description
string | null
Полный текст описания объявления, написанный продавцом.
category
object
Объект категории объявления.
category.id
integer | null
ID категории OLX.
category.type
string | null
Slug типа категории (например, automotive).
price
object
Объект цены объявления.
price.value
number | null
Числовое значение цены.
price.currency
string | null
Код валюты ISO (например, PLN, UAH, EUR).
price.currencySymbol
string | null
Отображаемый символ валюты (например, zł).
price.displayValue
string | null
Форматированная цена в удобочитаемом виде, как показано на OLX.
price.negotiable
boolean
Отметил ли продавец цену как договорную.
price.free
boolean
Указано ли объявление как бесплатное.
price.exchange
boolean
Готов ли продавец к обмену вместо оплаты наличными.
itemCondition
string | null
Состояние товара, если указано (например, new, used).
params
array
Массив специфичных для объявления параметров (марка, год, пробег, размер и т. д.).
params[].key
string | null
Машиночитаемый ключ параметра.
params[].name
string | null
Локализованная метка параметра, как показано на OLX.
params[].value
string | null
Локализованное значение параметра.
params[].normalizedValue
string | null
Нормализованное значение, пригодное для фильтрации, если доступно.
location
object
Объект местоположения объявления.
location.city
string | null
Название города.
location.region
string | null
Название региона, воеводства или области.
location.district
string | null
Район или микрорайон, если присутствует.
location.path
string | null
Удобочитаемый путь местоположения (регион, город, район).
location.latitude
number | null
Приблизительная широта.
location.longitude
number | null
Приблизительная долгота.
photos
array
Массив URL полноразмерных фотографий объявления.
seller
object
Объект продавца объявления.
seller.id
integer | null
ID продавца OLX.
seller.name
string | null
Отображаемое имя продавца.
seller.type
string | null
Тип продавца (например, private, business).
seller.companyName
string | null
Зарегистрированное название компании для бизнес-продавцов.
seller.registeredAt
string | null
Метка времени ISO 8601 регистрации продавца на OLX.
seller.lastSeenAt
string | null
Метка времени ISO 8601 последней активности продавца.
contact
object
Объект вариантов связи объявления.
contact.name
string | null
Контактное имя, показанное в объявлении.
contact.phoneAvailable
boolean
Доступен ли номер телефона для этого объявления.
contact.chatAvailable
boolean
Включён ли чат OLX для этого объявления.
contact.courier
boolean
Предлагается ли курьерская доставка OLX.
contact.negotiation
boolean
Принимает ли продавец торг по цене.
createdTime
string | null
Метка времени ISO 8601 публикации объявления.
lastRefreshTime
string | null
Метка времени ISO 8601 последнего обновления объявления продавцом.
validToTime
string | null
Метка времени ISO 8601 истечения срока объявления.
status
string | null
Статус объявления (например, active, removed).
isActive
boolean
Активно ли объявление в настоящее время.
isBusiness
boolean
Опубликовано ли объявление бизнес-аккаунтом.
isPromoted
boolean
Является ли объявление платным/продвигаемым.
isHighlighted
boolean
Выделено ли объявление визуально.

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

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