# Tmall Item API Documentation

<p>Open one public Tmall item with the item_id_str returned by Tmall search. The response carries the CNY price and original price, full-size images, location, category, seller scores and a review sample with ISO 8601 dates. A numeric item id is not accepted. Per-SKU price and stock, monthly sales and a Tmall rating split are not published in the public page and are never invented.</p>

- **Documentation:** [https://scrappa.co/docs/tmall-api/tmall_item](https://scrappa.co/docs/tmall-api/tmall_item)
- **API group:** Tmall API
- **Endpoint:** `GET https://scrappa.co/api/tmall/item`

## 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 |
| --- | --- | --- | --- |
| `id` | string | Yes | The item_id_str returned by Tmall search. |

## Example response

```json
{
    "data": {
        "shop": {
            "id": "107922698",
            "is_tmall": true
        },
        "price": {
            "amount": 2999,
            "currency": "CNY"
        },
        "title": "Example brand product",
        "item_id_str": "TOKEN"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "tmall_item"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No public data for this id. 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)
