# AliExpress API guide



## Choose a AliExpress operation



Start with the object your task needs. The groups below use the current catalogue; open an endpoint to check accepted identifiers, filters, price and availability before retrieving.



### Products and categories



- [AliExpress categories](https://www.monocrawl.com/docs/endpoints/aliexpress/categories) — AliExpress's top-level categories with their children and ids for aliexpress/search.

- [AliExpress product](https://www.monocrawl.com/docs/endpoints/aliexpress/product) — One AliExpress product: title, price range and promotion, rating, sales, images and video, properties, description, variants and options, shipping options and the seller.

- [AliExpress store products](https://www.monocrawl.com/docs/endpoints/aliexpress/store-products) — Products of one AliExpress store, optionally matching a keyword.



### Other operations



- [AliExpress product description](https://www.monocrawl.com/docs/endpoints/aliexpress/description) — The full description text and images of an AliExpress product, with its property list.

- [AliExpress promotions](https://www.monocrawl.com/docs/endpoints/aliexpress/promos) — The featured AliExpress promotions currently running, with the number of products in each; a name goes to aliexpress/search-promo.

- [AliExpress shipping options](https://www.monocrawl.com/docs/endpoints/aliexpress/shipping) — Shipping options for an AliExpress product to a country: carrier, fee, days and tracking.

- [Similar AliExpress products](https://www.monocrawl.com/docs/endpoints/aliexpress/similar) — Products similar to an AliExpress product (or to a keyword), from the marketplace's own matching.

- [AliExpress store](https://www.monocrawl.com/docs/endpoints/aliexpress/store) — One AliExpress store: name, followers, product count, positive rate and seller level.



### Reviews and offers



- [AliExpress product reviews](https://www.monocrawl.com/docs/endpoints/aliexpress/reviews) — Reviews of an AliExpress product, twenty per page, with the rating distribution and buyer country.



### Search and discovery



- [AliExpress product search](https://www.monocrawl.com/docs/endpoints/aliexpress/search) — Products matching a keyword, twenty per page, with price, promotion price, sales, rating and shipping.

- [AliExpress hot products](https://www.monocrawl.com/docs/endpoints/aliexpress/search-hot) — Currently hot AliExpress products, optionally filtered by keyword or category, with prices, discount, sales volume and shop.

- [AliExpress promotion products](https://www.monocrawl.com/docs/endpoints/aliexpress/search-promo) — Products in a named AliExpress promotion, with prices, discount, sales volume and shop.



## Check fields and collection limits



Use the endpoint’s declared parameters and returned continuation. Filters from another platform do not automatically apply here. Preserve source identifiers, URLs and warnings; a successful page does not establish complete history. Published response schemas identify whether they come from a reviewed shaper or observed response shapes.



Agents can use `get_endpoint` for the current contract and `get_docs` with topic `platforms/aliexpress` to read this page. The [coverage guide](https://www.monocrawl.com/docs/data-availability) explains nulls and partial results, and the [production guide](https://www.monocrawl.com/docs/production-checklist) covers budgets and recovery.



## Endpoint reference

## aliexpress/categories

`GET /v1/aliexpress/categories`

AliExpress's top-level categories with their children and ids for aliexpress/search.

*AliExpress categories*

| Parameter | Required | Description |
| --- | --- | --- |
| `language` | no | Locale — e.g. `en_US` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/aliexpress/categories" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "children": [
        {}
      ],
      "id": "example",
      "name": "example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/aliexpress/categories#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/aliexpress/categories.json)


## aliexpress/description

`GET /v1/aliexpress/description`

The full description text and images of an AliExpress product, with its property list.

*AliExpress product description*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | AliExpress item id — e.g. `1005005244562338` |
| `language` | no | Locale — e.g. `en_US` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/aliexpress/description?id=1005005244562338" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "description": {
    "images": [
      "example"
    ],
    "text": "example"
  },
  "id": "example",
  "platform": "example",
  "properties": [
    {
      "name": "example",
      "value": "example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/aliexpress/description#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/aliexpress/description.json)


## aliexpress/product

`GET /v1/aliexpress/product`

One AliExpress product: title, price range and promotion, rating, sales, images and video, properties, description, variants and options, shipping options and the seller.

*AliExpress product*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | AliExpress item id (the number in its URL), or the URL — e.g. `1005005244562338` |
| `region` | no | Storefront country — e.g. `US` |
| `currency` | no | Currency code — e.g. `USD` |
| `language` | no | Locale — e.g. `en_US` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `region`: Select the documented source market or request location. Read this endpoint’s region semantics; it does not generally prove creator residence.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/aliexpress/product?id=1005005244562338" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "available": false,
  "breadcrumbs": [],
  "category_id": "example",
  "currency": "example",
  "description": {
    "images": [
      "example"
    ]
  },
  "id": "example",
  "image": "https://example.com/example",
  "images": [
    "example"
  ],
  "options": [
    {
      "id": "example",
      "name": "example",
      "values": [
        {}
      ]
    }
  ],
  "platform": "example",
  "price_range": {
    "max": 0,
    "min": 0
  },
  "promotion_price": {
    "max": 0,
    "min": 0
  },
  "properties": [
    {
      "name": "example",
      "value": "example"
    }
  ],
  "quantity": 0,
  "rating": {
    "max": 0,
    "value": 0,
    "votes": 0
  },
  "reviews_count": 0,
  "seller": {
    "company_id": "example",
    "id": "example",
    "name": "example",
    "store_id": "example",
    "url": "https://example.com/example"
  },
  "shipping": {
    "days_to_ship": 0,
    "options": [],
    "package": {
      "height": 0,
      "length": 0,
      "weight": 0,
      "width": 0
    },
    "to": "example"
  },
  "title": "example",
  "type": "example",
  "url": "https://example.com/example",
  "variants": [
    {
      "attributes": "example",
      "ext": "example",
      "id": "example",
      "price": 0,
      "promotion_price": 0,
      "quantity": 0
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/aliexpress/product#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/aliexpress/product.json)


## aliexpress/promos

`GET /v1/aliexpress/promos`

The featured AliExpress promotions currently running, with the number of products in each; a name goes to aliexpress/search-promo.

*AliExpress promotions*

| Parameter | Required | Description |
| --- | --- | --- |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/aliexpress/promos" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "description": "example",
      "name": "example",
      "product_count": 0
    }
  ],
  "total": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/aliexpress/promos#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/aliexpress/promos.json)


## aliexpress/reviews

`GET /v1/aliexpress/reviews`

Reviews of an AliExpress product, twenty per page, with the rating distribution and buyer country.

*AliExpress product reviews*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | AliExpress item id — e.g. `3256809769628322` |
| `page` | no | Page number (20 per page) — e.g. `1` |
| `filter` | no | A filter value from the response's filters list — e.g. `allReviews` |
| `sort` | no | A sort value from the response |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `sort`: Choose the documented source ordering before paging through results. Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/aliexpress/reviews?id=3256809769628322" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "filters": [
    "example"
  ],
  "has_more": false,
  "items": [
    {
      "anonymous": false,
      "author": {
        "country": "example",
        "gender": "example",
        "image": "https://example.com/example",
        "name": "example"
      },
      "helpful": 0,
      "id": "example",
      "images": [
        "example"
      ],
      "language": "example",
      "logistics": "example",
      "platform": "example",
      "posted_at": "2026-09-01T12:00:00Z",
      "rating": 0,
      "text": "example",
      "translated_text": "example",
      "unhelpful": 0,
      "variant": "example"
    }
  ],
  "page": 0,
  "positive_rate": 0,
  "product_id": "example",
  "rating": {
    "max": 0,
    "value": 0,
    "votes": 0
  },
  "rating_distribution": {},
  "total": 0,
  "total_pages": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/aliexpress/reviews#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/aliexpress/reviews.json)


## aliexpress/search

`GET /v1/aliexpress/search`

Products matching a keyword, twenty per page, with price, promotion price, sales, rating and shipping.

*AliExpress product search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search keyword — e.g. `iphone` |
| `page` | no | Page number (20 per page) — e.g. `1` |
| `sort` | no | A sort value from the response's sorts list — e.g. `default` |
| `category_id` | no | Category id from aliexpress/categories |
| `min_price` | no | Minimum price |
| `max_price` | no | Maximum price |
| `ship_from` | no | Ship-from country code |
| `region` | no | Storefront country — e.g. `US` |
| `currency` | no | Currency code — e.g. `USD` |
| `language` | no | Locale — e.g. `en_US` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `sort`: Choose the documented source ordering before paging through results. Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
- `region`: Select the documented source market or request location. Read this endpoint’s region semantics; it does not generally prove creator residence.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/aliexpress/search?query=iphone" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "currency": "example",
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "id": "example",
      "image": "https://example.com/example",
      "listing_type": "example",
      "platform": "example",
      "price": 0,
      "promotion_price": {
        "max": 0,
        "min": 0
      },
      "rating": {
        "max": 0,
        "value": 0
      },
      "sales": 0,
      "sales_label": "example",
      "selling_points": [],
      "title": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "page": 0,
  "query": "example",
  "region": "example",
  "sorts": [
    "example"
  ],
  "total": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/aliexpress/search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/aliexpress/search.json)


## aliexpress/search-hot

`GET /v1/aliexpress/search-hot`

Currently hot AliExpress products, optionally filtered by keyword or category, with prices, discount, sales volume and shop.

*AliExpress hot products*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | no | Keyword filter — e.g. `xiaomi` |
| `category_id` | no | Category id filter |
| `sort_by` | no | price_asc, price_desc, volume or discount Accepted values: price_asc, price_desc, volume, sales, discount, newest. Case, spaces, hyphens and underscores are interchangeable. — e.g. `volume` |
| `page` | no | Page number — e.g. `1` |
| `limit` | no | Products per page, up to 50 — e.g. `10` |
| `country` | no | Ship-to country — e.g. `US` |
| `currency` | no | Price currency — e.g. `USD` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/aliexpress/search-hot?query=xiaomi" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "category": {
        "id": "example",
        "name": "example",
        "parent": "example"
      },
      "currency": "example",
      "discount": "example",
      "id": "example",
      "image": "https://example.com/example",
      "images": [
        "example"
      ],
      "original_price": 0,
      "platform": "example",
      "price": 0,
      "promotion_price": 0,
      "rating": {
        "max": 0,
        "value": 0
      },
      "sales": 0,
      "sales_label": "example",
      "selling_points": [],
      "shop": {
        "id": "example",
        "name": "example",
        "url": "https://example.com/example"
      },
      "sku_id": "example",
      "title": "example",
      "type": "example",
      "url": "https://example.com/example",
      "video_url": "https://example.com/example"
    }
  ],
  "page": 0,
  "query": "example",
  "total_results": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/aliexpress/search-hot#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/aliexpress/search-hot.json)


## aliexpress/search-promo

`GET /v1/aliexpress/search-promo`

Products in a named AliExpress promotion, with prices, discount, sales volume and shop.

*AliExpress promotion products*

| Parameter | Required | Description |
| --- | --- | --- |
| `promotion_name` | yes | A promotion name from aliexpress/promos — e.g. `New Arrival` |
| `query` | no | Keyword filter |
| `page` | no | Page number — e.g. `1` |
| `limit` | no | Products per page, up to 50 — e.g. `10` |
| `country` | no | Ship-to country — e.g. `US` |
| `currency` | no | Price currency — e.g. `USD` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/aliexpress/search-promo?promotion_name=New%20Arrival" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "category": {
        "id": "example",
        "name": "example",
        "parent": "example"
      },
      "currency": "example",
      "discount": "example",
      "id": "example",
      "image": "https://example.com/example",
      "images": [
        "example"
      ],
      "original_price": 0,
      "platform": "example",
      "price": 0,
      "promotion_price": 0,
      "sales": 0,
      "sales_label": "example",
      "selling_points": [],
      "shop": {
        "id": "example",
        "name": "example",
        "url": "https://example.com/example"
      },
      "sku_id": "example",
      "title": "example",
      "type": "example",
      "url": "https://example.com/example",
      "video_url": "https://example.com/example"
    }
  ],
  "page": 0,
  "promotion_name": "example",
  "total_results": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/aliexpress/search-promo#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/aliexpress/search-promo.json)


## aliexpress/shipping

`GET /v1/aliexpress/shipping`

Shipping options for an AliExpress product to a country: carrier, fee, days and tracking.

*AliExpress shipping options*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | AliExpress item id — e.g. `3256804591426248` |
| `region` | no | Ship-to country — e.g. `US` |
| `quantity` | no | Quantity — e.g. `1` |
| `ext` | no | A variant's ext token from aliexpress/product, for variant-specific rates |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `region`: Select the documented source market or request location. Read this endpoint’s region semantics; it does not generally prove creator residence.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/aliexpress/shipping?id=3256804591426248" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "currency": "example",
  "has_more": false,
  "items": [
    {
      "from": "example",
      "notes": [
        "example"
      ],
      "to": "example"
    }
  ],
  "product_id": "example",
  "region": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/aliexpress/shipping#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/aliexpress/shipping.json)


## aliexpress/similar

`GET /v1/aliexpress/similar`

Products similar to an AliExpress product (or to a keyword), from the marketplace's own matching.

*Similar AliExpress products*

| Parameter | Required | Description |
| --- | --- | --- |
| `product_id` | no | A product id or URL — e.g. `3256806145778732` |
| `query` | no | A keyword, when no product id is given — e.g. `headphones` |
| `country` | no | Ship-to country — e.g. `US` |
| `currency` | no | Price currency — e.g. `USD` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/aliexpress/similar?query=headphones" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "category": {
        "id": "example",
        "name": "example",
        "parent": "example"
      },
      "currency": "example",
      "discount": "example",
      "id": "example",
      "image": "https://example.com/example",
      "images": [
        "example"
      ],
      "original_price": 0,
      "platform": "example",
      "price": 0,
      "promotion_price": 0,
      "rating": {
        "max": 0,
        "value": 0
      },
      "sales": 0,
      "sales_label": "example",
      "selling_points": [],
      "shop": {
        "id": "example",
        "name": "example",
        "url": "https://example.com/example"
      },
      "sku_id": "example",
      "title": "example",
      "type": "example",
      "url": "https://example.com/example",
      "video_url": "https://example.com/example"
    }
  ],
  "page": 0,
  "source_product_id": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/aliexpress/similar#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/aliexpress/similar.json)


## aliexpress/store

`GET /v1/aliexpress/store`

One AliExpress store: name, followers, product count, positive rate and seller level.

*AliExpress store*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Seller id from a product — e.g. `231651707` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/aliexpress/store?id=231651707" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "followers": 0,
  "id": "example",
  "image": "https://example.com/example",
  "level": "example",
  "name": "example",
  "platform": "example",
  "positive_count": 0,
  "positive_rate": 0,
  "products_count": 0,
  "ratings_count": 0,
  "score": 0,
  "seller_id": "example",
  "type": "example",
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/aliexpress/store#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/aliexpress/store.json)


## aliexpress/store-products

`GET /v1/aliexpress/store-products`

Products of one AliExpress store, optionally matching a keyword.

*AliExpress store products*

| Parameter | Required | Description |
| --- | --- | --- |
| `seller_id` | yes | Seller id from aliexpress/product's seller block — e.g. `6003681832` |
| `store_id` | yes | Store id from the same seller block — e.g. `1105134056` |
| `query` | no | Keyword within the store |
| `page` | no | Page number — e.g. `1` |
| `sort` | no | A sort value from the response |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `sort`: Choose the documented source ordering before paging through results. Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/aliexpress/store-products?seller_id=6003681832&store_id=1105134056" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "id": "example",
      "image": "https://example.com/example",
      "platform": "example",
      "price": 0,
      "price_range": {
        "max": 0,
        "min": 0
      },
      "promotion_price": {
        "max": 0,
        "min": 0
      },
      "rating": {
        "max": 0,
        "value": 0,
        "votes": 0
      },
      "sales": 0,
      "sales_label": "example",
      "selling_points": [],
      "title": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "page": 0,
  "seller_id": "example",
  "store_id": "example",
  "total": 0,
  "total_pages": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/aliexpress/store-products#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/aliexpress/store-products.json)