Mercado Libre

平台 · 详解依据官方页面编写，包括平台自身与辅助服务的页面。

概览

Mercado Libre（西班牙语意为«自由市场»）是拉丁美洲的交易平台：电商市场、 Mercado Pago 支付服务、Mercado Envíos 物流与 Mercado Ads 广告后台同处一个体系。它不是社交网络，而是一个橱窗，拥有自己的搜索排名、付费形式，以及对商品卡片编排的严格规则。

平台归 MercadoLibre, Inc. 所有——这是一家在美国上市的公司，因此必须公布可核验的数字：下文关于受众的几乎全部内容，取自它向 SEC 提交的报告，而非新闻稿。

第二个特点是异常开放的开发者文档。 API Docs 板块无需登录即可提供商品发布、照片要求、广告活动、卖家信誉与审核的说明。在 Mercado Libre 上可以核查那些在多数电商市场被藏在卖家后台里的内容。

这里有谁

公司在 2026 年第一季度（截至 2026 年 3 月 31 日的三个月）致股东信中报告： 8400 万独立活跃买家，上年同期为 6700 万；8300 万金融科技服务活跃用户；商品交易额 18 951 百万美元；售出 7.22 亿件商品。数字的归属被直接点明：这是公司本身向 SEC 提交的报告。

同一份文件给出了释义：«独立活跃买家»指在该期间内至少完成一次购买的用户；自 2025 年第二季度起，该指标纳入了餐饮配送。这不能与社交网络的«活跃用户»相比：说的是购买，而不是打开应用。

分国别数据公司只选择性给出：巴西的交易额同比增长 38 %（不计汇率影响），独立买家数增长 32 %。

阿根廷面向卖家的页面给出自己的数字，但没有统计日期： 1600 万独立买家，售出商品超过 3 亿件，65 % 的配送在 48 小时内完成。这是平台的营销页面，页面上未注明日期。

地域范围也能从文档中的站点代码看出——MLA（阿根廷）、MLB（巴西）、MLM（墨西哥）、 MLC（智利）、MCO（哥伦比亚）、MLU（乌拉圭），以及单独用于跨境贸易的 CBT：它们列在发布类型的说明中。

如何开始

成为卖家通过普通注册即可：需要身份证件和电子邮箱地址，如果以公司身份经营，税务资料可以稍后补充。

卖家的橱窗是平台内部的一个页面，而不是独立网站。带品牌的«官方商店»并非人人可得：要进入 Official Stores，需要联系平台的商务顾问，而一个用户可以拥有多个品牌，并带有形如 /tienda/<名称> 的固定链接。

API 应用不会自动创建：必须完整走完 KYC 流程，无一例外；logo 为 PNG，400×400 像素，小于 100 KB；重定向地址必须使用 HTTPS。在核对之日，匿名调用 API 无法通过：对 https://api.mercadolibre.com/sites 的请求向我们返回了 403，代码为 PA_UNAUTHORIZED_RESULT_FROM_POLICIES——这是我们在 2026 年 7 月 28 日的观察。

可以发布什么

发布类型既决定可见度，也决定成本。文档描述了三种： free——活跃商品不超过 10 条，无成交佣金，可见度最低；gold_special（«Clásica»） ——数量不受限制，只需支付成交佣金；gold_pro（«Premium»）——佣金更高，但买家可以分期付款。各国可选的类型不同：阿根廷只有 gold_special，乌拉圭自 2023 年 11 月 15 日起可用 free 和 gold_special。

照片要求被完整公布：接受的最大尺寸为 1920×1920 像素，最小为 500×500；文件不超过 10 MB，格式为 JPG、JPEG 和 PNG；图片数量取决于类目。商品描述为纯文本：不能更改字体，也不能加粗；如果残留 HTML 标签、表情符号或特殊字符，会出现 item.description.type.invalid 错误；描述中最多可添加 10 张图片和一个 YouTube 视频链接。

关于商品卡片的建议：标题结构为«商品 + 品牌 + 型号 + 参数»，白底主图不超过 10 张，每件商品的变体组合不超过 100 种；首次成交后标题不可修改。对于跨境商品，标题不会自动翻译。

如何成长

