Endpoints de la API de Mercado Libre verificados en vivo, y los que la documentación vieja o los resúmenes de IA inventa

<!-- ESTADO-VIVO:INICIO -->

⚡ ÚLTIMO ESTADO VIVO (Actualizado: 2026-10-29 16:48 · Orden Cronológico Inverso: Más Nuevo Arriba)

• GET /sites/MLA/listing_prices?price=…&category_id=…&listing_type_id=gold_pro — comisiones. sale_fee_details.percentage_fee es el total, y se descompone en meli_percentage_fee (cargo de venta) + financing_add_on_fee (costo de ofrecer cuotas). Para nuestras categorías: 25,3% total = 13,0% de venta + 12,3% de cuotas, más fixed_fee de $1.2...

<!-- ESTADO-VIVO:FIN -->

Verificados en vivo con el token de la cuenta 314922091 (25-ago-2026), no solo leídos en la doc:

• GET /items/{id}/price_to_win?version=v2 — la caja de compra del catálogo. Devuelve status (winning / sharing_first_place / competing / listed), price_to_win, el winner con su precio, boosts[] con status: "opportunity" para lo que ML premia y no le estamos dando, y reason[] cuando no podemos competir. Es el dato competitivo más valioso que expone ML.
• GET /items/visits/time_window?ids=…&last=30&unit=day — visitas por publicación con serie diaria. Funciona con varios ids por llamada.
• GET /users/{id}/items_visits/time_window?last=30&unit=day — visitas totales de la cuenta.
• GET /sites/MLA/listing_prices?price=…&category_id=…&listing_type_id=gold_pro — comisiones. sale_fee_details.percentage_fee es el total, y se descompone en meli_percentage_fee (cargo de venta) + financing_add_on_fee (costo de ofrecer cuotas). Para nuestras categorías: 25,3% total = 13,0% de venta + 12,3% de cuotas, más fixed_fee de $1.250 por unidad. Esta descomposición es la que decide sobre qué base corre el descuento de ml-beneficio-comision.
• GET /users/{id}/items/search?catalog_listing=true&status=active — 519 publicaciones nuestras compiten en catálogo. Con tags=catalog_listing_eligible salen 33 elegibles sin anotar.
• Publicidad v2, con header api-version: 2: /advertising/{SITE}/advertisers/{ADV}/product_ads/campaigns/search, y para el detalle por producto ad_groups/search?filters[item_ids]= seguido de ad_groups/{id}/ads. Los endpoints viejos de Product Ads los dio de baja ML el 27-may-2026 — el 404 no era falta de permiso.

No existen, aunque los afirmen resúmenes de IA o blogs de scrapers:

• /products/{catalog_product_id}/items — para ver competidores solo hay el winner de price_to_win
• /items/{id}/competition, /products/{id}/buy_box_winner (es un campo de /products/{id}, no una ruta)
• /items/{id}/sale_fee, /shipments/{id}/sla
• /inbound-shipments — mandar mercadería a FULL no tiene API: es solo por Seller Center. Por API se ve después, con type=INBOUND_RECEPTION en /stock/fulfillment/operations/search

Cambios de versión que muerden:

• /items/{id}/health se dio de baja el 7-feb; lo reemplaza GET /item/{id}/performance — ojo, item en singular. Devuelve buckets[].variables[].rules[] con status: PENDING y el texto de qué falta (fotos, ficha técnica, GTIN). En publicaciones de catálogo devuelve 400 "Product items are not supported".
• Los reclamos viven en /post-purchase/v1/claims/…; /v1/claims/ está deprecado desde mayo 2024. La mediación no es una API aparte: es stage=dispute.
• Costo de envío: /shipments/{id}/costs → senders[].cost es lo que pagamos nosotros, receiver.cost es lo que pagó el comprador. promoted_amount y save son informativos y la doc dice que no se usen como base de facturación.

Datos/ml-api-endpoints-utiles