Marketplace
No threads yet
Live

search_mercado_livre_deals

lista.mercadolivre.com.br

Searches the Mercado Livre Brazil Ofertas page at https://lista.mercadolivre.com.br and returns current deal listings with prices, discounts, stores, categories, and aggregate price statistics. The optional query filters fetched deals locally by product name.

MarketplaceE-commerce
Parameters2
Runs10
Updated10d ago
Operational10 runs · 100% succeeded
30 days agotoday

Playground

GETsearch_mercado_livre_dealsGETsearch_mercado_livre_lowest_priced_offerGETget_mercado_livre_current_offers

Runs on Notte and spends your workspace credits — what comes back is the live response, not a sample.

What is search_mercado_livre_deals?

Searches the Mercado Livre Brazil Ofertas page at https://lista.mercadolivre.com.br and returns current deal listings with prices, discounts, stores, categories, and aggregate price statistics. The optional query filters fetched deals locally by product name. It runs on Notte's browser infrastructure and returns structured JSON, so you can call it like any other API — pass category_id, query and get the result back without maintaining a scraper.

Response

{
  "query": "<string>",
  "listings": [
    {
      "url": "<string>",
      "tags": [
        "<string>"
      ],
      "brand": "<string>",
      "title": "<string>",
      "rating": 0,
      "currency": "<string>",
      "image_ids": [
        "<string>"
      ],
      "image_urls": [
        "<string>"
      ],
      "listing_id": "<string>",
      "product_id": "<string>",
      "store_name": "<string>",
      "deal_labels": [
        "<string>"
      ],
      "seller_text": "<string>",
      "current_price": 0,
      "free_shipping": true,
      "full_shipping": true,
      "sold_quantity": 0,
      "official_store": true,
      "original_price": 0,
      "promotion_type": "<string>",
      "shipping_texts": [
        "<string>"
      ],
      "source_details": {},
      "variation_text": "<string>",
      "promotion_texts": [
        "<string>"
      ],
      "user_product_id": "<string>",
      "discount_percent": 0,
      "cross_border_trade": true,
      "installment_amount": 0,
      "lightning_deal_end": "<string>",
      "sold_quantity_text": "<string>",
      "installment_currency": "<string>",
      "installments_quantity": 0,
      "installments_no_interest": true,
      "sold_quantity_is_approximate": true
    }
  ],
  "source_url": "<string>",
  "statistics": {
    "average_price": 0,
    "fetched_count": 0,
    "maximum_price": 0,
    "minimum_price": 0,
    "matching_count": 0,
    "source_total_deals": 0
  },
  "category_id": "<string>",
  "category_name": "<string>",
  "available_categories": [
    {
      "id": "<string>",
      "name": "<string>",
      "deal_count": 0
    }
  ]
}

Call it

curl --location 'https://us-prod.notte.cc/functions/7c90966a-7609-4328-a8e5-d77e73da06ff/runs/start' \
--header 'x-notte-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "function_id": "7c90966a-7609-4328-a8e5-d77e73da06ff",
    "variables": {
        "category_id": "",
        "query": ""
    }
}'

Ask an agent

Paste this into Claude Code, Cursor or any MCP client to have an agent call this function for you.

prompt
Use the Anything API MCP server (https://anything.notte.cc/mcp).

Call run(function_id="7c90966a-7609-4328-a8e5-d77e73da06ff") — the "search_mercado_livre_deals" function, which searches the Mercado Livre Brazil Ofertas page at https://lista.mercadolivre.com.br and returns current deal listings with prices, discounts, stores, categories, and aggregate price statistics. The optional query filters fetched deals locally by product name..

It takes category_id (str), query (str). Return the result as structured JSON.