docs / mercadolibre

Mercado Libre

Latin-American marketplace products and prices.

base /mercadolibre/v13 endpoints

post/mercadolibre/v1/search/ofertas1 credit

search products/deals

Parameter	Required
query	required
max_pages	optional
stop_on_empty	optional

Try in playground →

post/mercadolibre/v1/search/suggest1 credit

search-term autosuggest

Parameter	Required
query	required

Try in playground →

post/mercadolibre/v1/category/browse1 credit

category tree + children + metadata

Parameter	Required
category_id	required

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
}