Mercado Libre Market Research

Research Mercado Libre categories, products, sales trends, and reviews. Call the Mercado Market Intelligence API via REST or MCP from 10 credits per call.

CostRecent Avg. 25 · Range 10–25 credits / call

Try online

POST · https://api.nexscope.ai/mercado/marketResearchMCP · nexscope_mercado_market_intelligence

Choose an integration method

Product & Market Research

What this API does

Research Mercado categories, product snapshots, sales trends, image matches and reviews through a selected toolName and its arguments. Each operation returns its own data payload. The category-search example contains taxonomy names and codes; it does not demonstrate product demand or forecast future sales.

Mercado Libre Market Research API use cases

Find the category for a research brief

A marketplace analyst selects search_categories with a market_code and query. Category names and codes in the documented example help identify the category to use for a subsequent industry or product search.

Build a product snapshot shortlist

A sourcing analyst selects search_product_snapshots with a keyword or category_id and optional filters. The operation-specific records provide candidates for closer review; response totals and billing indicators do not establish product demand.

Review one product over a chosen period

A marketplace analyst selects product_sales_trend with a sku_id, market_code and days. Its data payload supports a historical product review, without treating the charge indicator or record count as sales evidence.

Mercado Libre Market Research API FAQ

What does the Mercado Libre Market Research API return?

The data payload depends on the selected toolName: category search, industry overview, product snapshots, sales trends, image search or reviews. The category-search example contains records with taxonomy_name and taxonomy_code. The wrapper identifies the operation and record total; charged is billing information. Those wrapper fields do not measure demand, product performance or future sales.

How many credits does the Mercado Libre Market Research API cost?

The current documented cost is Recent Avg. 25 · Range 10–25 credits / call. This is the same cost shown at the top of this page. If a range or estimate is displayed, the final charge depends on the request. Review your available credits and the pricing page before calling the API, and check API usage records for the actual charge.

How do I call the Mercado Libre Market Research API from my app or an MCP client?

Send a POST request to https://api.nexscope.ai/mercado/marketResearch with your API key as a Bearer token and the JSON inputs shown in API integration. In a compatible MCP client such as Claude or Cursor, connect Nexscope and call nexscope_mercado_market_intelligence. Use the MCP arguments shown in the MCP guide, or switch Online test to MCP to review its request before adding it to your app.

View plans and credits Connect this API with MCP

Try this API

Endpoint

https://api.nexscope.ai/mercado/marketResearch

MCP method

nexscope_mercado_market_intelligence

Step 1 of 3 · Authenticate

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Missing or invalid API keys return an authentication error. Manage keys from .

Step 2 of 3 · Send a request

POSThttps://api.nexscope.ai/mercado/marketResearch

Run an API

Send a JSON request body using the parameters described below.

Example request

Replace YOUR_API_KEY, then run this command in your terminal.

curl -X POST 'https://api.nexscope.ai/mercado/marketResearch' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "arguments": {
    "limit": 10,
    "market_code": "MLM",
    "query": "celulares"
  },
  "toolName": "search_categories"
}'

Step 3 of 3 · Inspect the result

Check the response

Read code for the request status and data for the result. Open the parameter and response reference for the full field definitions.

HTTP status codes

Code	Description
200	HTTP request completed. Check JSON code; only 0 indicates business success or acceptance.
400	Request JSON or required API parameters are invalid.
401	API key is missing, invalid, or cannot be matched to a user.
5xx	API execution or upstream service failed.

View parameters & response Try online

All categories/ Product & Market Research

POSThttps://api.nexscope.ai/mercado/marketResearch

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Open tester

Endpoint

Method	`POST`
Path	`https://api.nexscope.ai/mercado/marketResearch`
Auth	`Bearer API key`
Content-Type	`application/json`

Request parameters

toolName: search_categories

Name	Type	Required	Description
`arguments`	`object`	required	Arguments for the selected operation
`arguments.limit`	`integer`	optional	Maximum number of records Default: 100 Minimum: 1 Maximum: 100
`arguments.market_code`	`string`	optional	Mercado market code: MLM, MLB, MLA, MLC, or MCO Allowed: MLM, MLB, MLA, MLC, MCO Default: MLM
`arguments.query`	`string`	optional	Category search query
`toolName`	`string`	required	Mercado research operation Constant: search_categories

toolName: industry_overview

Name	Type	Required	Description
`arguments`	`object`	required	Arguments for the selected operation
`arguments.category_id`	`string`	required	Mercado category ID Minimum length: 1
`arguments.market_code`	`string`	optional	Mercado market code: MLM, MLB, MLA, MLC, or MCO Allowed: MLM, MLB, MLA, MLC, MCO Default: MLM
`toolName`	`string`	required	Mercado research operation Constant: industry_overview

