OLX 巴西站

OLX 巴西站 API

按商品页链接读 OLX 巴西站(olx.com.br)上的一件在售商品:标题、描述、价格和币种、分类、商品状况和属性、图片链接、发布时间、卖家显示名和类型,以及所在的城市、街区和州,用来核对商品的标价和卖家信息;不含卖家电话、邮编、地图坐标和聊天或联系方式。商品下架或不存在时回空结果。

请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 olx,action 填下方列表里的能力名,例如 product_detail。只要一把 API Key,不用 OLX 巴西站账号和 Cookie;也能当 MCP 工具接进 Claude、Cursor。可以先领 $1 免费额度试用。

  • 1 个能力
  • $1.19 / 千次
  • 失败和空结果都不收费

平台运行状态

24h 健康值
正常
正常

30 天趋势

OLX 巴西站 能力清单

能力做什么单价24 小时运行状态 · 全部正常
商品详情product_detail用 product_detail 按商品页链接读 OLX 巴西站(olx.com.br)上的一件在售商品,每次回一个对象。$1.19 / 千次正常

选 OLX 巴西站数据接口前常问的 5 件事

调用时要不要提供 OLX 巴西站账号或 Cookie?

不用,请求头带 Authorization: Bearer 和 API Key 就能调,请求体写 platform、action 和能力参数。不用扫码、维护登录状态,也不用开浏览器。

怎么收费?失败了收不收钱?有免费额度吗?

按调用次数计费,每千次 $1.19 起。失败、空结果、参数错误和鉴权失败都不收费。给 GitHub 上 everyinfra-agent-plugins 和 seo-skills 点星,可在控制台「余额与充值」领 $1 赠送额度,24 小⁠时内有效,不用信用卡。

能把 OLX 巴西站接口接进 Claude、Cursor 吗?

能,远程 MCP 地址是 https://api.everyinfra.com/mcp,请求头加 Authorization: Bearer 和 API Key,不用装本地程序。Claude、Cursor、ChatGPT、Claude Code 配置见 https://everyinfra.com/mcp-server。

用 OLX 巴西站数据要注意哪些合规问题?

EveryInfra 服务条款要求你自行确保数据用法符合适用法律和相关平台条款,禁止用于违法、侵犯隐私或知识产权,或批量抓取用于骚扰、欺诈等恶意用途。用到昵称、头像等个人信息时,只留业务用得上的字段。

可以拿到 OLX 巴西站的哪些数据?

OLX 巴西站有 1 个能力:商品详情。每个能力的参数和返回字段见本页接口说明。

请求填写示例

url 填商品页链接,末尾是商品编号;回一个对象,商品下架或不存在时回空结果。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

olx_product_detail.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"olx","action":"product_detail","params":{"url":"https://go.olx.com.br/grande-goiania-e-anapolis/celulares/iphone-15-pro-max-white-titanium-1331424006"}}'

记录字段预览(非真实响应)

仅展示 product_detail 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "title": null,
  "url": null,
  "description": null,
  "price": null,
  "currency": null,
  "category": null,
  "parent_category": null,
  "condition": null,
  "attributes": null,
  "images": null,
  "posted_at": null,
  "seller_name": null,
  "seller_id": null,
  "seller_type": null,
  "city": null,
  "neighborhood": null,
  "state": null,
  "country": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

OLX API 如何读巴西站一件商品的价格和卖家类型?

用 product_detail 按商品页链接读 OLX 巴西站(olx.com.br)上的一件在售商品,每次回一个对象。

查看 product_detail 的 url 参数
  • url 填商品页链接,末尾是商品编号;price 是整数,单位见 currency(巴西雷亚尔是 BRL),卖家没标价时没有。
  • seller_type 是 private 表示个人卖家、professional 表示商家;category、condition 和 attributes 按页面原文(葡萄牙语);不含卖家电话、邮编和地图坐标;商品下架时回空结果,empty_reason 是 item_not_found。

OLX 巴西站 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

所有能力都是同步调用。

能力必填参数可选参数单次条数单价返回字段
product_detailurl——$1.19 / 千次id · title · url · description · price · currency · category · parent_category · condition · attributes · images · posted_at · seller_name · seller_id · seller_type · city · neighborhood · state · country · platform

怎么调用 OLX 巴西站 商品详情 API?

product_detail

使用 platform="olx"、action="product_detail" 调用“商品详情”能力;返回单个对象,主要包含 id、title、url、description、price、currency 等 20 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

OLX 巴西站 product_detail 的参数分别是什么意思?

url必填
OLX 巴西站(olx.com.br)商品页链接,末尾是商品编号,如 https://sp.olx.com.br/sao-paulo-e-regiao/celulares/iphone-15-128gb-1234567890。

