# Amazon API - Search Amazon products by keywords

## API Overview

- Search Amazon products by keywords
- Support sorting
- Support multiple sites
- Support multi-language/multi-currency

## API URL

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

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| site | string | Region name abbreviation, for example, Thailand is 'th'. | true |
| keywords | string | Search keywords | true |
| page | integer | Page number<br/>Default value: 1 | false |
| page_size | integer | Number of items per page<br/>Default value: 20 | false |
| sort | string | Sort type<br/>Optional values: `default`, `price_up`, `price_down`, `reviews`, `newest`, `sales`<br/>Default value: default | false |
| currency | string | Optional values: `USD` | false |
| lang | string | Language<br/>Optional values: `en_US`, `zh_CN` | 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/amazon/search/items?apiToken=xxxxxx&site=&keywords=&page=1&page_size=20&sort=default'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "page": 1,
    "page_size": 20,
    "total": 46104,
    "has_next_page": true,
    "sort": "default",
    "currency": "USD",
    "language": "en_US",
    "items": [
      {
        "item_id": "B0CB1FW5FC",
        "asin": "B0CB1FW5FC",
        "product_url": "https://www.amazon.com/dp/B0CB1FW5FC",
        "title": "INIU Portable Charger, Ultra Slim 45W Fast Charging with Attached USB C Cable, Flight-Safe 10000mAh PD Power Bank Battery Pack, Travel Essential Phone Powerbank for iPhone 17 16 Samsung S25 Google etc",
        "img": "https://m.media-amazon.com/images/I/71iJQXTXmRL._AC_UY218_.jpg",
        "img_origin": "https://m.media-amazon.com/images/I/71iJQXTXmRL._AC_UY654_FMwebp_QL65_.jpg",
        "price_info": {
          "sale_price": "18.68",
          "origin_price": ""
        },
        "sold_count": "10000+",
        "review_info": {
          "rating_star": "4.5",
          "review_count": 0
        },
        "certifications": [],
        "is_ad": true,
        "is_best_seller": false,
        "is_amazon_choice": false
      },
      {
        "item_id": "B0F66NH2ZX",
        "asin": "B0F66NH2ZX",
        "product_url": "https://www.amazon.com/dp/B0F66NH2ZX",
        "title": "Anker Prime Power Bank, 20,100mAh 3-Port Portable Charger with 220W Max Output, Two-Way Charging, TSA-Approved, App Control, for MacBook, iPhone 17/16 Series, and More (Base Not Included)",
        "img": "https://m.media-amazon.com/images/I/61i0NalUQRL._AC_UY218_.jpg",
        "img_origin": "https://m.media-amazon.com/images/I/61i0NalUQRL._AC_UY654_FMwebp_QL65_.jpg",
        "price_info": {
          "sale_price": "128.99",
          "origin_price": ""
        },
        "sold_count": "",
        "review_info": {
          "rating_star": "4.8",
          "review_count": 0
        },
        "certifications": [],
        "is_ad": true,
        "is_best_seller": false,
        "is_amazon_choice": false
      },
      {
        "item_id": "B0DCBB2YTR",
        "asin": "B0DCBB2YTR",
        "product_url": "https://www.amazon.com/dp/B0DCBB2YTR",
        "title": "Anker Laptop Power Bank, 25,000mAh Portable Charger with Triple 100W USB-C Ports, Built-in Retractable Cables, Flight-Approved for Travel, iPhone 17/16 Series, MacBook, Samsung, and More",
        "img": "https://m.media-amazon.com/images/I/71K65j4IrHL._AC_UY218_.jpg",
        "img_origin": "https://m.media-amazon.com/images/I/71K65j4IrHL._AC_UY654_FMwebp_QL65_.jpg",
        "price_info": {
          "sale_price": "87.99",
          "origin_price": ""
        },
        "sold_count": "10000+",
        "review_info": {
          "rating_star": "4.6",
          "review_count": 0
        },
        "certifications": [],
        "is_ad": false,
        "is_best_seller": false,
        "is_amazon_choice": false
      }
    ]
  },
  "extra": ""
}

```