# Mercado Libre Official Stores API Documentation

Lists the active official stores of a country site with name, store page url, slug, storefront id, official store id, category ids and logo. total is the live number of stores. Page with offset and limit (1 to 100); offset plus limit must not exceed 10000. Send slug and storefront_id to the store endpoint for the products of one store. 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_stores](https://scrappa.co/docs/mercadolibre-api/mercadolibre_stores)
- **API group:** Mercado Libre API
- **Endpoint:** `GET https://scrappa.co/api/mercadolibre/stores`

## 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). |
| `offset` | integer | No | Stores to skip. Defaults to 0. |
| `limit` | integer | No | Stores per page, 1 to 100. Defaults to 50. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/mercadolibre/stores?site=MLA&limit=2"
```

## Example response

```json
{
    "success": true,
    "data": {
        "site": "MLA",
        "stores": [
            {
                "position": 1,
                "name": "0800 GROWSHOP",
                "slug": "0800-growshop",
                "url": "https://www.mercadolibre.com.ar/tienda/0800-growshop",
                "storefront_id": "4134df7a5c244d00b667c93607fa48d2102550583",
                "official_store_id": 361864,
                "category_ids": [
                    "MLA1574"
                ],
                "logo_url": "https://http2.mlstatic.com/D_NQ_NP_883361-MLA110039889772_042026-F.jpg"
            }
        ],
        "total": 10974,
        "offset": 0,
        "limit": 2,
        "has_more": true
    },
    "meta": {
        "endpoint_family": "stores",
        "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)