# Falabella Product API Documentation

Returns one product by numeric id or by its public product URL. The payload has current and previous price, currency, discount, rating, review count, availability, stock units, variants with prices and stock, specifications, seller with RUT, delivery data, full-size images, description, warranty and the first page of public review text with author, rating and an ISO 8601 date. Failed requests (404, 422, 503) are never billed. A valid answer with zero rows is a successful, billable 200.

- **Documentation:** [https://scrappa.co/docs/falabella-api/falabella_product](https://scrappa.co/docs/falabella-api/falabella_product)
- **API group:** Falabella API
- **Endpoint:** `GET https://scrappa.co/api/falabella/product`

## 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 |
| --- | --- | --- | --- |
| `country` | string | Yes | Storefront country: cl (Chile, available), pe (Peru) or co (Colombia). Only countries that passed the soak are served. |
| `id` | string | No | Numeric id from search, for example 80864544. Use this or url. |
| `url` | string | No | Public Falabella product URL. The id is read from it. Use this or id. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/falabella/product?country=cl&id=80864544"
```

## Example response

```json
{
    "success": true,
    "data": {
        "country": "cl",
        "product_id": "80864544",
        "name": "Audifonos inal\u00e1mbricos WH1000XM4 Sony",
        "brand": "Sony",
        "price": 129990,
        "old_price": 199990,
        "currency": "CLP",
        "discount": 35,
        "rating": 5,
        "review_count": 128,
        "availability": "in_stock",
        "stock_units": 12,
        "variants": [
            {
                "sku_id": "80864544",
                "name": "Negro",
                "price": 129990,
                "currency": "CLP",
                "availability": "in_stock"
            }
        ],
        "specifications": [
            {
                "name": "Marca",
                "value": "Sony"
            }
        ],
        "seller": {
            "id": "seller-1",
            "name": "Falabella",
            "rut": null
        },
        "images": [
            "https://www.falabella.com/media/80864544-full.jpg"
        ],
        "reviews": [
            {
                "author": "Ana",
                "rating": 5,
                "text": "Excelente sonido.",
                "date": "2026-04-27T18:12:19Z"
            }
        ]
    },
    "meta": {
        "endpoint_family": "product",
        "country": "cl",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter is missing or invalid. |
| 404 | Not Found | The upstream product or location was not found. |
| 503 | Upstream Unavailable | The public storefront did not answer. No credit was charged. |

## 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)
