# Mercadolivrebr Products Spider

The Mercadolivrebr Products Spider scrapes product details from Mercado Livre Brazil, extracting name, description, price, SKU, images, and ratings. Input URLs and get structured JSON for price monitoring, market research, or e-commerce integration. Scalable, reliable, and easy to use.

## Actor Statistics

- Total users: 2
- Monthly users: 2
- Runs succeeded: 100.00%
- Categories: AI, Automation, E-commerce

## Pricing

$35.00/month + usage

## Input Schema

- **Urls** (type: array): The urls for the spider.

## API example

## Mercadolivrebr Products Spider

- **OpenAPI Version:** `3.1.1`
- **API Version:** `0.0`

The Mercadolivrebr Products Spider scrapes product details from Mercado Livre Brazil, extracting name, description, price, SKU, images, and ratings. Input URLs and get structured JSON for price monitoring, market research, or e-commerce integration. Scalable, reliable, and easy to use.

### Servers

- **URL:** `https://api.apify.com/v2`

### Operations

#### Executes an Actor, waits for its completion, and returns Actor's dataset items in response.

- **Method:** `POST`
- **Path:** `/acts/getdataforme~mercadolivrebr-products-scraper/run-sync-get-dataset-items`
- **Tags:** Run Actor

##### Request Body

###### Content-Type: application/json

- **`Urls`**

  `array`, default: `["https://www.mercadolivre.com.br/p/api/deferred?id=MLB20133824&app=pdp&component_ids=open_box_alternatives&allow_test_items=false"]` — The urls for the spider.

  **Items:**

  `string`

**Example:**

```
{
  "Urls": [
    "https://www.mercadolivre.com.br/p/api/deferred?id=MLB20133824&app=pdp&component_ids=open_box_alternatives&allow_test_items=false"
  ]
}
```

##### Responses

###### Status: 200 OK

#### Executes an Actor and returns information about the initiated run in response.

- **Method:** `POST`
- **Path:** `/acts/getdataforme~mercadolivrebr-products-scraper/runs`
- **Tags:** Run Actor

##### Request Body

###### Content-Type: application/json

- **`Urls`**

  `array`, default: `["https://www.mercadolivre.com.br/p/api/deferred?id=MLB20133824&app=pdp&component_ids=open_box_alternatives&allow_test_items=false"]` — The urls for the spider.

  **Items:**

  `string`

**Example:**

```
{
  "Urls": [
    "https://www.mercadolivre.com.br/p/api/deferred?id=MLB20133824&app=pdp&component_ids=open_box_alternatives&allow_test_items=false"
  ]
}
```

##### Responses

###### Status: 200 OK

\####### Content-Type: application/json

- **`data`**

  `object`

  - **`actId`**

    `string`

  - **`buildId`**

    `string`

  - **`buildNumber`**

    `string`

  - **`containerUrl`**

    `string`

  - **`defaultDatasetId`**

    `string`

  - **`defaultKeyValueStoreId`**

    `string`

  - **`defaultRequestQueueId`**

    `string`

  - **`finishedAt`**

    `string`, format: `date-time`

  - **`id`**

    `string`

  - **`meta`**

    `object`

    - **`origin`**

      `string`

    - **`userAgent`**

      `string`

  - **`options`**

    `object`

    - **`build`**

      `string`

    - **`diskMbytes`**

      `integer`

    - **`memoryMbytes`**

      `integer`

    - **`timeoutSecs`**

      `integer`

  - **`startedAt`**

    `string`, format: `date-time`

  - **`stats`**

    `object`

    - **`computeUnits`**

      `integer`

    - **`inputBodyLen`**

      `integer`

    - **`rebootCount`**

      `integer`

    - **`restartCount`**

      `integer`

    - **`resurrectCount`**

      `integer`

  - **`status`**

    `string`

  - **`usage`**

    `object`

    - **`ACTOR_COMPUTE_UNITS`**

      `integer`

    - **`DATA_TRANSFER_EXTERNAL_GBYTES`**

      `integer`

    - **`DATA_TRANSFER_INTERNAL_GBYTES`**

      `integer`

    - **`DATASET_READS`**

      `integer`

    - **`DATASET_WRITES`**

      `integer`

    - **`KEY_VALUE_STORE_LISTS`**

      `integer`

    - **`KEY_VALUE_STORE_READS`**

      `integer`

    - **`KEY_VALUE_STORE_WRITES`**

      `integer`

    - **`PROXY_RESIDENTIAL_TRANSFER_GBYTES`**

      `integer`

    - **`PROXY_SERPS`**

      `integer`

    - **`REQUEST_QUEUE_READS`**

      `integer`

    - **`REQUEST_QUEUE_WRITES`**

      `integer`

  - **`usageTotalUsd`**

    `number`

  - **`usageUsd`**

    `object`

    - **`ACTOR_COMPUTE_UNITS`**

      `integer`

    - **`DATA_TRANSFER_EXTERNAL_GBYTES`**

      `integer`

    - **`DATA_TRANSFER_INTERNAL_GBYTES`**

      `integer`

    - **`DATASET_READS`**

      `integer`

    - **`DATASET_WRITES`**

      `integer`

    - **`KEY_VALUE_STORE_LISTS`**

      `integer`

    - **`KEY_VALUE_STORE_READS`**

      `integer`

    - **`KEY_VALUE_STORE_WRITES`**

      `number`

    - **`PROXY_RESIDENTIAL_TRANSFER_GBYTES`**

      `integer`

    - **`PROXY_SERPS`**

      `integer`

    - **`REQUEST_QUEUE_READS`**

      `integer`

    - **`REQUEST_QUEUE_WRITES`**

      `integer`

  - **`userId`**

    `string`