平台会计算«发布质量»并展示给卖家：/performance 资源给出 0 到 100 的评分和三个等级，在响应示例中可以看到影响搜索结果的要求—— 通用商品编码（按平台的说法，没有它就«失去可见度»）以及至少三张照片。

Mercado Ads 是按搜索词投放的站内广告。概览页面提示，该功能仅在巴西、墨西哥和智利可用；该页面于 2025 年 12 月 12 日更新。Product Ads 的准入门槛写得很直白：黄色或更高信誉、注册满 15 天、最低销量——公司 1 单、个人 10 单、无逾期账单。同一页面还有预算机制：借助前几日的余额，单日支出可达设定值的两倍，目标 ROAS 可在 1x 到 35x 之间设定。

促销活动的差别在于由谁定价：在大促中价格由卖家确定并需要审批，在共同出资的活动中卖家接受平台的报价，卖家自有的活动限于 14 天。

内置分析不多，但很具体。浏览量按天去重计算，48 小时内出现，查询深度限于 150 天，对跨境商品不生效。需求方面：/trends 资源给出本周的 50 个搜索词。

变现路径

平台不向作者付费：这里赚钱的方式只有一种——卖货，支出则是佣金。它没有公开确切费率：佣金取决于国家、类目、发布类型、物流和价格，由 listing_prices 资源计算。文档给出了阿根廷在价格为 5000 比索时的响应示例： gold_pro——成交佣金 2000 比索，其中百分比部分为 36 %，固定部分 200 比索，分期附加费 23；gold_special——850 比索，百分比部分 13 %，固定部分 200 比索； free——0。这是文档中的示例（该页面于 2026 年 4 月 15 日更新），而不是你所在类目的价目表。

同一页面还描述了支出结构的变化：固定费用现在不仅取决于商品价格，还取决于物流类型和配送方式；按国家分批启用——巴西 3 月 2 日、阿根廷 3 月 12 日、哥伦比亚 3 月 23 日、智利 4 月 6 日、墨西哥 4 月 8 日；缺少 logistic_type、 shipping_mode 和 billable_weight 参数时，计算结果不会与实际扣款一致。

工具与自动化

官方 API 覆盖了几乎整个流程：商品、图片、描述、目录、变体、库存、订单与发货、退货与索赔、售后沟通、促销、账单、指标和广告——具体构成可从应用权限清单看出。

事件模型建立在通知之上，要求很严格：必须在 500 毫秒内返回 HTTP 200，否则该主题的订阅会被关闭，失败的尝试会在一小时内重试。批量导出受到限制：用 offset 翻页大约只能取到 1000 条结果，再往后需要 search_type=scan 模式。

限制与规则

卖家信誉自动计算，并影响一切，包括广告权限：计入最近 3 个月已完成的订单加上本月已过的天数；如果历史中已完成订单少于 40 单，则取全部历史。索赔比例的阈值各国不同：在墨西哥，比例不高于 2 % 为浅绿色等级，高于 7 % 为红色；在巴西，界线为 3 %、7 % 和 12 %，在哥伦比亚和智利为 5 %、7 % 和 10 %；备货时间需要控制在 3 天以内。

处罚以阶梯形式描述：首次违规——警告，随后是再次警告并暂停 2 天，再之后是最后通牒并暂停 5 天。法律框架由开发者计划条款设定：平台保留自行决定限制 API 调用次数并随时吊销访问密钥的权利，而开发与其自有服务竞争的服务则被明确禁止。

适合谁

适合在拉丁美洲销售实物商品、并愿意在别人的搜索结果里经营的人：商品卡片的质量、数据的完整性、信誉和发货速度，在这里比外部流量更重要。

不适合作者和博主：这里没有内容发布的收入。同样要谨慎的，还有只指望广告的人：Product Ads 需要信誉和销售历史，而 Mercado Ads 在我们核对的页面上只声明面向三个国家。

来自事实库的已核实数据

本详解所依据的已核实数据摘要。

平台简介

平台这样描述自己：«Compre productos con Envío Gratis en el día en Mercado Libre. Encuentre miles de marcas y productos a precios increíbles.»

自述：这是平台对自身的表述，不是独立评价

