OLX Listings API

RapidAPI2026-07-05 更新2026-07-06 收录

二手商品

在线分类广告分析

数据链接：

https://rapidapi.com/piotrv1001/api/olx-listings-api 数据链接链接失效反馈

官方服务：

资源简介：

Search live OLX classifieds listings across Poland, Bulgaria, Romania, Portugal & Ukraine — get prices, condition, location, GPS, photos, and seller data as structured JSON.

创建时间：

2026-07-05

原始信息汇总

数据集概述：OLX Listings API

简介：OLX Listings API 允许用户实时搜索来自 OLX（中欧和东欧最大的分类广告市场之一）的活跃列表，并以结构化 JSON 格式返回数据。该 API 旨在用于价格追踪、分类广告聚合、转售商工具和本地市场分析。

核心功能：

支持在 5 个国家市场（波兰、保加利亚、罗马尼亚、葡萄牙、乌克兰）进行搜索。
可通过关键字、类别和价格区间进行查询。
可获取单个列表的完整详情，包括GPS 坐标、照片、商品状况和卖家数据。

主要特性：

快速：热响应时间约为 300 毫秒，返回结构化 JSON，无需解析 HTML。
多国支持：通过一个 API 覆盖波兰、保加利亚、罗马尼亚、葡萄牙和乌克兰。
丰富数据：每个列表包含 20 多个字段，如价格、可议价性、状况、位置、照片、卖家资料、类别和自定义属性。
GPS 坐标：/detail 端点为每个列表提供经纬度坐标。
自愈性：对上游变化具有弹性，运行在 Apify 平台上。

认证方式：所有请求通过 RapidAPI 进行，需要在请求头中包含 X-RapidAPI-Key 和 X-RapidAPI-Host。

接口端点：

方法	端点	描述
`GET`	`/search`	搜索列表。返回一页标准化的结果。
`GET`	`/detail`	根据单个 offer ID 获取完整的列表对象，包含 GPS 坐标。

端点 /search 参数：

参数	类型	必需	默认值	描述
`q`	string	否	`""`	自由文本查询（例如 `iphone`）。空值表示浏览所有内容。
`country`	string	否	`pl`	市场代码：`pl`、`bg`、`ro`、`pt` 或 `ua`。
`categoryId`	integer	否	—	OLX 类别 ID（特定区域）。
`page`	integer	否	`1`	从 1 开始的页码。
`limit`	integer	否	`40`	每页结果数（1–50）。
`sortBy`	string	否	`created_at:desc`	排序方式：`created_at:desc`、`price:asc`、`price:desc`、`relevance:desc`。
`priceFrom`	integer	否	—	最低价格（本地货币）。
`priceTo`	integer	否	—	最高价格（本地货币）。

端点 /detail 参数：

参数	类型	必需	默认值	描述
`id`	integer	是	—	OLX offer ID。
`country`	string	否	`pl`	offer 所属的市场。

响应字段 (/search)：

字段	类型	描述
`id`	number	OLX offer ID（用于 `/detail` 端点）。
`url`	string	规范的列表 URL。
`title`	string	列表标题。
`description`	string	列表描述。
`price`	number	要价（本地货币），或为 `null`。
`currency`	string	价格货币，例如 `PLN`。
`negotiable`	boolean	价格是否可议价。
`previousPrice`	number	降价前的价格，或为 `null`。
`condition`	string	商品状况（本地化标签）。
`city`	string	卖家所在城市。
`region`	string	卖家所在地区/省。
`lat` / `lon`	number	GPS 坐标（近似值）。
`categoryId`	number	OLX 类别 ID。
`sellerId`	number	卖家 ID。
`sellerName`	string	卖家显示名称。
`isPromoted`	boolean	列表是否为推广/置顶广告。
`photos`	array	图片 URL 数组。
`params`	object	类别特定属性（键 → 标签）。
`createdAt`	string	ISO 8601 格式的列表时间戳。

常见问题：

数据新鲜度：每次调用都会实时抓取 OLX 数据。
支持的国家：波兰 (pl)、保加利亚 (bg)、罗马尼亚 (ro)、葡萄牙 (pt) 和乌克兰 (ua)。
分页：支持，使用 page（从 1 开始）和 limit（每页最多 50 条）参数。
类别 ID：在 OLX 网站上打开一个类别并记下其数字 ID，或省略 categoryId 以搜索所有类别。
/search 与 /detail 的区别：/search 每页返回多个标准化的列表；/detail 返回单个 offer 的完整对象，并包含 GPS 坐标。
速率限制：每个套餐有不同的速率限制和月度配额。