# Taobao Item API Documentation

<p>Open one public Taobao item with the item_id_str returned by search. The response carries the CNY price and original price, full-size images, ships-from location, category ids, shop and seller scores, and a sample of review text with ISO 8601 dates. Numeric item ids are rejected because the platform no longer serves them. Per-SKU price and stock, monthly sales and the full review list are not present in the public page and are never invented.</p>

- **Documentation:** [https://scrappa.co/docs/taobao-api/taobao_item](https://scrappa.co/docs/taobao-api/taobao_item)
- **API group:** Taobao API
- **Endpoint:** `GET https://scrappa.co/api/taobao/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 search. |

## Example response

```json
{
    "data": {
        "shop": {
            "id": "107922698",
            "name": "Example shop"
        },
        "price": {
            "amount": 1999,
            "currency": "CNY",
            "original": 2499
        },
        "title": "Example phone",
        "images": [
            "https://img.alicdn.com/example.jpg"
        ],
        "seller": {
            "evaluates": 1200,
            "all_item_count": 60
        },
        "item_id_str": "NnA1ek1CdXZMRTBpaEE4WUpxeUtnQT09"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "item"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The id is missing or is not a token id. Not billable. |
| 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)
