Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.
circulos azuis em degrade

Documentation

Last update 05/05/2026
FAQs Rate limit / 429 Error

Rate limit / 429 Error


What should I do when the API returns 429 Too Many Requests?

429 indicates too many requests in a short period. Implement backoff and retries (pauses with jitter), distribute requests (avoid spikes), consume the scroll completely before it expires, and ensure there are no massive retries. For bulk operations, use prudent batching and avoid extreme concurrency.

Recommendation
Apply exponential backoff with jitter, reduce concurrency, and consolidate calls to minimize the likelihood of 429 errors.
Does the visits API or image diagnostics API support large multiget or bulk requests without triggering 429?

Many APIs do not support wide multiget; for example, items/visits only accepts one product_id per query. If you need to reduce calls, design batching, use intervals, and limit RPM; for image diagnostics there is no official multiget, so limit the rate and only consider bulk requests if the endpoint supports it.

Recommendation
Respect each endpoint's limitations, implement controlled batching, and space out requests when the endpoint does not support multiget.
Is the rate limit applied per IP, per Client ID, or per user?

The main control is applied per Client ID (application) in most cases and per endpoint; payload size is not factored into the limit calculation. It is recommended to distribute application consumption and request quota increases for legitimate high-volume cases through the appropriate channels.

Recommendation
Monitor consumption per Client ID and request quota increases with usage evidence if you need higher RPM.
Why do I get 429 when using scroll_id in searches and how can I avoid it?

The scroll expires (limited time) and repeated consumption or leaving it open too long generates 429 (over quota). Consume the scroll pages within the validity window, reduce concurrency, and add backoff and retries with jitter to avoid spikes.

Recommendation
Process the scroll continuously within its lifetime and reduce concurrent calls to avoid expirations and 429 errors.
Can I combine offset/limit with scroll_id in the same request?

No. Using scroll_id together with offset/limit or incompatible parameters will cause errors. Use the appropriate pagination method for each endpoint and respect the chosen mechanism (scroll or offset).

Recommendation
Do not mix pagination mechanisms; choose scroll or offset according to the API and adjust your implementation accordingly.
Is there a way to request an RPM increase for stock endpoints?

For high-volume needs, contact the commercial integrations team with usage evidence; in the meantime, optimize calls (batching, consolidation by user_product) to reduce RPM and avoid blocks.

Recommendation
Optimize calls and consolidate operations by user_product while managing the quota increase request with the commercial team.