Mercado Ads

Mercado Ads is the advertising platform of Mercado Libre, the largest e-commerce and online marketplace in Latin America. The Mercado Ads API provides programmatic access to Brand Ads, Product Ads, and Display advertising campaigns, along with their line items, keywords, creatives, and performance metrics, enabling automated campaign management and reporting.

Power end-to-end data operations for your Mercado Ads API with Nexla. Our bi-directional Mercado Ads connector is purpose-built for Mercado Ads, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Mercado Ads or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Mercado Ads workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

• Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
• Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
• API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
• Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

The Mercado Ads API uses OAuth 2.0 (authorization code, 3-legged flow) built on the Mercado Libre platform. Before creating a credential in Nexla, register an application in the Mercado Libre developers portal to obtain a Client ID (App ID) and Client Secret (Secret Key), and note the authorization and token endpoints your account will use.

To register an application and gather the required values, follow these steps:

1. Sign in to the Mercado Libre Developers portal using the Mercado Libre account that has access to your advertising (Mercado Ads) data. Use the portal for the marketplace site your account belongs to (for example, developers.mercadolibre.com.ar for Argentina, developers.mercadolibre.com.br for Brazil, or developers.mercadolibre.com.mx for Mexico).

2. Open the My applications section and click Create new application to register a new app.

3. Enter the application details, including a name, a short description, and a Redirect URI. The redirect URI must match exactly the callback URL used during authorization, so record the value you enter here.

4. Configure the scopes your integration requires. Mercado Libre supports the read, write, and offline_access scopes; offline_access is needed to obtain a refresh token for long-running, unattended access such as scheduled Nexla flows.

5. After the application is created, copy the App ID (Client ID) and Secret Key (Client Secret) from the application details page. The Secret Key is sensitive and should be stored securely.

6. Note the OAuth endpoints for your marketplace site. The authorization URL follows the format https://auth.mercadolibre.com.ar/authorization (substitute the domain for your site, e.g. .com.br or .com.mx), and the token URL is https://api.mercadolibre.com/oauth/token. All API requests use the base URL https://api.mercadolibre.com.

For complete details on application registration, OAuth 2.0 authorization, and the advertising endpoints, see the Mercado Libre Developers documentation and the Mercado Ads / Advertising API reference.

Authenticate

Credentials required

Field	Required	Secret	Description
Authorization URL	No	No	The URL endpoint where users authenticate and authorize access
Client ID	Yes	Yes	A unique public identifier assigned to your application
Access Scope	No	No	A space-separated list of permissions your application requests
Token URL	No	No	The URL endpoint where authorization codes are exchanged for access tokens
Client Secret	No	Yes	A private key used to authenticate your application when requesting tokens
Base URL	Yes	No	The base URL for the Mercado Ads API.

Create a credential in Nexla

1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

