# Taobao Shop Detail API

> Get a Taobao or Tmall shop's homepage info, shop categories and default product listing by seller ID and shop ID. Use the category IDs to filter Taobao Shop Items.

Source: https://www.sandbase.ai/apis/taobao/shop/detail
API reference: https://www.sandbase.ai/apis/taobao/shop/detail#api

## Facts

- Provider: Taobao
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/taobao/shop/detail`
- Price: $0.021429 per call
- Capabilities: api, taobao, ecommerce
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/taobao/shop/detail` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `sellerId` | string | yes |  |
| `shopId` | string | yes |  |

## FAQ

### How do I use the Taobao Shop Detail API?

Send a POST request to https://api.sandbase.ai/v1/api/taobao/shop/detail with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Taobao Shop Detail API cost?

$0.021429 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Taobao Shop Detail API accept?

Required: sellerId (string) and shopId (string). The Parameters table and the Playground on this page list every field.

### What does the Taobao Shop Detail API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Taobao developer account or API key?

No. Taobao Shop Detail runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Taobao API access separately.

## README

### Taobao Shop Detail API

Get a Taobao or Tmall shop's homepage info, shop categories and default product listing by seller ID and shop ID. Use the category IDs to filter Taobao Shop Items.

The result is returned in `outputs[0].data` in the platform's original structure.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/taobao/shop/detail" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sellerId": "1659916565", "shopId": "103710607"}'
```

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `sellerId` | string | Yes | Taobao seller user ID associated with the shop. |
| `shopId` | string | Yes | Taobao shop ID associated with the seller. |

#### Pricing

Flat price per call. Failed calls and empty results are not charged.