# Shopee Product Scraper API (x402)

> Shopee Product Scraper API (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes and returns structured product listings from Shopee across multiple Southeast Asian and Brazilian markets, with filtering by price, rating, sales, and more.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/shopee?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/shopee-product-scraper-api-x402-60586196
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xImU-nAnu4gWRBpBsX3K5

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 shopee-product-scraper-api-x402-60586196 -d '<json body>'
```

Example prompt: Search Shopee Taiwan for 'wireless earbuds', sorted by best selling, include only products rated at least 4 stars and priced between 500 and 2000 TWD, and return up to 50 results.

## When to prefer this

Use this endpoint when you need structured product data from Shopee specifically — including listings from Southeast Asian markets (Taiwan, Singapore, Indonesia, Malaysia, Philippines, Thailand, Vietnam) or Brazil. It is well-suited for price comparison, market research, competitor analysis, and catalog extraction. Prefer it over generic web scrapers when you need Shopee-specific filtering (sold count, rating, official shop, discount, video) and pay only on successful runs.

## Known failure modes

- Empty result set if search terms return no products (not charged)
- Sitemap fallback triggered for Taiwan searches without filters when listing requests are blocked — returns only URL, title, and image without price/rating/sales data
- Invalid region code returns a validation error
- Shop ID not found or private shop returns empty result
- Rate limiting or blocking by Shopee may cause partial or empty results
- Exceeding maxItems cap of 5000 will be clamped to 5000

## 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 matched products and an array of product items, each containing the product URL, name, primary image, price, additional images, item ID, shop ID, and minimum price in the local currency of the selected region.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "relevance",
    "newest",
    "price_low_to_high",
    "price_high_to_low",
    "best_selling"
   ],
   "type": "string",
   "default": "relevance",
   "description": "Order requested from the listing endpoint."
  },
  "region": {
   "enum": [
    "TW",
    "SG",
    "ID",
    "MY",
    "PH",
    "TH",
    "VN",
    "BR"
   ],
   "type": "string",
   "default": "TW",
   "description": "Market to search. Prices use its local currency."
  },
  "shopId": {
   "type": "integer",
   "minimum": 1,
   "description": "Numeric shop ID whose public product catalog will be collected."
  },
  "minSold": {
   "type": "integer",
   "minimum": 0,
   "description": "Include products with at least this many recorded historical sales."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "maximum": 5000,
   "minimum": 1,
   "description": "Maximum unique products across all searches and shops."
  },
  "priceMax": {
   "type": "number",
   "minimum": 0,
   "description": "Include products priced at or below this amount in local currency."
  },
  "priceMin": {
   "type": "number",
   "minimum": 0,
   "description": "Include products priced at or above this amount in local currency."
  },
  "minRating": {
   "type": "number",
   "maximum": 5,
   "minimum": 0,
   "description": "Include products with at least this average star rating."
  },
  "startUrls": {
   "type": "array",
   "description": "Search URLs with a keyword parameter or numeric /shop/ URLs in the selected market."
  },
  "searchTerms": {
   "type": "array",
   "description": "Product keywords to search. Results are combined and duplicate products are removed."
  },
  "withVideoOnly": {
   "type": "boolean",
   "default": false,
   "description": "Include only listings that provide video information."
  },
  "discountedOnly": {
   "type": "boolean",
   "default": false,
   "description": "Include only listings that show a discount."
  },
  "sitemapFallback": {
   "type": "boolean",
   "default": true,
   "description": "For Taiwan searches without filters, return indexed product links, titles, and images when listing requests are blocked. Sitemap records have no price, rating, or sales data."
  },
  "officialShopOnly": {
   "type": "boolean",
   "default": false,
   "description": "Include only listings marked as official shops."
  },
  "preferredSellerOnly": {
   "type": "boolean",
   "default": false,
   "description": "Include only 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "url": null,
    "name": null,
    "image": null,
    "price": null,
    "images": null,
    "itemId": null,
    "shopId": null,
    "priceMin": null
   }
  ],
  "product": "shopee"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/shopee-product-scraper-api-x402-60586196/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)