# AliExpress Search API (aliexpress.search)

- Canonical page: https://everyinfra.com/en/aliexpress-api/search
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "aliexpress", "action": "search", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Billing unit: every 50 rows you ask for count as one call; blocks that come back with no rows are not charged
- Returns: list, default 20, max 200 per call
- Mode: sync; add "mode": "async" for slow tasks

AliExpress Search looks up products by `keyword` and lists, for each, its product ID, title, link, price and struck-through price with the currency, discount, rating, order and review counts, ship-from location, seller name, top-rated seller badge, free shipping flag, category and tags. Dropshipping stores and product researchers use it to size up a niche, compare offers for the same item and shortlist products to vet in detail.

On AliExpress, `orders_count`, the cumulative number of orders, is a firmer trust signal than `rating`. Filter with `min_price`, read in the currency the results use, and `min_rating`, a 0 to 5 star threshold; order with `sort`, where `popular` puts the most-ordered products first. Check `ships_from` against where your buyers are before you compare prices. An empty `tags` array means the product has no tags, not that data is missing.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=aliexpress&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Specifies the product search query (for example, wireless earbuds) to return listing collections. Pass search keywords instead of seller IDs; access product details, variants, and reviews using item URLs. |
| min_price | not declared | no | not declared | Sets the minimum item price numeric threshold for search queries to exclude lower-priced items. This is an item price filter rather than a discount percentage or API request budget; result currencies depend on search metadata. |
| min_rating | not declared | no | not declared | Filters item searches by minimum star rating using a numeric scale from 0 to 5 (such as 4.5). This parameter evaluates overall product rating rather than review counts, positive feedback percentages, or individual review scores. |
| sort | enum: popular / price_asc / price_desc / relevance / top_rated | no | not declared | Sorts action results using allowed values. For search, options include relevance (default), popular, price_asc, price_desc, and top_rated (supporting legacy values default, orders, rating). For reviews, options are relevance (default) and newest, which sorts by review submission date rather than product listing date. ratings takes no sort. |
| limit | integer (1–200) | no | 20 | The most rows to return in this call, an integer from 1 to 200. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| product_id | platform-native meaning |
| title | Title. null when the platform has no titles (for example text-only posts). |
| url | Link to the record on the platform. |
| price | Price as a number without a currency symbol; see currency. |
| original_price | platform-native meaning |
| currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
| discount | platform-native meaning |
| rating | Rating. **The scale varies by platform**: rating_scale on the same row gives the maximum (usually 5; Booking, Douban, iQIYI and NAVER use 10). Convert with rating_scale before comparing across platforms, or the comparison can come out backwards. |
| rating_scale | Maximum of rating in the same row: 5 for five-star scales, 10 for ten-point scales. Present only when the row has a rating. |
| orders_count | platform-native meaning |
| review_count | Number of reviews, for product and business capabilities. null means not disclosed, not 0. |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| ships_from | platform-native meaning |
| seller_name | platform-native meaning |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| is_top_rated | platform-native meaning |
| free_shipping | platform-native meaning |
| images | Image links: on product capabilities the product gallery in page order, on reviews the buyer's photos. |
| search_rank | Position in this search result (search). |
| seller_rating | Seller rating (search). |
| seller_url | Seller store link (search). |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| tags | Array of tags. An empty array, not null, when there are none. |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "aliexpress",
  "action": "search",
  "params": {
    "keyword": "wireless keyboard"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "aliexpress",
        "action": "search",
        "params": {
            "keyword": "wireless keyboard",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "aliexpress",
  "action": "search",
  "results": [
    {
      "product_id": "•••",
      "title": "ATTACK SHARK M75 Kabellose Membran-Gaming-Tastatur mit Knopf und OLED-Display, Bluetooth/2,4 GHz, Regenbogen-Hintergrundbeleuchtung, PBT-Tastenkappen mit Farbverlauf",
      "url": "https://www.aliexpress.com/item/1005009141716642.html",
      "price": 35.79,
      "currency": "EUR",
      "rating": 4.4,
      "orders_count": 178,
      "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/Sea136b941dbf41f7b21b564e9c895f1af.jpg",
      "ships_from": "US",
      "is_top_rated": false,
      "platform": "aliexpress",
      "tags": [
        "Bester Preis in ähnlichen Angeboten"
      ],
      "rating_scale": 5
    },
    {
      "product_id": "•••",
      "title": "ZIYOU LANG M96 – kabellose Gaming-Tastatur mit Display und Drehregler, Bluetooth-/2,4-GHz-Membrantastatur mit leisem Betrieb, 3000-mAh-Akku, wiederaufladbar.",
      "url": "https://www.aliexpress.com/item/1005009663809101.html",
      "price": 32.59,
      "currency": "EUR",
      "discount": "-8%",
      "rating": 4.9,
      "orders_count": 1413,
      "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S18528a11d40e45f7b8c6f26057ab5768e.jpg",
      "ships_from": "DE",
      "is_top_rated": true,
      "platform": "aliexpress",
      "tags": [
        "Niedrigster Preis seit 30 Tagen: 35,73€",
        "Kostenloser Versand",
        "Bester Preis in ähnlichen Angeboten"
      ],
      "rating_scale": 5
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### How do I find products buyers trust?

Combine `orders_count` with `rating`: cumulative orders are the firmer signal on AliExpress, and a high rating on few orders proves little. `is_top_rated` marks sellers AliExpress certifies as top rated, and `review_count` shows how many buyers wrote reviews. Shortlist products that hold up on all of these before you open their details.

### What does `min_rating` filter?

The product's star rating, on a scale from 0 to 5: 4.5 keeps products rated 4.5 and above. It is not a review count or a positive-feedback percentage, and it does not filter individual reviews by their stars. To read what buyers wrote about a product, use AliExpress Reviews with the product's link.

### How do I go deeper on a search result?

Pass the result's `url` to AliExpress Product details for the description, variants, shipping options and store, or pass `product_id` alone, since Product details also accepts the numeric ID. The same link works with AliExpress Reviews for buyer reviews and with AliExpress Variants for every option of the product.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=aliexpress
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md