# MercadoLibre Listing Pages Scraper (by URL)

Scrape product details from MercadoLibre by using a search result page URL.

- Template page: [https://www.octoparse.com/template/mercadolibrelistados-scraper-con-url](https://www.octoparse.com/template/mercadolibrelistados-scraper-con-url)
- Categories: E-Commerce
- Status: `PUBLISHED`
- Run mode: `CLOUD`

## Pricing

Current price: **$1/1,000 lines**. Billing is based on output rows; an Octoparse subscription may be required.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from listing pages.

## Output

The current workflow extracts 12 fields, including `Descuento`, `Detalle_cuotas`, `Fecha_Hora`, `Fuente`, `Image_URL`, `Listado_URL`, `Medidas`, `Plazas_titulo`, `Precio`, `Precio_sin_descuento`, `Producto_URL`, `Titulo`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete urls, PageSize and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### urls

Required. MainKeys

### PageSize

Optional. PageSize Constraints: minimum=, maximum=10000.

## How to Use

# MercadoLibre Listing Pages Scraper (by URL)

## What It Collects
Collects product titles, product URLs, current and original prices, discounts, image URLs, installment details, listing attributes, source pages, and timestamps from Mercado Libre listing-page URLs.

## Pricing
$1 per 1,000 output lines.

## Input
- **urls** (required): One or more Mercado Libre listing-page URLs, one per line.
- **PageSize** (optional): A number up to 10,000 to limit result pages.

## How to Use
1. Open the template and select **Try it** or **Start**.
2. Complete the input fields.
3. Run the task in the cloud.
4. Review the output rows and export or process the structured data.

## Output Fields
The template returns: `Listado_URL`, `Producto_URL`, `Titulo`, `Precio`, `Image_URL`, `Descuento`, `Precio_sin_descuento`, `Medidas`, `Plazas_titulo`, `Detalle_cuotas`, `Fuente`, `Fecha_Hora`.

## Limitations
- Collects only fields displayed on the submitted listing pages; does not crawl full product-detail specifications.
- Discount, original-price, installment, image, or attribute fields may be empty when not exposed on the listing card.
- PageSize must be 10,000 or fewer.
- Layouts, currencies, result ordering, and offer text differ across Mercado Libre country sites and can change over time.

## Tips
- Keep listing URLs from different country sites in separate tasks.
- Start with a smaller PageSize to validate the page type and returned fields.
- Use `Producto_URL` and `Fecha_Hora` together when tracking repeated offers over time.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [Mercadolibre Listing Pages Scraper (Keywords)](https://www.octoparse.com/template/mercadolibre-listados-scraper)
- [Zillow Listing Scraper (by URL)](https://www.octoparse.com/template/zillow-scraper)
- [Falabella Retail Listing Scraper(by URL)](https://www.octoparse.com/template/falabella-retail-listados-scraper-url)
- [Seek Listing Scraper (by URL)](https://www.octoparse.com/template/seek-listing-scraper)
- [eBay Listing Page Scraper (by keyword)](https://www.octoparse.com/template/ebay-product-list-scraper-by-keyword)

## Input Schema

```json
{
  "title": "MercadoLibre Listing Pages Scraper (by URL) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "urls": {
      "title": "urls",
      "description": "MainKeys",
      "type": "array",
      "items": {
        "type": "string"
      },
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "pageSize": {
      "title": "PageSize",
      "description": "PageSize",
      "type": "integer",
      "maximum": 10000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "urls"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "pageSize": 10.0,
  "urls": [
    "https://listado.mercadolibre.com.mx/cajas-sorpresa#D[A:cajas%20sorpresa]",
    "https://listado.mercadolibre.com.mx/zapato#D[A:zapato]",
    "https://articulo.mercadolibre.com.mx/MLM-2732202260-zapatos-de-vestir-elegrant-oxford-bruno-marc-hombre-negocios-_JM?searchVariation=180924554167#is_advertising=true&searchVariation=180924554167&backend_model=search-backend&be_origin=backend&position=1&search_layout=grid&type=pad&tracking_id=a45b7985-56b6-41c1-87a9-178bbc8c8eb1&ad_domain=VQCATCORE_LST&ad_position=1&ad_click_id=YTVkYmNiN2YtMzcyMC00YjRhLWEyYjEtYzYzMTUyMDI0Mzkx"
  ]
}
```

Example 2

```json
{
  "pageSize": 10.0,
  "urls": [
    "https://listado.mercadolibre.com.mx/cajas-sorpresa#D[A:cajas%20sorpresa]",
    "https://listado.mercadolibre.com.mx/zapato#D[A:zapato]",
    "https://articulo.mercadolibre.com.mx/MLM-2732202260-zapatos-de-vestir-elegrant-oxford-bruno-marc-hombre-negocios-_JM?searchVariation=180924554167#is_advertising=true&searchVariation=180924554167&backend_model=search-backend&be_origin=backend&position=1&search_layout=grid&type=pad&tracking_id=a45b7985-56b6-41c1-87a9-178bbc8c8eb1&ad_domain=VQCATCORE_LST&ad_position=1&ad_click_id=YTVkYmNiN2YtMzcyMC00YjRhLWEyYjEtYzYzMTUyMDI0Mzkx"
  ]
}
```

Example 3

```json
{
  "pageSize": 10.0,
  "urls": [
    "https://listado.mercadolibre.com.mx/cajas-sorpresa#D[A:cajas%20sorpresa]",
    "https://listado.mercadolibre.com.mx/zapato#D[A:zapato]",
    "https://articulo.mercadolibre.com.mx/MLM-2732202260-zapatos-de-vestir-elegrant-oxford-bruno-marc-hombre-negocios-_JM?searchVariation=180924554167#is_advertising=true&searchVariation=180924554167&backend_model=search-backend&be_origin=backend&position=1&search_layout=grid&type=pad&tracking_id=a45b7985-56b6-41c1-87a9-178bbc8c8eb1&ad_domain=VQCATCORE_LST&ad_position=1&ad_click_id=YTVkYmNiN2YtMzcyMC00YjRhLWEyYjEtYzYzMTUyMDI0Mzkx"
  ]
}
```

Example 4

```json
{
  "pageSize": 10.0,
  "urls": [
    "https://listado.mercadolibre.com.mx/cajas-sorpresa#D[A:cajas%20sorpresa]",
    "https://listado.mercadolibre.com.mx/zapato#D[A:zapato]",
    "https://articulo.mercadolibre.com.mx/MLM-2732202260-zapatos-de-vestir-elegrant-oxford-bruno-marc-hombre-negocios-_JM?searchVariation=180924554167#is_advertising=true&searchVariation=180924554167&backend_model=search-backend&be_origin=backend&position=1&search_layout=grid&type=pad&tracking_id=a45b7985-56b6-41c1-87a9-178bbc8c8eb1&ad_domain=VQCATCORE_LST&ad_position=1&ad_click_id=YTVkYmNiN2YtMzcyMC00YjRhLWEyYjEtYzYzMTUyMDI0Mzkx"
  ]
}
```

Example 5

```json
{
  "pageSize": 10.0,
  "urls": [
    "https://listado.mercadolibre.com.mx/cajas-sorpresa#D[A:cajas%20sorpresa]",
    "https://listado.mercadolibre.com.mx/zapato#D[A:zapato]",
    "https://articulo.mercadolibre.com.mx/MLM-2732202260-zapatos-de-vestir-elegrant-oxford-bruno-marc-hombre-negocios-_JM?searchVariation=180924554167#is_advertising=true&searchVariation=180924554167&backend_model=search-backend&be_origin=backend&position=1&search_layout=grid&type=pad&tracking_id=a45b7985-56b6-41c1-87a9-178bbc8c8eb1&ad_domain=VQCATCORE_LST&ad_position=1&ad_click_id=YTVkYmNiN2YtMzcyMC00YjRhLWEyYjEtYzYzMTUyMDI0Mzkx"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Descuento": {
      "type": "string",
      "description": ""
    },
    "Detalle_cuotas": {
      "type": "string",
      "description": ""
    },
    "Fecha_Hora": {
      "type": "string",
      "description": ""
    },
    "Fuente": {
      "type": "string",
      "description": ""
    },
    "Image_URL": {
      "type": "string",
      "description": ""
    },
    "Listado_URL": {
      "type": "string",
      "description": ""
    },
    "Medidas": {
      "type": "string",
      "description": ""
    },
    "Plazas_titulo": {
      "type": "string",
      "description": ""
    },
    "Precio": {
      "type": "string",
      "description": ""
    },
    "Precio_sin_descuento": {
      "type": "string",
      "description": ""
    },
    "Producto_URL": {
      "type": "string",
      "description": ""
    },
    "Titulo": {
      "type": "string",
      "description": ""
    }
  },
  "title": "MercadoLibre Listing Pages Scraper (by URL) output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "Descuento": "",
  "Detalle_cuotas": "3 meses sin intereses de $ 73 . 56",
  "Fecha_Hora": "2026-11-12 01:52:37",
  "Fuente": "Genérica",
  "Image_URL": "https://http2.mlstatic.com/D_NQ_NP_2X_982879-MLM105496110529_012026-F.webp | https://http2.mlstatic.com/D_NQ_NP_900156-MLA111255596165_052026-F.jpg | https://http2.mlstatic.com/D_NQ_NP_2X_737230-MLM105496230333_012026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_790265-MLM105496230361_012026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_620700-MLM105496260327_012026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_825861-MLM105495990979_012026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_665017-MLM105495960967_012026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_786943-MLM105498175261_012026-F.webp",
  "Listado_URL": "https://listado.mercadolibre.com.mx/zapato",
  "Medidas": "",
  "Plazas_titulo": "",
  "Precio": "$ 220",
  "Precio_sin_descuento": "$ 288",
  "Producto_URL": "https://www.mercadolibre.com.mx/zapatos-casual-de-piel-para-hombre-en-color-negro-comodos/up/MLMU3743046135?pdp_filters=item_id:MLM4695730624",
  "Titulo": "Zapatos Casual De Piel Para Hombre En Color Negro Cómodos"
}
```

Example 2

```json
{
  "Descuento": "",
  "Detalle_cuotas": "3 meses sin intereses de $ 62 . 70",
  "Fecha_Hora": "2026-11-12 01:49:50",
  "Fuente": "FCBOX",
  "Image_URL": "https://http2.mlstatic.com/D_NQ_NP_2X_981637-MLM111921766818_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_751236-MLM111921766822_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_981566-MLM113043193143_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_741003-MLM111920232024_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_758522-MLM111921766824_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_720231-MLM111920935252_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_660196-MLM111920730154_062026-F.webp",
  "Listado_URL": "https://listado.mercadolibre.com.mx/cajas-sorpresa",
  "Medidas": "",
  "Plazas_titulo": "",
  "Precio": "$ 188",
  "Precio_sin_descuento": "$ 198",
  "Producto_URL": "https://www.mercadolibre.com.mx/6-guerreras-kpop-demon-hunters-munecos-y-figuras-personajes/p/MLM2051237566?pdp_filters=item_id:MLM5485129570",
  "Titulo": "6 Guerreras Kpop Demon Hunters Muñecos Y Figuras Personajes"
}
```

Example 3

```json
{
  "Descuento": "",
  "Detalle_cuotas": "3 meses sin intereses de $ 62 . 70",
  "Fecha_Hora": "2026-11-12 01:47:34",
  "Fuente": "FCBOX",
  "Image_URL": "https://http2.mlstatic.com/D_NQ_NP_2X_981637-MLM111921766818_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_751236-MLM111921766822_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_981566-MLM113043193143_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_741003-MLM111920232024_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_758522-MLM111921766824_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_720231-MLM111920935252_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_660196-MLM111920730154_062026-F.webp",
  "Listado_URL": "https://listado.mercadolibre.com.mx/cajas-sorpresa",
  "Medidas": "",
  "Plazas_titulo": "",
  "Precio": "$ 188",
  "Precio_sin_descuento": "$ 198",
  "Producto_URL": "https://www.mercadolibre.com.mx/6-guerreras-kpop-demon-hunters-munecos-y-figuras-personajes/p/MLM2051237566?pdp_filters=item_id:MLM5485129570",
  "Titulo": "6 Guerreras Kpop Demon Hunters Muñecos Y Figuras Personajes"
}
```

Example 4

```json
{
  "Descuento": "",
  "Detalle_cuotas": "3 meses sin intereses de $ 62 . 70",
  "Fecha_Hora": "2026-11-11 18:26:08",
  "Fuente": "FCBOX",
  "Image_URL": "https://http2.mlstatic.com/D_NQ_NP_2X_981637-MLM111921766818_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_751236-MLM111921766822_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_981566-MLM113043193143_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_741003-MLM111920232024_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_758522-MLM111921766824_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_720231-MLM111920935252_062026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_660196-MLM111920730154_062026-F.webp",
  "Listado_URL": "https://listado.mercadolibre.com.mx/cajas-sorpresa",
  "Medidas": "",
  "Plazas_titulo": "",
  "Precio": "$ 188",
  "Precio_sin_descuento": "$ 198",
  "Producto_URL": "https://www.mercadolibre.com.mx/6-guerreras-kpop-demon-hunters-munecos-y-figuras-personajes/p/MLM2051237566?pdp_filters=item_id:MLM5485129570",
  "Titulo": "6 Guerreras Kpop Demon Hunters Muñecos Y Figuras Personajes"
}
```

Example 5

```json
{
  "Descuento": "",
  "Detalle_cuotas": "24 meses de $ 17 . 17",
  "Fecha_Hora": "2026-11-11 13:47:23",
  "Fuente": "Genérica",
  "Image_URL": "https://http2.mlstatic.com/D_NQ_NP_2X_767324-MLM114345430993_072026-F.webp | https://http2.mlstatic.com/D_NQ_NP_658997-MLA89313384794_082025-F.jpg | https://http2.mlstatic.com/D_NQ_NP_2X_945383-MLM89311149504_082025-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_941173-MLM106869623891_022026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_898680-MLM106869623893_022026-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_704899-MLM89677569121_082025-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_869064-MLM89311030132_082025-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_898224-MLM89676872959_082025-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_885542-MLM89677569301_082025-F.webp | https://http2.mlstatic.com/D_NQ_NP_2X_826095-MLM89677341201_082025-F.webp",
  "Listado_URL": "https://listado.mercadolibre.com.mx/zapato",
  "Medidas": "",
  "Plazas_titulo": "",
  "Precio": "$ 284",
  "Precio_sin_descuento": "$ 350",
  "Producto_URL": "https://www.mercadolibre.com.mx/surf-climbing-playa-agua-zapatos-de-vadeo-antideslizante/up/MLMU3346212955?pdp_filters=item_id:MLM6211691074",
  "Titulo": "Surf Climbing Playa Agua Zapatos De Vadeo Antideslizante"
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "mercadolibrelistados-scraper-con-url",
  "taskName": "MercadoLibre Listing Pages Scraper (by URL)",
  "parameters": "{\"pageSize\":10.0,\"urls\":[\"https://listado.mercadolibre.com.mx/cajas-sorpresa#D[A:cajas%20sorpresa]\",\"https://listado.mercadolibre.com.mx/zapato#D[A:zapato]\",\"https://articulo.mercadolibre.com.mx/MLM-2732202260-zapatos-de-vestir-elegrant-oxford-bruno-marc-hombre-negocios-_JM?searchVariation=180924554167#is_advertising=true&searchVariation=180924554167&backend_model=search-backend&be_origin=backend&position=1&search_layout=grid&type=pad&tracking_id=a45b7985-56b6-41c1-87a9-178bbc8c8eb1&ad_domain=VQCATCORE_LST&ad_position=1&ad_click_id=YTVkYmNiN2YtMzcyMC00YjRhLWEyYjEtYzYzMTUyMDI0Mzkx\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"pageSize\":10.0,\"urls\":[\"https://listado.mercadolibre.com.mx/cajas-sorpresa#D[A:cajas%20sorpresa]\",\"https://listado.mercadolibre.com.mx/zapato#D[A:zapato]\",\"https://articulo.mercadolibre.com.mx/MLM-2732202260-zapatos-de-vestir-elegrant-oxford-bruno-marc-hombre-negocios-_JM?searchVariation=180924554167#is_advertising=true&searchVariation=180924554167&backend_model=search-backend&be_origin=backend&position=1&search_layout=grid&type=pad&tracking_id=a45b7985-56b6-41c1-87a9-178bbc8c8eb1&ad_domain=VQCATCORE_LST&ad_position=1&ad_click_id=YTVkYmNiN2YtMzcyMC00YjRhLWEyYjEtYzYzMTUyMDI0Mzkx\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "mercadolibrelistados-scraper-con-url",
        "taskName": "MercadoLibre Listing Pages Scraper (by URL)",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "mercadolibrelistados-scraper-con-url",
  "taskName": "MercadoLibre Listing Pages Scraper (by URL)",
  "parameters": "{\"pageSize\":10.0,\"urls\":[\"https://listado.mercadolibre.com.mx/cajas-sorpresa#D[A:cajas%20sorpresa]\",\"https://listado.mercadolibre.com.mx/zapato#D[A:zapato]\",\"https://articulo.mercadolibre.com.mx/MLM-2732202260-zapatos-de-vestir-elegrant-oxford-bruno-marc-hombre-negocios-_JM?searchVariation=180924554167#is_advertising=true&searchVariation=180924554167&backend_model=search-backend&be_origin=backend&position=1&search_layout=grid&type=pad&tracking_id=a45b7985-56b6-41c1-87a9-178bbc8c8eb1&ad_domain=VQCATCORE_LST&ad_position=1&ad_click_id=YTVkYmNiN2YtMzcyMC00YjRhLWEyYjEtYzYzMTUyMDI0Mzkx\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `mercadolibrelistados-scraper-con-url`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/mercadolibrelistados-scraper-con-url.json)
- [Manifest](https://www.octoparse.com/templates/mercadolibrelistados-scraper-con-url-manifest.json)
