# Taobao Shop API Documentation

<p>Open a public Taobao shop with the numeric shop id returned by search or item. The response carries the shop block, DSR description, service and delivery scores where published, and the listed catalogue products in the same shape as search. The public page shows a bounded catalogue list, not a complete inventory. Failed requests are never charged.</p>

- **Documentation:** [https://scrappa.co/docs/taobao-api/taobao_shop](https://scrappa.co/docs/taobao-api/taobao_shop)
- **API group:** Taobao API
- **Endpoint:** `GET https://scrappa.co/api/taobao/shop`

## 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 numeric shop id returned by search or item. |

## Example response

```json
{
    "data": {
        "name": "Example shop",
        "scores": {
            "service": 4.9,
            "delivery": 4.7,
            "description": 4.8
        },
        "shop_id": "107922698",
        "products": [
            {
                "price": {
                    "amount": 99,
                    "currency": "CNY"
                },
                "item_id_str": "TOKEN"
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "shop"
    },
    "success": true
}
```

## Errors

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