# Taobao/Tmall Product Data Scraper

> Taobao/Tmall Product Data Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Extracts structured product data (title, price, currency, item ID, Tmall flag) from Taobao and Tmall product URLs or numeric IDs

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/taobao?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/taobao-tmall-product-data-scraper-cf2fac98
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gQBREPL6ilS1NwWkTfMDE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability taobao-tmall-product-data-scraper-cf2fac98 -d '<json body>'
```

Example prompt: Can you pull the structured product details — title, price, and currency — from these two Taobao listings: https://item.taobao.com/item.htm?id=123456789 and https://item.taobao.com/item.htm?id=987654321, and cap the results at 2 products?

## When to prefer this

Choose this endpoint when you need structured product data (price, title, item ID, Tmall flag) from Taobao or Tmall listings via direct product URLs or numeric IDs, and only want to pay for successful extractions. Prefer this over general-purpose web scrapers when the target is specifically Taobao/Tmall and you need consistently shaped JSON output rather than raw HTML.

## Known failure modes

- Short share links (e.g. taobao.com/…) are not supported and will fail
- Invalid or non-product URLs return empty or null fields
- Product IDs that no longer exist return empty results
- Network or anti-scraping blocks from Taobao may cause failed runs (which are not charged)
- Exceeding maxItems causes early termination of result set

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of results and an items array where each entry contains the product URL, input identifier used, current price, title, numeric item ID, a boolean indicating whether it is a Tmall product, original/list price, and price currency code.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "items": {
   "type": "array",
   "description": "Direct Taobao or Tmall product URLs with an id parameter, or numeric product IDs. Each successful product produces one row. Short share links are not supported."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Stop after this many successful product rows. Zero means no additional cap."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "url": null,
    "input": null,
    "price": null,
    "title": null,
    "itemId": null,
    "isTmall": null,
    "originalPrice": null,
    "priceCurrency": null
   }
  ],
  "product": "taobao"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/taobao-tmall-product-data-scraper-cf2fac98/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)