OLX 帮助中心的这篇文章说明发布商品要写标题(最多 90 个字符)、加照片、选分类和子分类并填补充信息、填 CEP(邮编)定位地区、填总价;描述最多 6,000 个字符。这里支撑商品页上的标题、描述、分类、价格、图片和所在地区;本接口的参数由 EveryInfra 定义,该来源不证明结果。官方来源:OLX 帮助中心:Como publicar anúncio来源核查:

OLX 巴西站 返回字段与含义(19)
id
商品编号,就是链接末尾那串数字。
title
商品标题。
url
商品页链接。
description
卖家写的商品描述,换行照原样保留。
price
售价,整数,单位见 currency;卖家没标价时没有这一项。
currency
售价的币种,巴西雷亚尔是 BRL。
category
所在分类,按页面原文(葡萄牙语)。
parent_category
上一级分类,按页面原文(葡萄牙语)。
condition
商品状况,按页面原文(如 Usado - Excelente)。
attributes
商品属性列表,每项 name、value,按页面原文(如 Marca、Modelo、Condição)。
images
商品图片链接,按页面顺序;没上传图片的商品没有这一项。
posted_at
发布时间,ISO 8601,UTC。
seller_name
卖家在 OLX 上显示的名字。
seller_id
卖家编号。
seller_type
卖家类型:private 是个人卖家,professional 是商家。
city
所在城市。
neighborhood
所在街区。
state
所在州的两位字母缩写,如 SP、RJ。
country
国家代码,OLX 巴西站都是 BR。
OLX 巴西站 product_detail 调用流程一次 OLX 巴西站 product_detail 调用的全过程:向 POST /api/v1/social 发送 platform="olx"、action="product_detail",以及必填参数 url;返回结构化 JSON,含 id、title、url、description、price 等字段;返回单个对象,计费 $1.19 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "olx"action: "product_detail"urlEveryInfra$1.19 / 千次2 · 响应 · 对象idtitleurldescriptionprice
一次 OLX 巴西站 product_detail 调用的全过程:向 POST /api/v1/social 发送 platform="olx"、action="product_detail",以及必填参数 url;返回结构化 JSON,含 id、title、url、description、price 等字段;返回单个对象,计费 $1.19 / 千次,失败与空结果不计费。

OLX 巴西站 原始字段名

EveryInfra 统一字段名

左边是 OLX 巴西站 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。110 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

OLX 巴西站 的独有字段名(当前目录)

全站 110 个平台的当前目录中,这 1 个字段名只在 OLX 巴西站 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • parent_category

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

id
商品编号,就是链接末尾那串数字。
title
商品标题。
url
商品页链接。
description
卖家写的商品描述,换行照原样保留。
price
售价,整数,单位见 currency;卖家没标价时没有这一项。
currency
售价的币种,巴西雷亚尔是 BRL。
category
所在分类,按页面原文(葡萄牙语)。
parent_category
上一级分类,按页面原文(葡萄牙语)。
condition
商品状况,按页面原文(如 Usado - Excelente)。
attributes
商品属性列表,每项 name、value,按页面原文(如 Marca、Modelo、Condição)。
images
商品图片链接,按页面顺序;没上传图片的商品没有这一项。
posted_at
发布时间,ISO 8601,UTC。
seller_name
卖家在 OLX 上显示的名字。
seller_id
卖家编号。
seller_type
卖家类型:private 是个人卖家,professional 是商家。
city
所在城市。
neighborhood
所在街区。
state
所在州的两位字母缩写,如 SP、RJ。
country
国家代码,OLX 巴西站都是 BR。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

OLX 巴西站 API 常见问题

OLX 巴西站 API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="olx"、action 和 params。以 product_detail 为例,必填 url,没有可选参数。url 填商品页链接,末尾是商品编号;回一个对象,商品下架或不存在时回空结果。 OLX 巴西站 共 1 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 110 个平台。

OLX 巴西站 API 一次能返回多少条数据?

OLX 巴西站 的 1 个接口外层结果都是单个对象,不能按列表接口估算条数;对象内仍可能包含数组,数量及完整性需按对应字段说明判断。

OLX 巴西站 API 返回哪些字段?

当前目录为 product_detail 列出 id、title、url、description、price、currency 等 20 个字段名。按全站当前目录统计,1 个字段名只在 OLX 巴西站 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

OLX API 如何读巴西站一件商品的价格和卖家类型?

用 product_detail 按商品页链接读 OLX 巴西站(olx.com.br)上的一件在售商品,每次回一个对象。 url 填商品页链接,末尾是商品编号;price 是整数,单位见 currency(巴西雷亚尔是 BRL),卖家没标价时没有。 seller_type 是 private 表示个人卖家、professional 表示商家;category、condition 和 attributes 按页面原文(葡萄牙语);不含卖家电话、邮编和地图坐标;商品下架时回空结果,empty_reason 是 item_not_found。

开始调用 OLX 巴西站 API

在 GitHub 给两个仓库点星领 $1 额度,注册后在控制台领取,24 小⁠时内有效,先选一个 OLX 巴西站 接口验证结果。

免费开始

Google Analytics 同意才加载 隐私