来源, 已核查 2026-07-28

该电商平台的运营方是 MercadoLibre, Inc.；开发者计划的条款是与 Mercado Libre Inc. 及其关联公司签订的

API 使用条款的序言

来源, 已核查 2026-07-28

各国站点的代码：MLA（阿根廷）、MLB（巴西）、MLM（墨西哥）、MLC（智利）、MCO（哥伦比亚）、MLU（乌拉圭），以及用于跨境贸易的单独代码 CBT

这些代码列在发布类型可用性的说明中

来源, 已核查 2026-07-28

这里有谁

公司称，截至2026年3月31日的三个月内有8400万名独立活跃买家（上年同期为6700万）

2026年第一季度致股东信，8-K 表格附件99.1

来源, 已核查 2026-07-28

“独立活跃买家”指在报告期内在该电商平台至少完成一次购买的用户；自2025年第二季度起，该指标包含了送餐业务

指标的定义由公司自己给出；与社交网络的 MAU 不可比

来源, 已核查 2026-07-28

公司称2026年第一季度金融科技服务的月活跃用户为8300万（上年同期为6400万）

公司向 SEC 提交的报告

来源, 已核查 2026-07-28

2026年第一季度的商品交易额为189.51亿美元，售出件数为7.22亿件

公司的报告；上年同期为133.30亿美元和4.92亿件

来源, 已核查 2026-07-28

公司称，在剔除汇率影响后，巴西的交易额同比增长38%，独立买家数量增长32%

这是公司在致股东信中的说法

来源, 已核查 2026-07-28

阿根廷的卖家展示页声称有1600万独立买家、超过3亿件售出商品，以及65%的配送在48小时内完成；未说明统计日期

这是平台的营销页面，没有日期

来源, 已核查 2026-07-28

从何开始

按平台的说法，注册卖家需要身份证件和电子邮箱；税务资料可以稍后补充

阿根廷卖家页面的常见问题板块

来源, 已核查 2026-07-28

业务条款

带品牌的“官方店铺”（Official Stores）并非人人可得：开通需要联系平台的商务顾问；一个用户可以有多个品牌，固定链接的形式为 /tienda/<名称>

文档更新于27.02.2026

来源, 已核查 2026-07-28

可以发布什么

发布类型：free（在架商品不超过10条，不收销售佣金，曝光最低）、gold_special（«Clásica»）、gold_pro（«Premium»，佣金更高，可分期）；gold_special 和 gold_pro 没有数量限制

文档更新于30.12.2025

来源, 已核查 2026-07-28

在阿根廷只有 gold_special 可用；在乌拉圭，自2023年11月15日起只剩下 free 和 gold_special；在巴西、墨西哥、哥伦比亚和智利，gold_special 和 gold_pro 都可用

可用类型的组合因国家而异

来源, 已核查 2026-07-28

图片：接受的最大尺寸为1920×1920像素，最小为500×500，文件不超过 10 MB，格式为 JPG、JPEG 和 PNG；宽度超过800像素的图片会启用放大功能；图片数量的上限取决于类目

文档更新于24.03.2026

来源, 已核查 2026-07-28

图片在主 pictures 数组和商品变体中都会被计入，因此即使相册看上去不大，总数也可能超过类目的上限

跨境贸易的常见问题板块

来源, 已核查 2026-07-28

图片。 «The maximum size we accept is 1920 x 1920 px (F version) and the minimum is 500 x 500 px (M version)»；«If the image has higher resolution, it will be resized for version F»，«If the image is smaller than the minimum, it will be the same size (we will not enlarge the image)»。«You're allowed to upload pictures up to 10 MB in the following formats: JPG JPEG PNG»。«RGB pictures are highly recommended over CMYK pictures»。«For pictures wider than 800 pixels, a zoom widget is activated»。在错误提示中平台建议：«Te recomendamos usar 1200 x 1200 para poder hacer zoom»

500 x 500 px 的最小值是在裁掉白边之后计算的——平台提醒说，白边会多裁10%

来源, 已核查 2026-08-04

