# Mercadolibre Email Scraper (`scraper-mind/mercadolibre-email-scraper`)

The Mercadolibre Email Scraper lets you efficiently extract Mercadolibre email addresses from regional listings. Ideal for lead generation, market research, and targeted marketing campaigns, it supports keyword and location filtering, custom domains, and proxies for smooth data collection.

- **URL**: https://beta-securitybyobscurity.apify.com/scraper-mind/mercadolibre-email-scraper.md
- **Developed by:** [Scraper Mind](https://beta-securitybyobscurity.apify.com/scraper-mind) (community)
- **Categories:** Lead generation, E-commerce, Automation
- **Stats:** 16 total users, 4 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$5.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.
You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

# README

### Mercadolibre Email Scraper 📧

The **Mercadolibre email scraper** is a powerful tool designed to effortlessly **scrape Mercadolibre email** addresses using specific keywords. Whether you're conducting market research, building an email list, or gathering contact information for outreach campaigns, this scraper provides fast, reliable, and accurate results from Mercadolibre's various regional platforms.

***

#### Key Features

- **Keyword-Based Search:** Input one or multiple keywords (e.g., "handbag", "wallet") to help the **Mercadolibre email scraper** find relevant product listings and extract associated email addresses.
- **Location Filtering:** Customize your search results by filtering them by location to ensure you're **scraping Mercadolibre email** addresses from a specific region or country.
- **Platform Selection:** Choose from Mercadolibre's multiple regional platforms, including Argentina, Brazil, Mexico, and many more, to tailor your search and data extraction.
- **Custom Email Domains:** Add custom email domains to the list or use the default `@gmail.com` domain for flexibility in targeting email addresses.
- **Proxy Configuration:** For better performance and to avoid rate-limiting, configure proxies to ensure smooth scraping when running the **Mercadolibre email scraper**.

***

#### Input

The actor accepts a JSON object with the following input parameters. These settings allow you to customize the **Mercadolibre email scraper** to meet your specific scraping needs.

- **keywords:**\
  A list of keywords (e.g., `["handbag", "wallet"]`) to search for on Mercadolibre listings and extract relevant email addresses.

- **location:**\
  Optionally filter search results by location to only retrieve **Mercadolibre email** addresses from a specific region or country.

- **mercadolibreSite:**\
  Select which Mercadolibre site to scrape from:
  - Mercadolibre Argentina (mercadolibre.com.ar)
  - Mercadolibre Bolivia (mercadolibre.com.bo)
  - Mercadolibre Brazil (mercadolivre.com.br)
  - Mercadolibre Chile (mercadolibre.cl)
  - Mercadolibre Colombia (mercadolibre.com.co)
  - Mercadolibre Costa Rica (mercadolibre.co.cr)
  - Mercadolibre Dominican Republic (mercadolibre.com.do)
  - Mercadolibre Ecuador (mercadolibre.com.ec)
  - Mercadolibre Guatemala (mercadolibre.com.gt)
  - Mercadolibre Honduras (mercadolibre.com.hn)
  - Mercadolibre Mexico (mercadolibre.com.mx)
  - Mercadolibre Nicaragua (mercadolibre.com.ni)
  - Mercadolibre Panama (mercadolibre.com.pa)
  - Mercadolibre Paraguay (mercadolibre.com.py)
  - Mercadolibre Peru (mercadolibre.com.pe)
  - Mercadolibre Salvador (mercadolibre.com.sv)
  - Mercadolibre Uruguay (mercadolibre.com.uy)
  - Mercadolibre Venezuela (mercadolibre.com.ve)

- **customDomains:**\
  A list of custom email domains you want the scraper to target, with a default value of `["@gmail.com"]`.

- **proxyConfiguration:**\
  Optional proxy settings to help with high-volume scraping and avoid rate-limiting issues.

##### Example Input JSON

```json
{
  "keywords": ["handbag", "wallet"],
  "location": "Mexico",
  "mercadolibreSite": "Mercadolibre Mexico (mercadolibre.com.mx)",
  "customDomains": ["@gmail.com", "@hotmail.com"],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

***

#### Output

The **Mercadolibre email scraper** returns a JSON array with the following data for each email address found:

- **keyword:** The keyword used for the search.
- **title:** The title of the product listing.
- **description:** A description that includes the extracted email along with other relevant details.
- **url:** The URL of the Mercadolibre product page.
- **email:** The extracted email address from the product listing.

Example output:

```json
[
  {
    "keyword": "handbag",
    "title": "Stylish Leather Handbag for Women",
    "description": "Please contact us at: stylishleatherbag@example.com. A perfect gift for all occasions. Available in various colors.",
    "url": "https://www.mercadolibre.com.mx/stylish-leather-handbag-for-women",
    "email": "stylishleatherbag@example.com"
  }
]
```

***

#### How to Use

1. **Input Your Keywords and Email Domains:**\
   Enter the keywords (e.g., "handbag", "wallet") and email domains (e.g., `@gmail.com`) you want to search for in Mercadolibre's listings.

2. **Run the Actor:**\
   Execute the **Mercadolibre email scraper** to start scraping Mercadolibre for emails based on your keywords and platform settings.

3. **Proxy Setup (Optional):**\
   For optimal performance and to avoid rate-limiting issues, you can configure proxy settings. This ensures your scraping is smooth, even during large-scale operations.

4. **Download & Use the Data:**\
   Once the actor completes its process, you can download the scraped data in formats such as JSON, CSV, or Excel. Use this data to build email lists, conduct marketing outreach, or perform further analysis.

***

#### Best Use Cases

- **Targeted Marketing Campaigns:** Use the **Mercadolibre email scraper** to gather contact details and build custom email lists based on specific product categories or keywords.
- **Lead Generation:** Extract relevant email addresses from product listings to generate new leads for your business or service.
- **Market Research:** Collect contact information from sellers or other key figures on Mercadolibre for market intelligence and competitor analysis.
- **E-commerce Outreach:** Engage with vendors or sellers on Mercadolibre to form partnerships or collaborations.

***

#### Support and Feedback

If you need help or have any suggestions for improving the **Mercadolibre email scraper**, feel free to get in touch. We value your feedback to enhance the functionality and effectiveness of the scraper.

For support:

- Open an issue on the project's repository.
- Contact the developer team via the support channels.

Happy scraping and good luck with your outreach efforts!

# Actor input Schema

## `keywords` (type: `array`):

A list of keywords to search for.

## `location` (type: `string`):

Location to filter search results.

## `mercadolibreSite` (type: `string`):

Select the Mercadolibre site to scrape.

## `customDomains` (type: `array`):

List of custom email domains

## `proxyConfiguration` (type: `object`):

Configure proxies for this Actor.

## Actor input object example

```json
{
  "keywords": [
    "honda",
    "wallet"
  ],
  "location": "",
  "mercadolibreSite": "Mercadolibre Brazil (mercadolivre.com.br)",
  "customDomains": [
    "@gmail.com"
  ]
}
```

# 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 = {
    "keywords": [
        "honda",
        "wallet"
    ],
    "location": "",
    "customDomains": [
        "@gmail.com"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraper-mind/mercadolibre-email-scraper").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 = {
    "keywords": [
        "honda",
        "wallet",
    ],
    "location": "",
    "customDomains": ["@gmail.com"],
}

# Run the Actor and wait for it to finish
run = client.actor("scraper-mind/mercadolibre-email-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "keywords": [
    "honda",
    "wallet"
  ],
  "location": "",
  "customDomains": [
    "@gmail.com"
  ]
}' |
apify call scraper-mind/mercadolibre-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scraper-mind/mercadolibre-email-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Mercadolibre Email Scraper",
        "description": "The Mercadolibre Email Scraper lets you efficiently extract Mercadolibre email addresses from regional listings. Ideal for lead generation, market research, and targeted marketing campaigns, it supports keyword and location filtering, custom domains, and proxies for smooth data collection.",
        "version": "0.0",
        "x-build-id": "zOTecVTJsDePISazq"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scraper-mind~mercadolibre-email-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scraper-mind-mercadolibre-email-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/scraper-mind~mercadolibre-email-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scraper-mind-mercadolibre-email-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/scraper-mind~mercadolibre-email-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scraper-mind-mercadolibre-email-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "keywords"
                ],
                "properties": {
                    "keywords": {
                        "title": "Keywords",
                        "type": "array",
                        "description": "A list of keywords to search for.",
                        "default": [
                            "honda",
                            "wallet"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "location": {
                        "title": "Location",
                        "type": "string",
                        "description": "Location to filter search results.",
                        "default": ""
                    },
                    "mercadolibreSite": {
                        "title": "Platform",
                        "enum": [
                            "Mercadolibre Argentina (mercadolibre.com.ar)",
                            "Mercadolibre Bolivia (mercadolibre.com.bo)",
                            "Mercadolibre Brazil (mercadolivre.com.br)",
                            "Mercadolibre Chile (mercadolibre.cl)",
                            "Mercadolibre Colombia (mercadolibre.com.co)",
                            "Mercadolibre Costa Rica (mercadolibre.co.cr)",
                            "Mercadolibre Dominican Republic (mercadolibre.com.do)",
                            "Mercadolibre Ecuador (mercadolibre.com.ec)",
                            "Mercadolibre Guatemala (mercadolibre.com.gt)",
                            "Mercadolibre Honduras (mercadolibre.com.hn)",
                            "Mercadolibre Mexico (mercadolibre.com.mx)",
                            "Mercadolibre Nicaragua (mercadolibre.com.ni)",
                            "Mercadolibre Panama (mercadolibre.com.pa)",
                            "Mercadolibre Paraguay (mercadolibre.com.py)",
                            "Mercadolibre Peru (mercadolibre.com.pe)",
                            "Mercadolibre Salvador (mercadolibre.com.sv)",
                            "Mercadolibre Uruguay (mercadolibre.com.uy)",
                            "Mercadolibre Venezuela (mercadolibre.com.ve)"
                        ],
                        "type": "string",
                        "description": "Select the Mercadolibre site to scrape.",
                        "default": "Mercadolibre Brazil (mercadolivre.com.br)"
                    },
                    "customDomains": {
                        "title": "Custom Email Domains",
                        "type": "array",
                        "description": "List of custom email domains",
                        "default": [
                            "@gmail.com"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Configure proxies for this Actor."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
