# Shopee API - Search for Shopee shops by keywords

## API Overview

- Search results list
- Total number of shops
- Shop details
- See More

## API URL

`GET https://api.tmapi.io/shopee/search/shops`

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| site | string | Region name abbreviation, for example, Thailand is 'th'.<br/>Optional values: `my`, `th`, `ph`, `id`, `vn`, `sg`, `tw`, `br`, `mx`, `co`, `cl` | true |
| keyword | string | Search keywords | true |
| page | integer | Page number<br/>Default value: 1 | false |
| pageSize | integer | Default value: 10 | 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/shopee/search/shops?apiToken=xxxxxx&site=&keyword=zoom&page=1&pageSize=10'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "page": 1,
    "page_size": 5,
    "total_count": 37,
    "shops": [
      {
        "shop_id": 146137104,
        "shop_name": "Zoom Gadgets",
        "user_id": 146138928,
        "username": "zoom_gadgets",
        "country": "my",
        "followers": 8,
        "following": 3,
        "is_official_shop": false,
        "last_login_time": 1688212918,
        "all_items_count": 14,
        "rate_info": {
          "rating_star": 5,
          "rating_bad": 0,
          "rating_normal": 0,
          "rating_good": 1,
          "response_rate": 57,
          "response_time": null,
          "score": null
        },
        "is_shopee_verified": false,
        "status": 1
      },
      {
        "shop_id": 75213957,
        "shop_name": "ZOOM OUT",
        "user_id": 75215427,
        "username": "zoomoutmy",
        "country": "my",
        "followers": 11952,
        "following": 175,
        "is_official_shop": false,
        "last_login_time": 1688700243,
        "all_items_count": 171,
        "rate_info": {
          "rating_star": 4.962102,
          "rating_bad": 13,
          "rating_normal": 68,
          "rating_good": 9896,
          "response_rate": 99,
          "response_time": 6280,
          "score": null
        },
        "is_shopee_verified": true,
        "status": 1
      },
      {
        "shop_id": 85222283,
        "shop_name": "Mr.ZooM",
        "user_id": 85223760,
        "username": "abdzharif",
        "country": "my",
        "followers": 14,
        "following": 3,
        "is_official_shop": false,
        "last_login_time": 1688699720,
        "all_items_count": 10,
        "rate_info": {
          "rating_star": 5,
          "rating_bad": 0,
          "rating_normal": 0,
          "rating_good": 2,
          "response_rate": 25,
          "response_time": null,
          "score": null
        },
        "is_shopee_verified": false,
        "status": 1
      },
      {
        "shop_id": 123258274,
        "shop_name": "Zoom.ET",
        "user_id": 123260098,
        "username": "zishen8107",
        "country": "my",
        "followers": 2,
        "following": 14,
        "is_official_shop": false,
        "last_login_time": 1688693968,
        "all_items_count": 7,
        "rate_info": {
          "rating_star": null,
          "rating_bad": 0,
          "rating_normal": 0,
          "rating_good": 0,
          "response_rate": 13,
          "response_time": null,
          "score": null
        },
        "is_shopee_verified": false,
        "status": 1
      },
      {
        "shop_id": 767396976,
        "shop_name": "Zoom Warehouse",
        "user_id": 767380730,
        "username": "zoom.warehouse",
        "country": "my",
        "followers": 199,
        "following": 1,
        "is_official_shop": false,
        "last_login_time": 1688691380,
        "all_items_count": 35,
        "rate_info": {
          "rating_star": 4.875,
          "rating_bad": 0,
          "rating_normal": 3,
          "rating_good": 140,
          "response_rate": 12,
          "response_time": 22269,
          "score": null
        },
        "is_shopee_verified": false,
        "status": 1
      }
    ]
  }
}

```