crawlbase文档
登录

OLX Item

将单条 OLX 广告页转换为结构化 JSON，包含完整描述、广告参数、照片、位置和卖家。使用任意 OLX 广告 URL，将 scraper=olx-item 传递给 Crawling API。

用法

将单条 OLX 广告 URL 连同 scraper=olx-item 参数发送到 Crawling API。广告页位于 /d/ 路径下。该 scraper 覆盖 OLX 共享的前端，因此同一个 scraper 名称可用于所有市场 - 仅请求 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

任意单条 OLX 广告 URL（/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 scraper 适用于 OLX 共享的前端，涵盖 olx.pl、olx.ua、olx.pt、olx.ro、olx.bg、olx.kz 和 olx.uz - 仅请求 URL 中的 TLD 不同。OLX 会对数据中心 IP 限速，但代理池无需你自行选择 - Crawling API 默认通过其住宅网络路由，并为每个请求自动选择最佳出口节点。仅当你需要特定市场的地理定位时，才传入 country=（例如 olx.pl 使用 country=PL）。

响应

scraper 返回一个包含完整广告的 JSON 对象，包括其参数、照片、位置和卖家。

url
string
被抓取的广告页 URL。
id
integer | null
OLX 广告 ID。
title
string | null
广告标题。
description
string | null
卖家撰写的完整广告描述文本。
category
object
广告的类目对象。
category.id
integer | null
OLX 类目 ID。
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
OLX 卖家 ID。
seller.name
string | null
卖家显示名称。
seller.type
string | null
卖家类型（例如 private、business）。
seller.companyName
string | null
商家卖家的注册公司名称。
seller.registeredAt
string | null
卖家在 OLX 注册时间的 ISO 8601 时间戳。
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
}