**Example:**

```
{
  "data": {
    "id": "",
    "actId": "",
    "userId": "",
    "startedAt": "2025-01-08T00:00:00.000Z",
    "finishedAt": "2025-01-08T00:00:00.000Z",
    "status": "READY",
    "meta": {
      "origin": "API",
      "userAgent": ""
    },
    "stats": {
      "inputBodyLen": 2000,
      "rebootCount": 0,
      "restartCount": 0,
      "resurrectCount": 0,
      "computeUnits": 0
    },
    "options": {
      "build": "latest",
      "timeoutSecs": 300,
      "memoryMbytes": 1024,
      "diskMbytes": 2048
    },
    "buildId": "",
    "defaultKeyValueStoreId": "",
    "defaultDatasetId": "",
    "defaultRequestQueueId": "",
    "buildNumber": "1.0.0",
    "containerUrl": "",
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0,
      "DATASET_READS": 0,
      "DATASET_WRITES": 0,
      "KEY_VALUE_STORE_READS": 0,
      "KEY_VALUE_STORE_WRITES": 1,
      "KEY_VALUE_STORE_LISTS": 0,
      "REQUEST_QUEUE_READS": 0,
      "REQUEST_QUEUE_WRITES": 0,
      "DATA_TRANSFER_INTERNAL_GBYTES": 0,
      "DATA_TRANSFER_EXTERNAL_GBYTES": 0,
      "PROXY_RESIDENTIAL_TRANSFER_GBYTES": 0,
      "PROXY_SERPS": 0
    },
    "usageTotalUsd": 0.00005,
    "usageUsd": {
      "ACTOR_COMPUTE_UNITS": 0,
      "DATASET_READS": 0,
      "DATASET_WRITES": 0,
      "KEY_VALUE_STORE_READS": 0,
      "KEY_VALUE_STORE_WRITES": 0.00005,
      "KEY_VALUE_STORE_LISTS": 0,
      "REQUEST_QUEUE_READS": 0,
      "REQUEST_QUEUE_WRITES": 0,
      "DATA_TRANSFER_INTERNAL_GBYTES": 0,
      "DATA_TRANSFER_EXTERNAL_GBYTES": 0,
      "PROXY_RESIDENTIAL_TRANSFER_GBYTES": 0,
      "PROXY_SERPS": 0
    }
  }
}
```

#### Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.

- **Method:** `POST`
- **Path:** `/acts/getdataforme~mercadolivrebr-products-scraper/run-sync`
- **Tags:** Run Actor

##### Request Body

###### Content-Type: application/json

- **`Urls`**

  `array`, default: `["https://www.mercadolivre.com.br/p/api/deferred?id=MLB20133824&app=pdp&component_ids=open_box_alternatives&allow_test_items=false"]` — The urls for the spider.

  **Items:**

  `string`

**Example:**

```
{
  "Urls": [
    "https://www.mercadolivre.com.br/p/api/deferred?id=MLB20133824&app=pdp&component_ids=open_box_alternatives&allow_test_items=false"
  ]
}
```

##### Responses

###### Status: 200 OK

### Schemas

#### inputSchema

- **Type:**`object`

* **`Urls`**

  `array`, default: `["https://www.mercadolivre.com.br/p/api/deferred?id=MLB20133824&app=pdp&component_ids=open_box_alternatives&allow_test_items=false"]` — The urls for the spider.

  **Items:**

  `string`