toolName: search_product_snapshots

Name	Type	Required	Description
`arguments`	`object`	required	Arguments for the selected operation
`arguments.category_id`	`string`	optional	Mercado category ID
`arguments.historical_total_sales_max`	`integer`	optional	Historical total sales max value used by this API operation. Minimum: 0
`arguments.historical_total_sales_min`	`integer`	optional	Historical total sales min value used by this API operation. Minimum: 0
`arguments.keyword`	`string`	optional	Product search keyword
`arguments.limit`	`integer`	optional	Maximum number of records Default: 100 Minimum: 1 Maximum: 100
`arguments.listing_date_max`	`string`	optional	Listing date max value used by this API operation. Pattern: ^\d{8}$\|^\d{4}-\d{2}-\d{2}$
`arguments.listing_date_min`	`string`	optional	Listing date min value used by this API operation. Pattern: ^\d{8}$\|^\d{4}-\d{2}-\d{2}$
`arguments.market_code`	`string`	optional	Mercado market code: MLM, MLB, MLA, MLC, or MCO Allowed: MLM, MLB, MLA, MLC, MCO Default: MLM
`arguments.page`	`integer`	optional	Page number, starting at 1 Default: 1 Minimum: 1
`arguments.price_max`	`number`	optional	Price max value used by this API operation. Minimum: 0
`arguments.price_min`	`number`	optional	Price min value used by this API operation. Minimum: 0
`arguments.product_status`	`string \| integer`	optional	Product status value used by this API operation.
`arguments.product_url`	`string`	optional	Mercado product URL Format: uri Pattern: ^https?://
`arguments.rating_max`	`number`	optional	Rating max value used by this API operation. Minimum: 0 Maximum: 5
`arguments.rating_min`	`number`	optional	Rating min value used by this API operation. Minimum: 0 Maximum: 5
`arguments.review_count_max`	`integer`	optional	Review count max value used by this API operation. Minimum: 0
`arguments.review_count_min`	`integer`	optional	Review count min value used by this API operation. Minimum: 0
`arguments.sales_30d_max`	`integer`	optional	Sales 30d max value used by this API operation. Minimum: 0
`arguments.sales_30d_min`	`integer`	optional	Sales 30d min value used by this API operation. Minimum: 0
`arguments.shop_id`	`string`	optional	Mercado shop ID
`arguments.shop_query`	`string`	optional	Shop search query
`arguments.shop_type`	`string`	optional	Shop type value used by this API operation. Allowed: cross_border, local
`arguments.sku_id`	`string`	optional	Mercado product SKU ID
`arguments.sort_by`	`string`	optional	Snapshot result sort field Allowed: sales_30d, historical_total_sales, price, listing_date, rating, review_count, title Default: sales_30d
`arguments.sort_order`	`string`	optional	Sort direction: asc or desc Allowed: asc, desc Default: desc
`arguments.stock_type`	`string`	optional	Stock type value used by this API operation.
`toolName`	`string`	required	Mercado research operation Constant: search_product_snapshots

Any of option 1 — requires keyword

Name	Type	Required	Description
`arguments`	`any`	required	Arguments for the selected operation

Any of option 2 — requires category_id

Name	Type	Required	Description
`arguments`	`any`	required	Arguments for the selected operation

Any of option 3 — requires sku_id

Name	Type	Required	Description
`arguments`	`any`	required	Arguments for the selected operation

Any of option 4 — requires product_url

Name	Type	Required	Description
`arguments`	`any`	required	Arguments for the selected operation

Any of option 5 — requires shop_id

Name	Type	Required	Description
`arguments`	`any`	required	Arguments for the selected operation

Any of option 6 — requires shop_query

Name	Type	Required	Description
`arguments`	`any`	required	Arguments for the selected operation

toolName: product_sales_trend

Name	Type	Required	Description
`arguments`	`object`	required	Arguments for the selected operation
`arguments.days`	`integer`	optional	Sales-trend lookback days Default: 730 Minimum: 1 Maximum: 731
`arguments.market_code`	`string`	optional	Mercado market code: MLM, MLB, MLA, MLC, or MCO Allowed: MLM, MLB, MLA, MLC, MCO Default: MLM
`arguments.sku_id`	`string`	required	Mercado product SKU ID Minimum length: 1
`toolName`	`string`	required	Mercado research operation Constant: product_sales_trend

toolName: image_search_products

Name	Type	Required	Description
`arguments`	`object`	required	Arguments for the selected operation
`arguments.image_base64`	`string`	optional	Base64 image input for image search Minimum length: 1
`arguments.image_url`	`string`	optional	Public image URL for image search Format: uri Pattern: ^https?://
`arguments.limit`	`integer`	optional	Maximum number of records Default: 50 Minimum: 1
`arguments.market_code`	`string`	optional	Mercado market code: MLM, MLB, MLA, MLC, or MCO Allowed: MLM, MLB, MLA, MLC, MCO Default: MLM
`arguments.page`	`integer`	optional	Page number, starting at 1 Default: 1 Minimum: 1
`toolName`	`string`	required	Mercado research operation Constant: image_search_products

