docs / mercadolibre

Mercado Libre

Latin-American marketplace products and prices.

base /mercadolibre/v13 endpoints

post/mercadolibre/v1/search/ofertas1 credit

Search MercadoLibre Brazil products and deals — returns ranked listing cards with price in BRL, seller label, and review summary across multiple pages

Parameter		Allowed / range	Description
query	required	—	What to search for (product keywords, Portuguese works best — Brazil site).
max_pages = 3	optional	1–10	How many result pages to fetch + merge in one call (1–10, ~48 items/page).
stop_on_empty = true	optional	—	Stop early when a page returns no items (leave on — saves time).

Try in playground →

post/mercadolibre/v1/search/suggest1 credit

search-term autosuggest

Parameter		Allowed / range	Description
query	required	—	Partial search text to complete.

Try in playground →

post/mercadolibre/v1/category/browse1 credit

Browse the MercadoLibre Brazil category tree — returns a category's name, total item count, full path from root, and its direct child subcategories. Use search/ofertas to retrieve products within a category.

Parameter		Allowed / range	Description
category_id	required	—	MercadoLibre Brazil category ID (always starts with MLB). Drill down via this same action's children[].id; MLB1051 = Celulares e Telefones.

Try in playground →

Example request · search/ofertas

curl -X POST https://api.reefapi.com/mercadolibre/v1/search/ofertas \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"notebook","max_pages":2}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}