Documentation Mercado Libre
Check out all the necessary information about APIs Mercado Libre.
Documentation
Last update 05/05/2026
Images and moderation
Why do some images return a 403 error or remain "pending" in the API when publishing?
A 403 generally indicates that the server hosting the image is blocking access (firewall, IP whitelist) or the URL is not accessible to the platform; additionally, in listings associated with the catalog, images may be managed by the catalog and not be modifiable via API.
Recommendation
Ensure image URLs are publicly accessible by the platform and that the host allows the required IPs; if the image belongs to the catalog, review catalog management.
Does the API support images in WebP format or should I use JPG/PNG?
The system processes multiple formats (JPG, PNG, WebP, GIF). Mercado Libre may optimize and serve images in WebP, so the appearance of .webp in the pictures array is expected and does not require changes to the integration.
Recommendation
You can submit JPG/PNG normally; the system may convert or serve WebP internally, so it is not necessary to replace current formats.
How to avoid 429 errors when using the image diagnostics endpoint?
Avoid call spikes and distribute requests; there is no public bulk mode in all cases, so rate limits must be managed with exponential backoff, batching, and request optimization to avoid saturating the endpoint.
Recommendation
Group diagnostics in batches when possible, space out calls, and apply backoff with jitter to minimize 429 errors.