Any of option 1 — requires image_url

Name	Type	Required	Description
`arguments`	`any`	required	Arguments for the selected operation

Any of option 2 — requires image_base64

Name	Type	Required	Description
`arguments`	`any`	required	Arguments for the selected operation

toolName: review_search

Name	Type	Required	Description
`arguments`	`object`	required	Arguments for the selected operation
`arguments.limit`	`integer`	optional	Maximum number of records Default: 20 Minimum: 1 Maximum: 100
`arguments.market_code`	`string`	optional	Mercado market code: MLM, MLB, MLA, MLC, or MCO Allowed: MLM, MLB, MLA, MLC, MCO Default: MLM
`arguments.page`	`integer`	optional	Page number, starting at 1 Default: 1 Minimum: 1
`arguments.sku_id`	`string`	required	Mercado product SKU ID Minimum length: 1
`toolName`	`string`	required	Mercado research operation Constant: review_search

Code example

{
  "arguments": {
    "limit": 10,
    "market_code": "MLM",
    "query": "celulares"
  },
  "toolName": "search_categories"
}

Response example

Platform response envelope. code 0 indicates success or acceptance; data contains the business result.

{
  "code": 0,
  "cost": "-1",
  "data": {
    "data": {
      "record_count": 1,
      "records": [
        {
          "taxonomy_code": "MLM1055",
          "taxonomy_name": "Cell Phones"
        }
      ]
    },
    "operation": "search_categories",
    "total": 1
  },
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}

Response fields

Name	Type	Required	Description
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`cost`	`string`	required	Elapsed milliseconds, never credits; -1 outside web requests.
`data`	`any`	required	Data value used by this API operation.
`msg`	`string \| null`	required	Msg value used by this API operation.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`traceId`	`string \| null`	required	Trace id value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.

Any of option 1 — requires operation, data

Name	Type	Required	Description
`data`	`object`	required	Data value used by this API operation.
`data.charged`	`any`	optional	Charged value used by this API operation.
`data.data`	`object`	required	Data value used by this API operation.
`data.operation`	`string`	required	Operation value used by this API operation. Allowed: search_categories, industry_overview, search_product_snapshots, product_sales_trend, image_search_products, review_search
`data.total`	`any`	optional	Total value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.charged`	`boolean`	optional	Charged value used by this API operation.

Any of option 2

Name	Type	Required	Description
`data.charged`	`null`	optional	Charged value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.total`	`integer`	optional	Total value used by this API operation. Minimum: 0

Any of option 2

Name	Type	Required	Description
`data.total`	`null`	optional	Total value used by this API operation.

Any of option 2

Name	Type	Required	Description
`data`	`null`	required	Data value used by this API operation.

Responses

Code	Description
200	HTTP request completed. Check JSON code; only 0 indicates business success or acceptance.
400	Request JSON or required API parameters are invalid.
401	API key is missing, invalid, or cannot be matched to a user.
5xx	API execution or upstream service failed.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

Step 1 of 2 · Connect your MCP client

MCP

V2 recommended

Connect remote agents through the standard MCP 2025-11-25 Streamable HTTP endpoint. Use OAuth 2.1 Authorization Code with PKCE, or an API key for compatibility.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json

Authentication

OAuth clients request the mcp:tools scope. The endpoint's 401 response advertises protected-resource metadata for authorization discovery.

Step 2 of 2 · Call the tool

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_mercado_market_intelligence",
    "arguments": {
      "arguments": {
        "limit": 10,
        "market_code": "MLM",
        "query": "celulares"
      },
      "toolName": "search_categories"
    }
  }
}

Legacy MCP v1

Existing API-key clients can continue using the compatibility endpoint. New integrations should use MCP v2.

GET / POST /mcp/legacy

Online test

Execute the current API with your API key and JSON payload. Online tests use this site's configured API environment; the Endpoint and copyable examples use the public integration address.

At least 10 credits / callAPI usage records

Try it

Send a real request with the same contract shown in the reference.

Endpoint

/mercado/marketResearch

MCP method

nexscope_mercado_market_intelligence

API key*

JSON payload*

cURL

curl -X POST \
  https://api.nexscope.ai/mercado/marketResearch \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "arguments": { "limit": 10, "market_code": "MLM", "query": "celulares" }, "toolName": "search_categories" }'

Response

No response yet. Run the request to see the response here.

Related APIs

Amazon Keyword Intelligence

Explore weekly Amazon Brand Analytics search-term data.