# AliExpress Scraper

> AliExpress Scraper is a paid API for AI agents from agent-data.centorprat.workers.dev, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-29).

Scrapes AliExpress search results by keyword, returning product price, discount, units sold, rating, badges, image, and link, plus an optional free market summary per keyword.

## Facts

- Endpoint: POST https://agent-data.centorprat.workers.dev/tools/aliexpress-scraper?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aliexpress-scraper-2f2637c0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hmM7vlCZvEpb0BZ1SKa0o

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 aliexpress-scraper-2f2637c0 -d '<json body>'
```

Example prompt: Search AliExpress for 'wireless earbuds', sort by orders, keep only products with at least 1000 sold and a rating of 4.5 or higher, show up to 30 results in USD, and include a market summary.

## When to prefer this

Choose this endpoint when you need structured product data from AliExpress specifically — including pricing, sales volume, ratings, and Choice badges — without requiring a login or AliExpress API key. It is ideal for dropshipping research, niche validation, and competitive price benchmarking. Prefer it over general web search when you need machine-readable product fields and an optional market summary in a single call.

## Known failure modes

- Keyword returns no results — empty product list returned, not charged
- AliExpress anti-scrape measures temporarily block results — partial or empty response
- Invalid currency or sort enum value — schema validation error
- maxProductsPerSearch exceeds 60 — capped or rejected by schema
- AliExpress changes page structure — scraped fields may be missing or malformed

## How this service works

Pay-per-call data and tools for AI agents, $0.002-0.01 per call in USDC via x402 (Base, Polygon or Solana), no account or API key; MAX tiers ($0.05-0.25) run deeper jobs. Agent toolkit: web search, search + read top pages, any page as clean markdown with a prompt-injection check, which-x402-API-to-call recommender, seller check. Data: Google Maps places with contacts, YouTube video data and transcripts, job listings (Indeed, LinkedIn, 13 boards), Google Ads Transparency, TikTok comments, Pinterest, Airbnb, Redfin, AliExpress, app stores, live sports, website and SEO checks, Shopify store tech stacks, and onchain token / address risk checks.

## Output

A list of up to 60 product records per keyword, each containing price, original price, discount percentage, units sold, star rating, Choice and promotional badges, thumbnail image URL, and product page link. If marketSummary is enabled, also returns a free summary covering price range, units sold stats, top sellers, and Choice/discount share for the keyword.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sortBy": {
   "enum": [
    "best-match",
    "orders",
    "price-asc",
    "price-desc"
   ],
   "type": "string",
   "description": "AliExpress sort order."
  },
  "minSold": {
   "type": "integer",
   "description": "Keep products with at least this many sold (as AliExpress shows it, e.g. 1,000+)."
  },
  "currency": {
   "enum": [
    "USD",
    "EUR",
    "GBP",
    "CAD",
    "AUD",
    "BRL",
    "MXN",
    "PLN"
   ],
   "type": "string",
   "description": "Prices in this currency."
  },
  "maxPrice": {
   "type": "integer",
   "description": "AliExpress price filter."
  },
  "minPrice": {
   "type": "integer",
   "description": "AliExpress price filter."
  },
  "minRating": {
   "type": "number",
   "description": "Keep products rated at least this."
  },
  "onlyChoice": {
   "type": "boolean",
   "description": "Keep Choice products only (faster shipping, AliExpress-backed)."
  },
  "marketSummary": {
   "type": "boolean",
   "description": "Free summary per keyword: price range, units sold, top sellers, Choice / discount shares."
  },
  "searchQueries": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 1,
   "description": "e.g. [\"magsafe case\", \"led strip lights\"]."
  },
  "maxProductsPerSearch": {
   "type": "integer",
   "maximum": 60,
   "description": "60 per page."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "url": "https://www.aliexpress.com/item/3256813102623323.html",
    "sold": 3000,
    "price": 1.33,
    "title": "Luxury Tech Woven for Magsafe Magnetic Phone Case for Iphone 18 17 16 15 Plus 14 13 12 11 Pro Max Wireless Charging Back Cover",
    "badges": [
     "Choice",
     "Fastest delivery in 6 days"
    ],
    "rating": 4.9,
    "currency": "USD",
    "isChoice": true,
    "soldText": "3,000+ sold",
    "priceText": "US $1.33",
    "productId": "3256813102623323",
    "freeShipping": false,
    "originalPrice": 9.69,
    "discountPercent": 86
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aliexpress-scraper-2f2637c0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data.centorprat.workers.dev](https://www.zero.xyz/host/agent-data.centorprat.workers.dev/llms.txt)