视频。 商品短视频（clip）：«Format: MP4, MOV, MPEG, or AVI»、«Maximum file size: 280 MB»、«Minimum resolution: 360x640 pixels»、«Vertical video»。错误提示中点出了编码：«use common export settings, like MP4 with the H.264 video codec and AAC audio codec»。短视频只能上传到在架的商品，而且只能上传到卖家本国的站点

编码是在错误提示中给出的，不在要求清单里——这是建议，不是禁令

来源, 已核查 2026-08-04

«Duration: minimum 10 seconds, maximum 61 seconds»——10到61秒

两端的边界都已声明

来源, 已核查 2026-08-04

图片数量取决于商品类目：«There are um maximum images per item allowed to publish according to the category»，错误提示的措辞是«Items in category … cannot exceed X pictures»。商品变体的图片也计入：«If you set images in the main pictures array and also in variations, the effective total may exceed the category limit»。单张图片最大 10 MB。对短视频声明了每日上限：«Uploading clips is subject to a limit set by the daily review capacity of the moderation team, which is capped at 1,000 clips per day»

图片数量的上限取决于商品类目，平台不公布统一的数字；短视频的每日上限见 https://global-selling.mercadolibre.com/devsite/working-with-clips

来源, 已核查 2026-08-04

文本长度。 各来源不一致：在已核查的文档页面上，没有商品名称和描述的字符数。有的是对描述形式的要求：«The description must be in plain text»、«Remove HTML tags, emojis, or special characters from plain_text»——而常见问题的答复却恰恰相反：«Plain text newline characters (\n) do not render as visible line breaks. You must send the description as HTML, replacing \n with <br> or using <p> tags»

来源自相矛盾：描述页面要求不带标记的纯文本，而常见问题板块（https://global-selling.mercadolibre.com/devsite/cbt-publication-titles-descriptions-and-rendering）要求以 HTML 标记发送描述

来源, 已核查 2026-08-04

内容

商品描述是纯文本：不能更改字体，也不能加粗；HTML 标签、表情符号和特殊字符会导致 item.description.type.invalid 错误；描述中最多可以加入10张图片和一个 YouTube 视频链接

文档更新于10.06.2026

来源, 已核查 2026-07-28

平台的建议：标题结构为“商品 + 品牌 + 型号 + 参数”，主图不超过10张且为白底，每件商品的变体组合不超过100个；首次售出之后标题不能再改

文档更新于28.12.2022；日期较旧，这组建议可能已经变化

来源, 已核查 2026-07-28

跨境商品的标题不会自动翻译：每个国家的本地化标题需要自己在 sites_to_sell 中传入

这是平台的直接表述：标题翻译在设计上就不提供

来源, 已核查 2026-07-28

各来源不一致：跨境贸易的帮助文档要求恰恰相反：\n 字符不会显示为换行，描述必须以 HTML 形式发送，使用 <br> 或 <p> 标签

平台自身文档内部的分歧：item-description 页面要求纯文本，CBT 页面要求 HTML

来源, 已核查 2026-07-28

推广

促销类型的区别在于谁定价：在大促（DEAL）中由卖家定价并需要审批，在共同出资的活动中卖家接受平台的报价，卖家自办的活动则限制在14天以内

活动类型汇总表，更新于06.02.2026

来源, 已核查 2026-07-28

数据分析

/performance 资源给出0到100的发布质量评分和三个等级（Bad、Average、Good）；响应示例中的要求包括通用商品编码和至少三张图片

/health 资源已宣布弃用，由 /performance 取代

来源, 已核查 2026-07-28

商品页的浏览按天去重计算，在48小时内出现，可查询的历史深度限制为150天；对跨境（CBT）商品该资源不可用

文档更新于30.12.2025

来源, 已核查 2026-07-28

/trends 资源返回本周的50个搜索词：两周内增长最快的10个、需求最高的20个和最热门的20个

数据每周更新

来源, 已核查 2026-07-28

这里的资金规则

«Programa de afiliados y creadores»是平台面向创作者和拥有受众者的联盟计划；下设独立板块：«Programa de afiliados»和«Campañas para Creadores»

计划的名称取自 Mercado Libre 官方页面的标题；这些页面的内容无法机器读取

来源, 已核查 2026-08-04

价格

