# Yodobashi Product Variants API Documentation

Returns the site-owned variant data for one 18-digit SKU: sales price, fixed price, numeric discount and discount text, points and reward rate, rating and review count, stock status, arrival and delivery text, full-size image urls and the product summary. The count field can differ from the returned array; use the array. Points and reward rate are null when the item states no reward. Delivery text is plain text. Failed requests (404, 422, 503 and transport errors) are never billed. A valid answer with zero rows is a successful, billable 200. Each request makes one upstream lookup.

- **Documentation:** [https://scrappa.co/docs/yodobashi-api/yodobashi_variants](https://scrappa.co/docs/yodobashi-api/yodobashi_variants)
- **API group:** Yodobashi API
- **Endpoint:** `GET https://scrappa.co/api/yodobashi/variants`

## 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 |
| --- | --- | --- | --- |
| `sku` | string | Yes | 18-digit SKU from search. |
| `from` | integer | No | First variant, default 1. |
| `to` | integer | No | Last variant, default 500. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/yodobashi/variants?sku=100000001009096616"
```

## Example response

```json
{
    "success": true,
    "data": {
        "sku": "100000001009096616",
        "count": 1,
        "variants": [
            {
                "sku": "100000001009096616",
                "brand": "SONY",
                "price": 59400,
                "price_text": "\uffe559,400",
                "fixed_price": 66000,
                "discount": 10,
                "points": 5940,
                "point_rate": 10,
                "rating": 4.8,
                "review_count": 128,
                "store_stock_count": 3,
                "delivery_date_text": "\u660e\u65e5\u304a\u5c4a\u3051",
                "images": [
                    "https://image.yodobashi.com/product/100/000001/009096616.jpg"
                ]
            }
        ]
    },
    "meta": {
        "endpoint_family": "variants",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The product, page or id does not exist on the site. This response is not billable. |
| 422 | Validation Error | A parameter is invalid: a SKU that is not 18 digits, a maker id that is not 10 digits, a price range or page out of range, or a sort parameter (price sort is not supported). This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result. Failed requests are never billed. |

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