# MercadoLibre Product & Price Intelligence LATAM (`azzarilabs/azzari-shopping-intelligence`) Actor

Compare MercadoLibre listings across LATAM to identify better buying options, compare prices and variants, and rank market opportunities. Includes Product Comparison, Deal Score, Market Analysis, Market Opportunity Score, structured data, and visual reports.

- **URL**: https://apify.com/azzarilabs/azzari-shopping-intelligence.md
- **Developed by:** [Azzari Labs](https://apify.com/azzarilabs) (community)
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$49.00 / 1,000 completed shopping analyses

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## MercadoLibre Product & Market Intelligence LATAM

Compare public MercadoLibre listings for buying decisions or analyze market structure using only observed evidence.

**MercadoLibre Product & Market Intelligence LATAM** analyzes comparable products by variant, capacity, observed price, shipping indicators, and other publicly available evidence. It returns ranked buying options instead of a raw list of links.

Buyer mode produces a reference price, Deal Score, structured Product Comparison dataset, analysis summary, and visual HTML report. Market mode produces observed price dispersion, listing density, seller concentration when visible, evidence coverage, confidence, and an explainable Market Opportunity Score.

### What it does

- Finds public product listings for a specific search.
- Filters accessories and incompatible results.
- Separates product variants before comparing prices.
- Calculates observed reference prices only when sufficient comparable evidence exists.
- Ranks stronger buying options with an explainable Deal Score.
- Highlights unusually high or low prices and results that merit additional review.
- Returns structured data for automation and a visual Product Comparison report.

### LATAM availability

Available markets:

- `GT` — Guatemala · GTQ · Español
- `MX` — México · MXN · Español
- `BR` — Brasil · BRL · Português
- `AR` — Argentina · ARS · Español

Availability is limited to the validated markets listed above.

### Input

The staged input remains intentionally simple.

#### Analysis type

- `buyer` — Product Comparison and Deal Score.
- `market` — Market/Seller Intelligence based on visible public evidence.

#### Product to search

Enter the product as specifically as possible. Examples:

- `iPhone 15 Pro 256GB`
- `PlayStation 5 Slim`
- `Samsung Galaxy S24 Ultra`
- `MacBook Air M3 512GB`

#### Country

Available: `GT`, `MX`, `BR`, and `AR`.

#### Priority

Current option: `best_buy` — Mejor compra.

#### Language

Available options: `es` — Español and `pt` — Português.

#### Maximum results

Choose between 10 and 20 products. The recommended value is 10.

#### Example input

```json
{
  "mode": "buyer",
  "query": "PlayStation 5 Slim",
  "country": "GT",
  "preference": "best_buy",
  "language": "es",
  "maxResults": 10
}
```

Market example:

```json
{
  "mode": "market",
  "query": "iPhone 16 Pro 256 GB",
  "country": "MX",
  "preference": "best_buy",
  "language": "es",
  "maxResults": 10
}
```

### Output

#### Product Comparison Report

A visual HTML report designed for fast review. Depending on the public evidence available, it can include:

- Ranked recommendations
- Deal Score
- Observed reference prices
- Variant-specific comparisons
- Confidence indicators
- Buying cautions
- Public reference links

#### Product Comparison dataset

Structured records for the comparable products evaluated during the run. Existing field names remain unchanged for API compatibility.

Records can include:

- Rank
- Deal Score
- Product title and detected variant
- Observed price and currency
- Reference price and percentage difference
- Shipping and confidence indicators
- Review recommendation
- Public reference URL

#### Analysis summary

The `OUTPUT` JSON can include:

- Search information
- Number of products analyzed
- General observed median price
- Variant summaries
- Best available options
- Possible deals
- Listings recommended for additional review
- Data-quality information

#### Market Intelligence output

Market mode returns a dedicated dataset, `OUTPUT` summary, and `REPORT.html` with minimum, maximum and median prices; dispersion; density; visible seller concentration; public review/sales signals when present; coverage and confidence; and a deterministic Market Opportunity Score from 0 to 100.

Unavailable seller, review, or sales fields remain `null` and reduce confidence. They are never inferred.

### How the comparison works

The Actor does not automatically choose the cheapest listing.

It first checks whether results are genuinely comparable. Different capacities, versions, bundles, accessories, or product families are not treated as equivalent by default.

When enough comparable results exist, reference prices are calculated within the corresponding product variant. When evidence is limited, the confidence level is reduced rather than presenting unsupported certainty.

### Deal Score

The **Deal Score** is a run-specific decision-support indicator based exclusively on public signals available during the analysis.

A higher score means that a listing appears stronger relative to the other comparable results found in that run. It is not a guarantee of seller reliability, product authenticity, inventory, delivery, or future price.

### Data integrity and limitations

- The Actor does not invent unavailable prices, seller information, reviews, stock, or delivery conditions.
- Marketplace information can change after a report is generated.
- Some results expose only a public search or catalog reference instead of a confirmed individual product page.
- Information that cannot be confirmed from the available public evidence is not treated as verified.
- Review the marketplace publication before completing a purchase.

### Privacy and independence

The Actor analyzes publicly available marketplace information and does not require the user's marketplace login credentials.

It is an independent product and is not affiliated with, endorsed by, sponsored by, or officially connected to MercadoLibre. Marketplace names and trademarks belong to their respective owners.

# Actor input Schema

## `mode` (type: `string`):

Compara opciones de compra o analiza el mercado y sus señales públicas.

## `query` (type: `string`):

Escribe el producto con el mayor detalle posible, por ejemplo: iPhone 15 Pro 256GB o PlayStation 5 Slim.

## `country` (type: `string`):

Mercado regional que se analizará.

## `preference` (type: `string`):

Criterio principal utilizado para ordenar las recomendaciones.

## `language` (type: `string`):

Idioma del análisis y del reporte.

## `maxResults` (type: `integer`):

Número máximo de productos que se analizarán. Recomendado: 10.

## Actor input object example

```json
{
  "mode": "buyer",
  "query": "PlayStation 5 Slim",
  "country": "GT",
  "preference": "best_buy",
  "language": "es",
  "maxResults": 10
}
```

# Actor output Schema

## `report` (type: `string`):

Reporte Product Comparison o Market Intelligence según el modo solicitado.

## `results` (type: `string`):

Dataset Buyer o Market con datos públicos observados.

## `summary` (type: `string`):

Resumen JSON con recomendaciones Buyer o métricas Market, referencias y calidad de evidencia.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("azzarilabs/azzari-shopping-intelligence").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("azzarilabs/azzari-shopping-intelligence").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call azzarilabs/azzari-shopping-intelligence --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,azzarilabs/azzari-shopping-intelligence"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/newwAQ3oTFe3CoNwr/builds/eiR1p4EmUQhPAemKX/openapi.json