# Mercadolibre Listing Pages Scraper (Keywords)

Scrape basic information (product, product URL, price, price in installments, image URL, etc.) from MercadoLibre by keyword.

- Template page: [https://www.octoparse.com/template/mercadolibre-listados-scraper](https://www.octoparse.com/template/mercadolibre-listados-scraper)
- Categories: E-Commerce
- Status: `PUBLISHED`
- Run mode: `BOTH`

## Pricing

Free.

## 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 7 fields, including `País`, `Palabra_clave`, `Producto`, `Producto_URL`, `Precio`, `Precio_a_plazos`, `Image_URL`.

## 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 Select a Country, Confirm the site, Keywords(Up to 100) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Select a Country

Required. Select a Country Constraints: minLength=1; maxLength=5000. Callable values are the `const` keys in JSON `oneOf`, not the option titles.

### Confirm the site

Required. Confirm the site of MercadoLibre Constraints: minItems=1; maxItems=99; items.minLength=1; items.maxLength=5000; uniqueItems=true. Callable values are the `const` keys in JSON `oneOf`, not the option titles.

### Keywords(Up to 100)

Required. Keywords Constraints: minItems=1; maxItems=100; items.minLength=1; items.maxLength=5000.

### Number of pages

Optional. Number of pages to scrape

## How to Use

# Mercadolibre Listing Pages Scraper (Keywords)

Collects listing/search-result fields from [Mercado Libre](https://http2.mlstatic.com/) by keyword.

## Pricing

No per-line charge.

## Output Fields

- `País`
- `Palabra_clave`
- `Producto`
- `Producto_URL`
- `Precio`
- `Precio_a_plazos`
- `Image_URL`

## Input Parameters

- **Select a Country** (required)
- **Confirm the site** (required): one or more values, one per line
- **Keywords(Up to 100)** (required): one or more values, one per line
- **Number of pages** (optional): enter a number

## How to Use

1. Open the template and select **Try it** or **Start**.
2. Complete the input fields.
3. Run the task locally.
4. Review the output rows and export or process the structured data.

## Data Scope

This template collects listing/search-result fields only. For deeper record data, use a detail-page template.

## Limitations

- Runs locally; keep your computer and Octoparse open while the task is running.
- `Precio`, `Precio_a_plazos`, and `Image_URL` can be empty when the source record does not provide them.

## Tips

- Start with one or a few inputs and review the returned rows before scaling.
- Use the most specific valid **Select a Country** to reduce unrelated or duplicate records.
- Use a stable URL or identifier from the output fields as the deduplication key when available.

## Scheduling and Export

You can schedule recurring local runs and export rows to CSV, Excel, JSON, databases, or cloud storage, or send them to reporting and AI workflows through Octoparse APIs. Scheduling and API access may require a paid Octoparse plan. See the [AgentTools API search templates](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates).

## 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 (by URL)](https://www.octoparse.com/template/mercadolibrelistados-scraper-con-url)
- [Yellow Pages Canada Scraper (Business Listing)](https://www.octoparse.com/template/yellow-pages-canada-scraper-product-listing)
- [Yellow Pages Listing Scraper (Australia)](https://www.octoparse.com/template/yellow-pages-australia-scraper-product-listing)
- [Idealista Listing Pages Scraper](https://www.octoparse.com/template/idealista-listados-scraper)
- [Yellow Pages Spain Scraper(Listing)](https://www.octoparse.com/template/paginas-amarillas-listados-scraper)

## Input Schema

```json
{
  "title": "Mercadolibre Listing Pages Scraper (Keywords) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "select_a_Country": {
      "title": "Select a Country",
      "description": "Select a Country",
      "type": "string",
      "minLength": 1,
      "maxLength": 5000,
      "oneOf": [
        {
          "title": "Argentina",
          "const": "Argentina"
        },
        {
          "title": "Bolivia",
          "const": "Bolivia"
        },
        {
          "title": "Brasil",
          "const": "Brasil"
        },
        {
          "title": "Chile",
          "const": "Chile"
        },
        {
          "title": "Colombia",
          "const": "Colombia"
        },
        {
          "title": "Costa Rica",
          "const": "Costa Rica"
        },
        {
          "title": "Dominicana",
          "const": "Dominicana"
        },
        {
          "title": "Ecuador",
          "const": "Ecuador"
        },
        {
          "title": "Guatemala",
          "const": "Guatemala"
        },
        {
          "title": "Honduras",
          "const": "Honduras"
        },
        {
          "title": "México",
          "const": "México"
        },
        {
          "title": "Nicaragua",
          "const": "Nicaragua"
        },
        {
          "title": "Panamá",
          "const": "Panamá"
        },
        {
          "title": "Paraguay",
          "const": "Paraguay"
        },
        {
          "title": "Perú",
          "const": "Perú"
        },
        {
          "title": "El Salvador",
          "const": "El Salvador"
        },
        {
          "title": "Uruguay",
          "const": "Uruguay"
        },
        {
          "title": "Venezuela",
          "const": "Venezuela"
        }
      ],
      "x-octoparse": {
        "apiEnabled": false
      }
    },
    "confirm_the_site": {
      "title": "Confirm the site",
      "description": "Confirm the site of MercadoLibre",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 5000,
        "oneOf": [
          {
            "title": "Argentina",
            "const": "https://www.mercadolibre.com.ar/#from=homecom"
          },
          {
            "title": "Bolivia",
            "const": "https://www.mercadolibre.com.bo/#from=homecom"
          },
          {
            "title": "Brasil",
            "const": "https://www.mercadolivre.com.br/#from=homecom"
          },
          {
            "title": "Chile",
            "const": "https://www.mercadolibre.cl/#from=homecom"
          },
          {
            "title": "Colombia",
            "const": "https://www.mercadolibre.com.co/#from=homecom"
          },
          {
            "title": "Costa Rica",
            "const": "https://www.mercadolibre.co.cr/#from=homecom"
          },
          {
            "title": "Dominicana",
            "const": "https://www.mercadolibre.com.do/#from=homecom"
          },
          {
            "title": "Ecuador",
            "const": "https://www.mercadolibre.com.ec/#from=homecom"
          },
          {
            "title": "Guatemala",
            "const": "https://www.mercadolibre.com.gt/#from=homecom"
          },
          {
            "title": "Honduras",
            "const": "https://www.mercadolibre.com.hn/#from=homecom"
          },
          {
            "title": "México",
            "const": "https://www.mercadolibre.com.mx/#from=homecom"
          },
          {
            "title": "Nicaragua",
            "const": "https://www.mercadolibre.com.ni/#from=homecom"
          },
          {
            "title": "Panamá",
            "const": "https://www.mercadolibre.com.pa/#from=homecom"
          },
          {
            "title": "Paraguay",
            "const": "https://www.mercadolibre.com.py/#from=homecom"
          },
          {
            "title": "Perú",
            "const": "https://www.mercadolibre.com.pe/#from=homecom"
          },
          {
            "title": "El Salvador",
            "const": "https://www.mercadolibre.com.sv/#from=homecom"
          },
          {
            "title": "Uruguay",
            "const": "https://www.mercadolibre.com.uy/#from=homecom"
          },
          {
            "title": "Venezuela",
            "const": "https://www.mercadolibre.com.ve/#from=homecom"
          }
        ]
      },
      "minItems": 1,
      "maxItems": 99,
      "uniqueItems": true,
      "x-octoparse": {
        "apiEnabled": false
      }
    },
    "keywords": {
      "title": "Keywords(Up to 100)",
      "description": "Keywords",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 5000
      },
      "minItems": 1,
      "maxItems": 100,
      "x-octoparse": {
        "apiEnabled": false
      }
    },
    "number_of_pages": {
      "title": "Number of pages",
      "description": "Number of pages to scrape",
      "type": "integer",
      "x-octoparse": {
        "apiEnabled": false
      }
    }
  },
  "required": [
    "select_a_Country",
    "confirm_the_site",
    "keywords"
  ],
  "allOf": [
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Argentina"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Argentina",
                  "const": "https://www.mercadolibre.com.ar/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Bolivia"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Bolivia",
                  "const": "https://www.mercadolibre.com.bo/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Brasil"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Brasil",
                  "const": "https://www.mercadolivre.com.br/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Chile"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Chile",
                  "const": "https://www.mercadolibre.cl/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Colombia"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Colombia",
                  "const": "https://www.mercadolibre.com.co/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Costa Rica"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Costa Rica",
                  "const": "https://www.mercadolibre.co.cr/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Dominicana"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Dominicana",
                  "const": "https://www.mercadolibre.com.do/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Ecuador"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Ecuador",
                  "const": "https://www.mercadolibre.com.ec/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Guatemala"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Guatemala",
                  "const": "https://www.mercadolibre.com.gt/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Honduras"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Honduras",
                  "const": "https://www.mercadolibre.com.hn/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "México"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "México",
                  "const": "https://www.mercadolibre.com.mx/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Nicaragua"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Nicaragua",
                  "const": "https://www.mercadolibre.com.ni/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Panamá"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Panamá",
                  "const": "https://www.mercadolibre.com.pa/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Paraguay"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Paraguay",
                  "const": "https://www.mercadolibre.com.py/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Perú"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Perú",
                  "const": "https://www.mercadolibre.com.pe/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "El Salvador"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "El Salvador",
                  "const": "https://www.mercadolibre.com.sv/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Uruguay"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Uruguay",
                  "const": "https://www.mercadolibre.com.uy/#from=homecom"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "select_a_Country": {
            "const": "Venezuela"
          }
        },
        "required": [
          "select_a_Country"
        ]
      },
      "then": {
        "properties": {
          "confirm_the_site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Venezuela",
                  "const": "https://www.mercadolibre.com.ve/#from=homecom"
                }
              ]
            }
          }
        }
      }
    }
  ]
}
```

## Input JSON Example

No verified real input/output examples are currently available.


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "País": {
      "type": "string",
      "description": ""
    },
    "Palabra_clave": {
      "type": "string",
      "description": ""
    },
    "Producto": {
      "type": "string",
      "description": ""
    },
    "Producto_URL": {
      "type": "string",
      "description": ""
    },
    "Precio": {
      "type": "string",
      "description": ""
    },
    "Precio_a_plazos": {
      "type": "string",
      "description": ""
    },
    "Image_URL": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Mercadolibre Listing Pages Scraper (Keywords) 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

No verified real input/output examples are currently available.

## 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`.

No verified real input/output examples are currently available.

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `mercadolibre-listados-scraper`, 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/mercadolibre-listados-scraper.json)
- [Manifest](https://www.octoparse.com/templates/mercadolibre-listados-scraper-manifest.json)
