# Tokopedia API - Search for Tokopedia products by keywords

## API Overview

- Search results list
- Total number of products
- Product details

## API URL

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

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| keyword | string | Search keywords | true |
| sort | string | Optional values: `suitable`, `reviews`, `latest`, `price_asc`, `price_desc`<br/>Default value: suitable | false |
| page | integer | Page number<br/>Default value: 1 | false |
| price_start | string | Filter: Minimum value of price range | false |
| price_end | string | Filter: Maximum value of price range | false |
| is_2_hours_arrive | boolean |  | false |
| is_free_shipping | boolean |  | false |
| served_by_tokopedia | boolean |  | false |
| cod | boolean |  | false |
| cat_id | integer | Category ID | false |
| shop_type | string |  | 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/tokopedia/search/items?apiToken=xxxxxx&keyword=&sort=suitable&page=1'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "keyword": "cloth",
    "sort": "suitable",
    "filters": {},
    "page": 1,
    "total": 362672,
    "items": [
      {
        "item_id": 25757555,
        "product_url": "https://www.tokopedia.com/hmhhardware/kanebo-kenmaster-kain-lap-mobil-synthetic-cloth",
        "title": "Kanebo Kenmaster / Kain Lap Mobil /  Synthetic Cloth",
        "img": "https://images.tokopedia.net/img/cache/250-square/VqbcmM/2021/3/17/bed78d50-942d-4cac-8f06-9d22ed131e5f.png",
        "video_url": "",
        "currency": "IDR",
        "category_id": 63,
        "category_name": "Otomotif",
        "price_info": {
          "price": "17800",
          "origin_price": ""
        },
        "min_order": 1,
        "shop_info": {
          "shop_id": 580197,
          "shop_name": "HMH Hardware - LTC",
          "shop_url": "https://www.tokopedia.com/hmhhardware",
          "shop_location": "Jakarta Barat",
          "is_official_shop": false,
          "is_power_badge": true
        },
        "is_free_shipping": true,
        "discount": 0,
        "rating_info": {
          "rating_star": 5,
          "rating_average": "5.0",
          "rating_count": 751
        },
        "labels": [
          "Terlaris",
          "Tiba 24 - 27 Feb"
        ],
        "sold_count": "10000+",
        "stock": 11086
      },
      {
        "item_id": 182724169,
        "product_url": "https://www.tokopedia.com/toso/saringan-kain-thai-tea-coffee-strainer-cloth-filter-saringan-kopi",
        "title": "Saringan Kain Thai Tea Coffee Strainer Cloth Filter Saringan Kopi",
        "img": "https://images.tokopedia.net/img/cache/250-square/VqbcmM/2022/10/27/6372bb16-7006-460b-b8c9-38dc3c2b9e73.jpg",
        "video_url": "",
        "currency": "IDR",
        "category_id": 983,
        "category_name": "Dapur",
        "price_info": {
          "price": "15000",
          "origin_price": ""
        },
        "min_order": 1,
        "shop_info": {
          "shop_id": 356082,
          "shop_name": "Toso Official",
          "shop_url": "https://www.tokopedia.com/toso",
          "shop_location": "Jakarta Pusat",
          "is_official_shop": true,
          "is_power_badge": true
        },
        "is_free_shipping": true,
        "discount": 0,
        "rating_info": {
          "rating_star": 5,
          "rating_average": "4.8",
          "rating_count": 1505
        },
        "labels": [
          "Terlaris",
          "Tiba 24 - 27 Feb",
          "Beli Lokal"
        ],
        "sold_count": "9000+",
        "stock": 70
      },
      {
        "item_id": 670816010,
        "product_url": "https://www.tokopedia.com/originallem/town-talk-polish-gold-polishing-cloth-lap-poles-perhiasan-original",
        "title": "Town Talk Polish - Gold Polishing Cloth lap poles perhiasan ORIGINAL",
        "img": "https://images.tokopedia.net/img/cache/250-square/product-1/2020/6/26/86012770/86012770_afe932e3-5faf-4459-ad4e-c414ccee80d2_635_635",
        "video_url": "",
        "currency": "IDR",
        "category_id": 984,
        "category_name": "Rumah Tangga",
        "price_info": {
          "price": "65000",
          "origin_price": ""
        },
        "min_order": 1,
        "shop_info": {
          "shop_id": 7575737,
          "shop_name": "Originalle_Merchandise",
          "shop_url": "https://www.tokopedia.com/originallem",
          "shop_location": "Jakarta Utara",
          "is_official_shop": false,
          "is_power_badge": true
        },
        "is_free_shipping": false,
        "discount": 0,
        "rating_info": {
          "rating_star": 5,
          "rating_average": "4.9",
          "rating_count": 326
        },
        "labels": [
          "Cashback 2,6rb"
        ],
        "sold_count": "1000+",
        "stock": 5450
      }
    ]
  }
}

```