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

## API Overview

- Get a list of products based on category or keyword
- Total number of products
- Product details
- See More

## API URL

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

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| keywords | string | Search keywords | false |
| page | integer | Page number<br/>Default value: 1 | false |
| sort | string | Optional values: `relevance`, `sales`<br/>Default value: relevance | false |
| cat_id | string | Category ID | false |
| is_delivery_guaranteed | boolean | Products with guaranteed on-time delivery by scheduled dates and money back for order issues | false |
| trade_assurance | boolean |  | false |
| is_verified_supplier | boolean | Suppliers with credentials and capabilities inspected and verified by third-party companies | false |
| is_verified_pro | boolean | Industry-leading Verified Suppliers with 5+ years of experience | false |
| quick_response | boolean | Response time is within 1 hour | false |
| price_start | string | Filter: Minimum value of price range | false |
| price_end | string | Filter: Maximum value of price range | false |
| min_order | integer | Minimum order quantity | 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/alibaba/search/items?apiToken=xxxxxx&keywords=clothes+women&page=1&sort=relevance'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "page": 1,
    "page_size": 30,
    "total_count": 106851,
    "keywords": "clothes women",
    "sort": "relevance",
    "filters": {
      "price_start": "",
      "price_end": ""
    },
    "items": [
      {
        "item_id": "1601284732338",
        "title": "Women's Clothes Wholesale Women's Oversized T-Shirts Custom Printing Logo Blank Heavyweight Plus Size Women T-Shirts",
        "img": "https://s.alicdn.com/@sc04/kf/Hfc2a3db6e9654147a734af84126e3b7bh.jpg_200x200.jpg",
        "category_id": "201274476",
        "price": "5.00",
        "price_info": {
          "price_text": "$5.00-5.50",
          "price_min": "5.00",
          "price_max": " 5.50"
        },
        "comment_count": 0,
        "shop_info": {
          "company_name": "Guangzhou Flugi Apparel Co., Ltd.",
          "company_id": "234212240",
          "company_region": "CN",
          "seller_id": "2546680499",
          "member_id": "224532555",
          "is_verified_supplier": true,
          "chat_url": ""
        },
        "min_order_quantity": "200",
        "unit": "piece"
      },
      {
        "item_id": "1601229942079",
        "title": "Made in China Oem Odm Brand Logo Small Orders Custom Designer Premium Clothes Manufacturers Y2K Clothing Women Made Dress Custom",
        "img": "https://s.alicdn.com/@sc04/kf/H2b174423b97843d0bcef18839ad181ceu.jpg_200x200.jpg",
        "category_id": "100005791",
        "price": "4.50",
        "price_info": {
          "price_text": "$4.50-9.90",
          "price_min": "4.50",
          "price_max": " 9.90"
        },
        "comment_count": 0,
        "shop_info": {
          "company_name": "Dongguan Humen Siyinghong Garment Manufactory",
          "company_id": "234551494",
          "company_region": "CN",
          "seller_id": "2567323523",
          "member_id": "224822064",
          "is_verified_supplier": true,
          "chat_url": ""
        },
        "min_order_quantity": "50",
        "unit": "piece"
      },
      {
        "item_id": "1601169367389",
        "title": "Wholesale Natural Cotton Linen Women Dress Solid Color Strapless Women Cotton Linen Blend Dresses",
        "img": "https://s.alicdn.com/@sc04/kf/H6ded0b21051f43cab5533879348897e0O.jpg_200x200.jpg",
        "category_id": "100005791",
        "price": "15.00",
        "price_info": {
          "price_text": "$15.00",
          "price_min": "15.00",
          "price_max": "15.00"
        },
        "comment_count": 0,
        "shop_info": {
          "company_name": "Xinxiang City Red Flag District See Ru Clothing Store",
          "company_id": "259871806",
          "company_region": "CN",
          "seller_id": "2212067468481",
          "member_id": "252714634",
          "is_verified_supplier": false,
          "chat_url": ""
        },
        "min_order_quantity": "2",
        "unit": "piece"
      }
    ]
  }
}

```