固定费用现在不仅取决于商品价格，还取决于物流类型和配送方式；各国的生效日期：巴西3月2日，阿根廷3月12日，哥伦比亚3月23日，智利4月6日，墨西哥4月8日 · 来源标注的日期为 2026-08-27

不带 logistic_type、shipping_mode 和 billable_weight 参数，算出的结果与实际扣款对不上

来源, 已核查 2026-07-28

文档中针对阿根廷、售价5000比索的示例：gold_pro 的销售佣金为2000比索（百分比部分36%，固定部分200比索，分期附加费23），gold_special 为850比索（13% 加200比索），free 为0 · 来源标注的日期为 2026-08-27

这是文档中的 API 响应示例（页面更新于15.04.2026），不是某个具体类目的费率；实际费率由 listing_prices 资源计算，需要令牌

来源, 已核查 2026-07-28

限制与上限

卖家信誉按最近3个月加上本月已过天数内完成的订单计算；如果历史上完成的订单不足40单，就取全部历史

文档更新于15.12.2025

来源, 已核查 2026-07-28

投诉率的门槛：墨西哥——不高于2%为浅绿，2—4%为黄色，4—7%为橙色，高于7%为红色；巴西为3%、7%、12%；哥伦比亚和智利为5%、7%、10%

门槛因国家而异

来源, 已核查 2026-07-28

平台的政策是把订单备货时间控制在3天以内；超时会损害信誉

平台的表述

来源, 已核查 2026-07-28

限制

违规的处罚：第一次是警告，然后是再次警告并暂停2天，再然后是最后通牒并暂停5天

/infractions 资源返回原因和整改方式；单次返回上限为20条记录

来源, 已核查 2026-07-28

内容审核

未公布单独的处罚申诉表单。对于 Brand Protection Program 的投诉，原文：«podrás utilizar el flujo de Mercado Libre para responder una denuncia» —— 卖家携文件作出答复；API 返回 «fecha de vencimiento (plazo máximo para responder a la denuncia)»。对于发布内容的审核处理 —— 按 remedy 字段消除原因，并将发布重新上架

www.mercadolibre.com.* 和 developers...com.ar 返回 403（robots.txt 同样返回 403 —— 不可访问）；同一文档在区域镜像 developers.mercadolibre.co.cr 上可访问 —— 属同一服务的另一个允许访问的地址

来源, 已核查 2026-08-07

法律

API 许可被称为有限的、非独占的、可撤销的和不可转让的；平台有权自行限制调用次数并收回访问密钥；禁止开发与平台自有服务相竞争的服务

开发者计划条款第2.2.1至2.2.3条

来源, 已核查 2026-07-28

API 访问

创建应用需要完整通过 KYC，“没有例外”；应用名称最多50个字符，描述最多150个字符，标志为 PNG、400×400像素、小于 100 KB，回调地址必须是 HTTPS

文档更新于02.06.2026

来源, 已核查 2026-07-28

应用权限的分组：用户，发布与同步，提问与售后沟通，广告，业务指标，销售与配送，促销活动，开具账单

该清单与 API 资源一一对应

来源, 已核查 2026-07-28

匿名请求 API 无法通过：对 https://api.mercadolibre.com/sites 的请求返回 403，代码为 PA_UNAUTHORIZED_RESULT_FROM_POLICIES

这是我们在28.07.2026 的验证；链接给的是文档目录，API 的响应本身不是一个页面

来源, 已核查 2026-07-28

应用必须在500毫秒内返回 HTTP 200，否则平台会关闭对该主题的订阅；失败的尝试会在一小时内以递增的间隔重试

文档更新于23.06.2026

来源, 已核查 2026-07-28

通过 offset 分页大约只能翻到1000条结果；数量更大时需要用 search_type=scan 模式，按 scroll_id 滚动

跨境贸易的常见问题板块，更新于06.05.2026

来源, 已核查 2026-07-28

语言

各来源不一致：首页的标记中声明了17个西班牙语国家和巴西（pt-BR）的语言版本，另加 x-default；html 标签上没有 lang 属性

来源, 已核查 2026-07-28

目录分区： 全部同类 另请参阅： 目录索引 · 地区：拉丁美洲 · 排程服务对比 · 按场景选择 · 平台限制