# Mercado Libre Store API Documentation

Returns the profile of one official store (name, owner id, status, creation date, tags, logo, free-return flag) and the products shown on its home page, with the same product fields as the category products endpoint. Take slug and storefront_id from the stores endpoint. A store home page shows a curated selection, not the full catalogue, and some featured products carry only a price. Failed requests (404, 422, 503) are never billed. A valid answer with zero rows is a successful, billable 200.

- **Documentation:** [https://scrappa.co/docs/mercadolibre-api/mercadolibre_store](https://scrappa.co/docs/mercadolibre-api/mercadolibre_store)
- **API group:** Mercado Libre API
- **Endpoint:** `GET https://scrappa.co/api/mercadolibre/store`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `site` | string | Yes | Country site id: MLA (Argentina), MLB (Brazil), MLM (Mexico), MLC (Chile), MCO (Colombia), MPE (Peru), MLU (Uruguay), MEC (Ecuador) or MLV (Venezuela). |
| `slug` | string | Yes | Store slug from the stores endpoint, for example 0800-growshop. |
| `storefront_id` | string | Yes | Storefront id of the same store, from the stores endpoint. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/mercadolibre/store?site=MLA&slug=0800-growshop&storefront_id=4134df7a5c244d00b667c93607fa48d2102550583"
```

## Example response

```json
{
    "success": true,
    "data": {
        "store": {
            "id": "4134df7a5c244d00b667c93607fa48d2102550583",
            "name": "0800 GROWSHOP",
            "site_id": "MLA",
            "country_id": "AR",
            "owner_id": 102550583,
            "type": "brand",
            "status": "active",
            "url": "https://www.mercadolibre.com.ar/tienda/0800-growshop",
            "created_at": "2018-11-24T17:01:08Z",
            "tags": [
                "seller-to-brand",
                "normal_store",
                "has_followers"
            ],
            "official_store_id": 361864,
            "free_return": true
        },
        "products": [
            {
                "position": 18,
                "item_id": "MLA3699103570",
                "product_id": "MLA76001869",
                "user_product_id": "MLAU4496216117",
                "url": "https://www.mercadolibre.com.ar/sistema-hidroponico-dwc-1-balde-20-litros-con-nutrientes-kawsay-250ml/p/MLA76001869",
                "title": "Sistema Hidroponico DWC 1 Balde 20 Litros Con Nutrientes Kawsay 250ml",
                "price": 178972,
                "previous_price": 192444,
                "currency": "ARS",
                "discount_label": "7% OFF",
                "shipping_text": "Llega gratis ma\u00f1ana",
                "shipping_promise_type": "next_day",
                "picture_id": "976000-MLA115343024539_072026",
                "image_url": "https://http2.mlstatic.com/D_NQ_NP_2X_976000-MLA115343024539_072026-V.jpg"
            }
        ],
        "total": 79
    },
    "meta": {
        "endpoint_family": "store",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The item, category or store does not exist on this site. This response is not billable. |
| 422 | Validation Error | A parameter is invalid: unknown site, an id that does not belong to the site, a limit out of range, rating other than 1 to 5, or a zip code of another country. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result from Mercado Libre. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)