**Example:**

```
{
  "Urls": [
    "https://www.mercadolivre.com.br/p/api/deferred?id=MLB20133824&app=pdp&component_ids=open_box_alternatives&allow_test_items=false"
  ]
}
```

#### runsResponseSchema

- **Type:**`object`

* **`data`**

  `object`

  - **`actId`**

    `string`

  - **`buildId`**

    `string`

  - **`buildNumber`**

    `string`

  - **`containerUrl`**

    `string`

  - **`defaultDatasetId`**

    `string`

  - **`defaultKeyValueStoreId`**

    `string`

  - **`defaultRequestQueueId`**

    `string`

  - **`finishedAt`**

    `string`, format: `date-time`

  - **`id`**

    `string`

  - **`meta`**

    `object`

    - **`origin`**

      `string`

    - **`userAgent`**

      `string`

  - **`options`**

    `object`

    - **`build`**

      `string`

    - **`diskMbytes`**

      `integer`

    - **`memoryMbytes`**

      `integer`

    - **`timeoutSecs`**

      `integer`

  - **`startedAt`**

    `string`, format: `date-time`

  - **`stats`**

    `object`

    - **`computeUnits`**

      `integer`

    - **`inputBodyLen`**

      `integer`

    - **`rebootCount`**

      `integer`

    - **`restartCount`**

      `integer`

    - **`resurrectCount`**

      `integer`

  - **`status`**

    `string`

  - **`usage`**

    `object`

    - **`ACTOR_COMPUTE_UNITS`**

      `integer`

    - **`DATA_TRANSFER_EXTERNAL_GBYTES`**

      `integer`

    - **`DATA_TRANSFER_INTERNAL_GBYTES`**

      `integer`

    - **`DATASET_READS`**

      `integer`

    - **`DATASET_WRITES`**

      `integer`

    - **`KEY_VALUE_STORE_LISTS`**

      `integer`

    - **`KEY_VALUE_STORE_READS`**

      `integer`

    - **`KEY_VALUE_STORE_WRITES`**

      `integer`

    - **`PROXY_RESIDENTIAL_TRANSFER_GBYTES`**

      `integer`

    - **`PROXY_SERPS`**

      `integer`

    - **`REQUEST_QUEUE_READS`**

      `integer`

    - **`REQUEST_QUEUE_WRITES`**

      `integer`

  - **`usageTotalUsd`**

    `number`

  - **`usageUsd`**

    `object`

    - **`ACTOR_COMPUTE_UNITS`**

      `integer`

    - **`DATA_TRANSFER_EXTERNAL_GBYTES`**

      `integer`

    - **`DATA_TRANSFER_INTERNAL_GBYTES`**

      `integer`

    - **`DATASET_READS`**

      `integer`

    - **`DATASET_WRITES`**

      `integer`

    - **`KEY_VALUE_STORE_LISTS`**

      `integer`

    - **`KEY_VALUE_STORE_READS`**

      `integer`

    - **`KEY_VALUE_STORE_WRITES`**

      `number`

    - **`PROXY_RESIDENTIAL_TRANSFER_GBYTES`**

      `integer`

    - **`PROXY_SERPS`**

      `integer`

    - **`REQUEST_QUEUE_READS`**

      `integer`

    - **`REQUEST_QUEUE_WRITES`**

      `integer`

  - **`userId`**

    `string`

**Example:**

