# Shopee Product Scraper

> Shopee Product 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).

Scrapes structured product listing data from Shopee across multiple Asian and Brazilian markets, supporting search terms, shop IDs, and URL-based queries with rich filtering.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-383e4503
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DcoE5rnkRMA3NdDLLT2-k

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-383e4503 -d '<json body>'
```

Example prompt: Search Shopee Singapore for 'wireless earbuds', sorted by best selling, include only products with at least 100 sales and a minimum 4-star rating, priced between 10 and 80 SGD, and give me up to 200 results.

## When to prefer this

Use this endpoint when you need structured product data from Shopee across Asian or Brazilian markets and want flexible filtering by price, rating, sales volume, discount status, or specific shop. It is the right choice for price intelligence, competitor catalog analysis, product discovery, and e-commerce research workflows targeting Shopee specifically. Prefer it over generic web scrapers when you need deduplicated, structured JSON output with Shopee-specific fields like itemId and shopId.

## Known failure modes

- No products found matching filters — empty items array returned (not charged)
- Shopee listing requests blocked for selected region — sitemap fallback activated for Taiwan (no price/rating data in fallback)
- Invalid shopId or region combination — schema validation error
- priceMin greater than priceMax — no results or error
- Rate limiting or scraping detection by Shopee — empty or failed run (not charged)
- Invalid startUrls format — malformed request error

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

## 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-383e4503/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)