Mercado Livre Brazil: search products

Discover public products by search, select relevant results and use their identifiers or URLs for product detail requests.

1 credits per request. Public data only; GeckoAPI is independent of the marketplace.

Try this endpoint

Region, pagination and limitations

Use keyword or a listing URL for search. Pages start at 1. Send the selected product URL to PDP. Optional zipCode supplies shipping context. Prices use BRL; missing stock, seller and shipping fields must remain unknown. This API reads public pages and does not manage seller accounts or orders.

HTTP request

cURL

curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://lista.mercadolivre.com.br/iphone-15-pro-max",
  "target": "mercadolivre.com.br",
  "type": "plp",
  "page": 2
}'

Replace YOUR_API_KEY with your own server-side credential. Read the quickstart for authentication and error handling.

Supported inputs

Field	Requirement	Meaning
url	conditional	Complete public search or product URL. Keep its country and query parameters.
keyword	conditional	Public search term. Use a query appropriate for the selected market.
priceMin	optional	Minimum price filter.
priceMax	optional	Maximum price filter.
powerSeller	optional	Optional source-specific filter; see the request example.
target	required	Source identifier shown in the example.
type	required	plp for search; pdp for product details.
page	optional	Search page number, where supported. See source-specific limits.

Conditional means an alternative input can satisfy the request, such as keyword or search URL. Fields absent from this table are unsupported for this endpoint.

Example response

One possible response, not a guarantee of current price or availability. Product text stays in the source language. Fields may be missing or null; preserve that distinction in your database.

JSON

{
  "requestId": "22222222-1111-4111-8111-222222222222",
  "executionId": "22222222-2222-4222-8222-222222222222",
  "data": {
    "source": "mercadolivre.com.br",
    "type": "plp",
    "url": "https://lista.mercadolivre.com.br/iphone-15-pro-max",
    "requestUrl": "https://lista.mercadolivre.com.br/iphone-15-pro-max",
    "extractedAt": "2026-02-12T12:34:56.000Z",
    "query": "iphone 15 pro max",
    "totalResults": 4832,
    "primaryResults": 1000,
    "page": 2,
    "resultsPerPage": 48,
    "offset": 48,
    "nextPage": 3,
    "nextPageUrl": "https://lista.mercadolivre.com.br/iphone-15-pro-max?_Desde=97",
    "items": [
      {
        "url": "https://www.mercadolivre.com.br/p/MLB3889019023",
        "imageUrl": "https://http2.mlstatic.com/D_Q_NP_2X_654321-MLB3889019023_082026-E.webp",
        "sku": "MLB3889019023",
        "categoryId": "MLB1055",
        "domainId": "MLB-CELLPHONES",
        "name": "Apple iPhone 15 Pro Max 256GB Titanio Natural",
        "condition": "new",
        "currency": "BRL",
        "currencyRaw": "R$",
        "price": 8499,
        "highlight": "MAIS VENDIDO",
        "isBestSeller": true,
        "isPowerSeller": true,
        "powerSellerStatusTitle": "platinum",
        "aggregateRating": {
          "rating": 4.8,
          "reviewCount": 1250
        },
        "ean": "194253952768",
        "sellerId": "123456789",
        "sellerName": "Apple Store Oficial",
        "sellerCity": "Sao Paulo",
        "sellerState": "SP",
        "sellerCountry": "Brasil"
      }
    ]
  }
}

Response fields

Field paths and types

{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "notFound": "boolean (optional; true when the upstream entity was not found and data is null)",
  "data.source": "string",
  "data.type": "string",
  "data.url": "string",
  "data.requestUrl": "string",
  "data.extractedAt": "string (iso datetime)",
  "data.query": "string",
  "data.totalResults": "number",
  "data.primaryResults": "number",
  "data.page": "number",
  "data.resultsPerPage": "number",
  "data.offset": "number",
  "data.nextPage": "number",
  "data.nextPageUrl": "string",
  "data.items[].url": "string",
  "data.items[].imageUrl": "string | null",
  "data.items[].sku": "string",
  "data.items[].categoryId": "string | null",
  "data.items[].domainId": "string | null",
  "data.items[].name": "string",
  "data.items[].condition": "string",
  "data.items[].currency": "string",
  "data.items[].currencyRaw": "string",
  "data.items[].price": "number",
  "data.items[].highlight": "string | null",
  "data.items[].isBestSeller": "boolean",
  "data.items[].isPowerSeller": "boolean",
  "data.items[].powerSellerStatusTitle": "string | null",
  "data.items[].aggregateRating.rating": "number",
  "data.items[].aggregateRating.reviewCount": "number",
  "data.items[].ean": "string",
  "data.items[].sellerId": "string",
  "data.items[].sellerName": "string",
  "data.items[].sellerCity": "string",
  "data.items[].sellerState": "string",
  "data.items[].sellerCountry": "string"
}