```
{
  "data": {
    "id": "",
    "actId": "",
    "userId": "",
    "startedAt": "2025-01-08T00:00:00.000Z",
    "finishedAt": "2025-01-08T00:00:00.000Z",
    "status": "READY",
    "meta": {
      "origin": "API",
      "userAgent": ""
    },
    "stats": {
      "inputBodyLen": 2000,
      "rebootCount": 0,
      "restartCount": 0,
      "resurrectCount": 0,
      "computeUnits": 0
    },
    "options": {
      "build": "latest",
      "timeoutSecs": 300,
      "memoryMbytes": 1024,
      "diskMbytes": 2048
    },
    "buildId": "",
    "defaultKeyValueStoreId": "",
    "defaultDatasetId": "",
    "defaultRequestQueueId": "",
    "buildNumber": "1.0.0",
    "containerUrl": "",
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0,
      "DATASET_READS": 0,
      "DATASET_WRITES": 0,
      "KEY_VALUE_STORE_READS": 0,
      "KEY_VALUE_STORE_WRITES": 1,
      "KEY_VALUE_STORE_LISTS": 0,
      "REQUEST_QUEUE_READS": 0,
      "REQUEST_QUEUE_WRITES": 0,
      "DATA_TRANSFER_INTERNAL_GBYTES": 0,
      "DATA_TRANSFER_EXTERNAL_GBYTES": 0,
      "PROXY_RESIDENTIAL_TRANSFER_GBYTES": 0,
      "PROXY_SERPS": 0
    },
    "usageTotalUsd": 0.00005,
    "usageUsd": {
      "ACTOR_COMPUTE_UNITS": 0,
      "DATASET_READS": 0,
      "DATASET_WRITES": 0,
      "KEY_VALUE_STORE_READS": 0,
      "KEY_VALUE_STORE_WRITES": 0.00005,
      "KEY_VALUE_STORE_LISTS": 0,
      "REQUEST_QUEUE_READS": 0,
      "REQUEST_QUEUE_WRITES": 0,
      "DATA_TRANSFER_INTERNAL_GBYTES": 0,
      "DATA_TRANSFER_EXTERNAL_GBYTES": 0,
      "PROXY_RESIDENTIAL_TRANSFER_GBYTES": 0,
      "PROXY_SERPS": 0
    }
  }
}
```

### Mercadolivrebr Products Spider

The **Mercadolivrebr Products Spider** is an Apify Actor that scrapes product details from Mercado Livre Brazil. By providing product URLs, it extracts name, description, price, SKU, images, and ratings, delivering structured JSON for e-commerce analysis or integration.

### Input Parameters

The Actor requires a JSON input with the following parameters:

| Parameter | Type   | Description                                                                 |
|-----------|--------|-----------------------------------------------------------------------------|
| `Urls`    | Array  | A list of Mercado Livre Brazil product URLs to scrape details from. Example: `["https://http2.mlstatic.com/D_NQ_NP_976667-MLA85758072167_062025-O.webp"]` |

#### Example Input

```json
{
    "Urls": [
        "https://http2.mlstatic.com/D_NQ_NP_976667-MLA85758072167_062025-O.webp"
    ]
}
```

### Features

- **Comprehensive Product Data**: Extracts name, description, SKU, price, currency, images, and ratings.
- **Offer Details**: Captures pricing, availability, and condition for each product offer.
- **Structured JSON Output**: Delivers consistent data for seamless integration.
- **Scalable URL Processing**: Supports multiple URLs for efficient batch scraping.
- **Reliable Error Handling**: Manages dynamic or incomplete product pages effectively.

### Output

The Actor returns a JSON array of product objects with detailed fields. Below is an example output:

```json
[
  {
    "name": "Huggies Fralda Descartável Máxima Proteção G - 66 Un",
    "description": "Gênero: Sem gênero. | Tamanho G. | Uso recomendado para bebês com uma faixa de peso entre 9 kg e 12.5 kg. | Com gel super absorvente. | Cintura elástica para maior conforto. | Tem barreiras reforçadas que evitam vazamentos. | Livre de parabenos. | Garante até 12 h de proteção. | Produto hipoalergênico.",
    "sku": "MLB20133824",
    "price": "83.05",
    "images": [
      "https://http2.mlstatic.com/D_NQ_NP_976667-MLA85758072167_062025-O.webp"
    ],
    "brand": "Huggies",
    "offers": [
      {
        "price": "83.05",
        "currency": "BRL",
        "condition": "https://schema.org/NewCondition",
        "availability": "https://schema.org/InStock",
        "seller": "Mercado Livre",
        "url": "https://www.mercadolivre.com.br/p/api/deferred?id=MLB20133824&app=pdp&component_ids=open_box_alternatives&allow_test_items=false",
        "valid_until": null
      }
    ],
    "aggregate_rating": {
      "rating_value": 4.9,
      "review_count": 1405,
      "best_rating": 5
    }
  }
]
```

### Use Cases

- **Price Monitoring**: Track product prices on Mercado Livre for competitive analysis.
- **Market Research**: Analyze product descriptions and ratings for consumer trends.
- **E-commerce Integration**: Feed product data into online stores or comparison platforms.
- **Inventory Management**: Monitor product availability for supply chain optimization.
- **Consumer Insights**: Use aggregate ratings to gauge product popularity and quality.

### Support

For bug reports or custom needs, contact us at <support@getdataforme.com> or use our contact form: <https://getdataforme.com/contact/>. Please include a clear subject line, such as "Mercadolivrebr Products Spider Support."
