Mercado Libre

Written by Ilya Sudakov

Updated on Oct 21, 2026

Description

Mercado Libre operates online marketplaces dedicated to e-commerce and online auctions.

Setup guide

Follow our setup guide to connect Mercado Libre to Improvado.

To authorize your account, you need to fill in the required fields below, following steps 1.1 - 1.8:

Country
Client ID
Client Secret

Create an application on Mercado Libre by following the official guide.

Important: Make sure to grant the following permissions:

read (to read data)
offline_access (to receive a refresh token and keep access without re-login)

Important: When creating the application, you must set the Redirect URI to the Improvado callback URL. Use the URL that matches your Improvado account region, and add all three if Mercado Libre lets you register more than one. Enter each value exactly, including https:// and the trailing slash:

Default: https://connections.improvado.io/stat_provider_client/oauth_redirect/mercadolibre/
EU: https://connections.eu.improvado.io/stat_provider_client/oauth_redirect/mercadolibre/
US: https://connections.us.improvado.io/stat_provider_client/oauth_redirect/mercadolibre/

Mercado Libre rejects the authorization if the Redirect URI does not match exactly. If you are unsure which region applies to your account, contact Improvado support.

Note: Improvado uses PKCE (Proof Key for Code Exchange) with the S256 method for the Mercado Libre OAuth flow. This is handled automatically by Improvado, so you do not need to configure anything for PKCE when creating your application.

Copy Client ID and Client Secret values from the Application settings page.

Enter the copied values into the Improvado authorization form.

Select the country where you registered your application.

Click Authorize button

Authorize Mercado Libre account via OAuth.

In the final step of the OAuth process, copy the Code and paste it into the corresponding field in the Improvado authorization form.

Click Create connection button

After completing the connection process, the Mercado Libre connection will appear in your Connected sources list.

‍Step 3. When the connection status is Active, and the account status column shows a number of accounts, you can move on to data extraction.

To extract data from the connected sources, check the instructions on how to set up data extraction.

For the Catalog Products report, fill in the report settings Brands (brand names, for example Raid), GTINs (product barcodes in UPC, EAN or GTIN-14 format, 8 to 14 digits), or both. Optionally pick a Site; when left empty, the country of the connection is used. This report reads the public Mercado Libre catalog, so it needs no seller account and works for any brand.

Schema information

The schema information shows all report types you can use to extract data from Mercado Libre.

Limits

The Catalog Products report:

Searches the catalog of one Mercado Libre site per extraction. Add one extraction per country you need.
Skips a brand with no catalog products and still loads the others. A barcode with no match returns no row.
Shows a product found by both a brand and a barcode once.
Replaces the previous data on every run, so a product that leaves the catalog, or no longer matches your settings, drops out.

Release notes

You can find information about the latest API changes in the official Release notes.

Was this article helpful?

Questions? The Improvado team is always happy to help. Send us an email, contact your Customer Success Manager, or raise a request in the Improvado Service Desk.