# AliExpress Product Search API

> AliExpress Product Search API 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).

Searches AliExpress for products by keyword and returns structured listings with filtering by price, rating, orders, and sort order

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/aliexpress-search?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-search-api-fe4b2a86
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ecCxaLA9HOBfAgTXnMsLt

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-search-api-fe4b2a86 -d '<json body>'
```

Example prompt: Search AliExpress for 'wireless earbuds' and 'phone cases', show me up to 50 results each sorted by number of orders, only include items with at least 100 orders and a 4-star rating or higher, and keep prices between $5 and $50.

## When to prefer this

Use this endpoint when you need structured, filterable AliExpress product data at scale without maintaining your own scraper. It is ideal for dropshipping research, price monitoring, product sourcing, and competitive analysis on the AliExpress marketplace. Prefer it over generic web scrapers when you want pre-structured fields (product ID, URL, images, rating, orders) with built-in filtering — and the pay-per-successful-call model makes it cost-effective since failed or empty runs are not charged.

## Known failure modes

- Empty results if keyword matches no AliExpress listings (not charged)
- Failed run if AliExpress blocks the scrape request (not charged)
- Partial results if maxPages is hit before maxItems is reached
- Incorrect filtering if AliExpress displays prices in unexpected currencies
- Timeout if too many keywords or high maxPages values are requested simultaneously

## How this service works

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

## Output

A JSON object containing a count of matched products and an array of items, each with product ID, title, URL, image URL, additional images, page number, search position, and originating keyword.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "default",
    "orders",
    "price_asc",
    "price_desc",
    "rating"
   ],
   "type": "string",
   "default": "default",
   "description": "Site order for relevance, orders, or price. Top rated sorts the fetched pages locally by rating."
  },
  "keywords": {
   "type": "array",
   "description": "Product terms to search, one term per entry."
  },
  "maxItems": {
   "type": "integer",
   "default": 48,
   "maximum": 200,
   "minimum": 1,
   "description": "Maximum matching products to save for each keyword."
  },
  "maxPages": {
   "type": "integer",
   "default": 3,
   "maximum": 20,
   "minimum": 1,
   "description": "Maximum search pages to inspect for each keyword; each page has up to about 60 listings."
  },
  "maxPrice": {
   "type": "number",
   "minimum": 0,
   "description": "Keep listings with a sale price at or below this amount in the displayed currency."
  },
  "minPrice": {
   "type": "number",
   "minimum": 0,
   "description": "Keep listings with a sale price at or above this amount in the displayed currency."
  },
  "minOrders": {
   "type": "integer",
   "minimum": 0,
   "description": "Keep listings with at least this many sold units."
  },
  "minRating": {
   "type": "number",
   "maximum": 5,
   "minimum": 0,
   "description": "Keep listings with a displayed star rating at or above this value."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "page": null,
    "keyword": null,
    "imageUrl": null,
    "position": null,
    "productId": null,
    "productUrl": null,
    "productTitle": null,
    "additionalImages": null
   }
  ],
  "product": "aliexpress-search"
 }
}
```

## More

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