3. Enter the Authorization URL for your marketplace site (for example, https://auth.mercadolibre.com.ar/authorization). This is the endpoint where you authorize Nexla to access your Mercado Ads data.

4. Enter your Client ID (App ID) and Client Secret (Secret Key) from the application you registered in Prerequisites. These values identify and authenticate your application when requesting access tokens.

5. Enter the Token URL (https://api.mercadolibre.com/oauth/token), where authorization codes are exchanged for access tokens.

6. In the Access Scope field, enter the space-separated scopes your integration requires (for example, read write offline_access). Include offline_access so Nexla can refresh the access token for scheduled, unattended flows.

7. In the Base URL field, keep the default https://api.mercadolibre.com unless your account requires a different host.

8. Complete the OAuth authorization prompt to grant Nexla access, then click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

   The Client Secret provides access to your Mercado Ads account and should be treated as sensitive information. If it is compromised, revoke or regenerate it in the Mercado Libre developers portal and update your Nexla credential.

   For detailed information about OAuth 2.0 authorization, token refresh, and the advertising endpoints, see the Mercado Libre Developers documentation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Mercado Ads connector tile, then select the credential that will be used to connect to Mercado Ads, and click Next; or, create a new Mercado Ads credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Mercado Ads endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

[Rest API] List Brand Advertisers

Returns a list of brand advertisers associated with the authenticated account.

• This endpoint requires no additional parameters. It returns the brand advertisers your account can access, and the advertiser IDs it returns are used as inputs for the brand campaign, keyword, and metrics endpoints. Results are paginated automatically.

[Rest API] List Brand Campaigns

Returns a list of brand advertising campaigns for a specific advertiser.

• Provide the Advertiser ID for which to list brand campaigns. Results are paginated automatically.

[Rest API] Get Brand Campaign Metrics

Retrieves performance metrics for a specific brand advertising campaign.

• Provide the Advertiser ID and the Campaign ID for the brand campaign whose metrics you want to retrieve.

[Rest API] List Brand Campaign Items

Returns a list of items included in a specific brand advertising campaign.

• Provide the Advertiser ID and the Campaign ID for the brand campaign whose items you want to list. Results are paginated automatically.

[Rest API] List Brand Campaign Keywords

Returns a list of keywords associated with a specific brand advertising campaign.

• Provide the Advertiser ID and the Campaign ID for the brand campaign whose keywords you want to list. Results are paginated automatically.

[Rest API] Get Brand Keyword Metrics

Retrieves performance metrics for keywords in a specific brand advertising campaign.

• Provide the Advertiser ID and the Campaign ID for the brand campaign whose keyword metrics you want to retrieve.

[Rest API] List Display Campaigns

Returns a list of display advertising campaigns for a specific advertiser.

• Provide the Advertiser ID for which to retrieve display campaigns. Results are paginated automatically.

[Rest API] Get Display Campaign Metrics

Retrieves performance metrics for a specific display advertising campaign.

• Provide the Advertiser ID and the Campaign ID for the display campaign whose metrics you want to retrieve.

[Rest API] List Display Campaign Line Items

Returns a list of line items associated with a specific display advertising campaign.

• Provide the Advertiser ID and the Campaign ID for the display campaign whose line items you want to list. Results are paginated automatically.

[Rest API] Get Display Line Items Metrics

Retrieves performance metrics for display advertising line items.

• Provide the Advertiser ID whose display line item metrics you want to retrieve.

[Rest API] Get Display Creatives

Retrieves creative assets associated with display advertising line items.

• Provide the Advertiser ID, the Campaign ID, and the Line Item ID for the display line item whose creatives you want to retrieve.

[Rest API] List Product Campaigns

Retrieves a list of product advertising campaigns for an advertiser.

• Provide the Advertiser ID for which to retrieve product campaigns. Results are paginated automatically.

[Rest API] Get Product Campaign Metrics

Retrieves performance metrics for product advertising campaigns.

• Provide the Advertiser ID and the Campaign ID for the product campaign whose metrics you want to retrieve.

[Rest API] List Product Items

Retrieves a list of product items included in advertising campaigns for an advertiser.

• Provide the Advertiser ID whose product items you want to list. Results are paginated automatically.

[Rest API] Get Product Item Metrics

Retrieves performance metrics for individual product items in advertising campaigns.

• Provide the Advertiser ID and the Item ID for the product item whose metrics you want to retrieve.

[Rest API] Get Single Product Ads Campaign Metrics

Retrieve performance metrics for a single Product Ads campaign (impressions, clicks, spend, ROAS).

• Provide the Advertiser ID and the Campaign ID for the Product Ads campaign whose metrics you want to retrieve.

[Rest API] Get Display Campaign Line Item Metrics

Retrieve performance metrics broken down at the line-item level for Display campaigns.

• Provide the Advertiser ID, the Campaign ID, and the Line Item ID for the Display line item whose metrics you want to retrieve.

[Rest API] Get Product Ads Campaign Details

Retrieve details of a single Product Ads campaign by ID.

• Provide the Advertiser ID and the Campaign ID for the Product Ads campaign whose details you want to retrieve.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Mercado Ads data sources can also be manually configured to ingest data from any valid Mercado Ads API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Mercado Ads data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.

Use as a destination

Click the + icon on the Nexset that will be sent to the Mercado Ads destination, and select the Send to Destination option from the menu. Select the Mercado Ads connector from the list of available destination connectors, then select the credential that will be used to connect to Mercado Ads, and click Next; or, create a new Mercado Ads credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common Mercado Ads endpoints. Select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.

[Rest API] Create Brand Ads Campaign

Create a new Brand Ads campaign (Automatic or Custom) for an advertiser.

• Provide the Advertiser ID for which the campaign is created. Each record from your Nexset is sent as a JSON request body containing the campaign definition expected by the Mercado Ads API.

[Rest API] Create Product Ads Campaign

Create a new Product Ads campaign (Automatic or Customized mode) for an advertiser.

• Provide the Advertiser ID for which the campaign is created. Each record from your Nexset is sent as a JSON request body containing the campaign definition expected by the Mercado Ads API.

[Rest API] Update Brand Ads Campaign

Update a Brand Ads campaign — status (pause/resume), budget, bid settings.

• Provide the Advertiser ID and the Campaign ID of the Brand Ads campaign to update. Each record from your Nexset is sent as a JSON request body containing the fields to change.

[Rest API] Update Product Ads Campaign

Update an existing Product Ads campaign — budget, status (pause/resume), strategy, ACOS target.

• Provide the Advertiser ID and the Campaign ID of the Product Ads campaign to update. Each record from your Nexset is sent as a JSON request body containing the fields to change.

[Rest API] Add Keywords to Brand Ads Campaign

Add keywords to a Brand Ads Custom campaign.

• Provide the Advertiser ID and the Campaign ID of the Brand Ads Custom campaign. Each record from your Nexset is sent as a JSON request body containing the keyword definitions to add.

[Rest API] Add Items to Product Ads Campaign

Add product listings (items) to a Product Ads campaign.

• Provide the Advertiser ID and the Campaign ID of the Product Ads campaign. Each record from your Nexset is sent as a JSON request body containing the product listings (items) to add.

[Rest API] Remove Item from Product Ads Campaign

Remove a product listing from a Product Ads campaign.

• Provide the Advertiser ID, the Campaign ID, and the Item ID of the product listing to remove from the Product Ads campaign.

[Rest API] Remove Keyword from Brand Ads Campaign

Remove a keyword from a Brand Ads Custom campaign.

• Provide the Advertiser ID, the Campaign ID, and the Keyword ID of the keyword to remove from the Brand Ads Custom campaign.

Manual configuration

Mercado Ads destinations can also be manually configured to send data to any valid Mercado Ads API endpoint. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, data format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks.

Mercado Ads APIs expect JSON format for most operations. For update operations, include the identifier of the object to be updated (such as the campaign ID) at the end of the URL.

Save & activate

Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To send the data to the configured Mercado Ads endpoint, open the destination resource menu, and select Activate.

The Nexset data will not be sent to the Mercado Ads endpoint until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.