# AliExpress Product Scraper

> AliExpress 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 data from AliExpress via search queries or direct product URLs, returning titles, prices, ratings, and images.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/aliexpress?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/aliexpress-product-scraper-437da761
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tvqiv7zRUt1Ro9nwkaJHW

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-product-scraper-437da761 -d '<json body>'
```

Example prompt: Search AliExpress for 'wireless earbuds' sorted by number of orders, and give me the top 50 products with their titles, prices, and ratings.

## When to prefer this

Use this endpoint when you need structured product data from AliExpress at scale — either by keyword search or direct product URL — with pricing, ratings, and images. Prefer it over general web scrapers because it returns a normalized schema specific to AliExpress product fields, and failed/empty runs are not billed.

## Known failure modes

- AliExpress blocks or rate-limits the scraper, returning empty results (not charged)
- Invalid or inaccessible product URLs return null fields
- Search query returns no results (not charged)
- Price and sales fields may be empty for direct product URL lookups
- maxItems or maxProducts limits truncate results earlier than expected

## 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 array of product items, each containing title, imageUrl, productId, productUrl, ratingValue, priceCurrent, priceDiscount, and priceOriginal. Fields may be null if unavailable from the page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sortBy": {
   "enum": [
    "default",
    "orders",
    "price_asc",
    "price_desc"
   ],
   "type": "string",
   "default": "default",
   "description": "Sort search listings by relevance, sales, or price."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Stop after this many products across all inputs; zero removes the total cap."
  },
  "maxProducts": {
   "type": "integer",
   "default": 100,
   "maximum": 1000,
   "minimum": 1,
   "description": "Maximum unique products to collect for each search query, across search pages."
  },
  "productUrls": {
   "type": "array",
   "description": "Direct AliExpress item URLs. Public item pages provide title and image; price and sales fields may be empty."
  },
  "searchQueries": {
   "type": "array",
   "description": "Keywords to search, one per line. Provide search queries, product URLs, or both."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "title": null,
    "imageUrl": null,
    "productId": null,
    "productUrl": null,
    "ratingValue": null,
    "priceCurrent": null,
    "priceDiscount": null,
    "priceOriginal": null
   }
  ],
  "product": "aliexpress"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aliexpress-product-scraper-437da761/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)