# Aliexpress API - Search for Aliexpress products by keywords or category

## API Overview

- Get a list of products based on keywords
- Total number of products
- Product details
- See More

## API URL

`GET https://api.tmapi.io/aliexpress/search/items`

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| country | string | Default value: US | false |
| lang | string | Language<br/>Optional values: `en_US`, `ru_RU`, `pt_BR`, `es_ES`, `fr_FR`, `pl_PL`, `iw_IL`, `it_IT`, `tr_TR`, `de_DE`, `ko_KR`, `ar_MA`, `ja_JP`, `nl_NL`, `th_TH`, `in_ID`, `vi_VN` | false |
| currency | string |  | false |
| keyword | string | Search keywords | true |
| page | integer | Page number<br/>Default value: 1 | false |
| sort | string | Optional values: `default`, `sales`, `price_up`, `price_down`<br/>Default value: default | false |
| free_shipping | boolean | Filter: Free shipping | false |
| price_start | string | Filter: Minimum value of price range | false |
| price_end | string | Filter: Maximum value of price range | false |

## Security Auth

> Please go to [Console-Account Center](https://console.tmapi.io/account/center) to get your apiToken.

> Add your apiToken to the request parameters. Please refer to the examples below.

## Request Example

```bash

curl --request GET 'https://api.tmapi.io/aliexpress/search/items?apiToken=xxxxxx&country=US&keyword=&page=1&sort=default'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "page": 1,
    "page_size": 2,
    "total_count": 132268,
    "has_next_page": true,
    "sort": "default",
    "filters": {},
    "items": [
      {
        "item_id": "3256808676351326",
        "title": "Letter Print Cute Sheep Crop Tops Y2k Clothes Vintage Women's Streetwear T-Shirts Gothic Girl Aesthetic midriff-baring top",
        "img": "https://ae-pic-a1.aliexpress-media.com/kf/S7f3443359ade49f0b171ba0c5bebba2ca.jpg",
        "main_imgs": [
          "https://ae-pic-a1.aliexpress-media.com/kf/S7f3443359ade49f0b171ba0c5bebba2ca.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/S54614569826b446991245a5b1396f2b5g.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/S723fbf2fefef45d6b53b26628c1543caP.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/S33ab4df9576643a09db4b679a3d8fa6fd.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/S89fc885ab2ca43868bcdfaa834f8e6f44.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/S1bcdd80bd1b14bb5b31e2840e1ba2eecB.jpg"
        ],
        "currency": "USD",
        "price_info": {
          "sale_price": "7.69",
          "origin_price": "15.37"
        },
        "sales_count": "1",
        "review_info": {
          "rating_star": ""
        },
        "shop_info": {
          "shop_id": "//www.aliexpress.com/store/1104761536",
          "member_id": 6002409736,
          "shop_name": "Glamour Wardrobe Store",
          "shop_url": "https://www.aliexpress.com/store/1104761536"
        },
        "created_time": "2025-04-20"
      },
      {
        "item_id": "3256808473818144",
        "title": "Women Print Floral Sports Fashion Casual Explosive Short Sleeve T-shirt Graphic Tshirts  Women Clothes  Oversized T Shirt",
        "img": "https://ae-pic-a1.aliexpress-media.com/kf/S7acd2a67741d4707869fb30d29dbfe5db.jpg",
        "main_imgs": [
          "https://ae-pic-a1.aliexpress-media.com/kf/S7acd2a67741d4707869fb30d29dbfe5db.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/Se0c148d4ce3e4e3db88970cd24df78dbY.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/Sdc89697a80234c9fad6f51aea6e763f6y.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/S03a27e59f91b465da26e3e11e60d9ae5d.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/Se3b95f1086694d2fa8b8f7eb5e11b7f8x.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/Sa193ce0ecec84d8c99c69325a88387a3V.jpg"
        ],
        "currency": "USD",
        "price_info": {
          "sale_price": "5.72",
          "origin_price": "11.84"
        },
        "sales_count": "2000+",
        "review_info": {
          "rating_star": "4.9"
        },
        "shop_info": {
          "shop_id": "//www.aliexpress.com/store/1103576287",
          "member_id": 2678280160,
          "shop_name": "Stone's Store",
          "shop_url": "https://www.aliexpress.com/store/1103576287"
        },
        "created_time": "2025-03-15"
      }
    ]
  }
}

```