# Shopee API - Search for Shopee products by keywords
## API Overview
- Search results list
- Total number of products
- Product details
- See More
## API URL
`GET https://api.tmapi.io/shopee/search/items/v2`
## Request Parameters
### Query
| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| site | string | Region name abbreviation, for example, Thailand is 'th'.
Optional values: `my`, `th`, `ph`, `id`, `vn`, `sg`, `tw`, `br`, `mx`, `co`, `cl`
Default value: my | false |
| keyword | string | Search keywords | true |
| by | string | Optional values: `pop`, `relevancy`, `ctime`, `sales`, `price`
Default value: relevancy | false |
| order | string | Optional values: `desc`, `asc`
Default value: desc | false |
| page | integer | Page number
Default value: 1 | false |
| pageSize | integer | Default value: 20 | false |
| cat_ids | string | Category IDs, separate multiple ids with commas | 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/shopee/search/items/v2?apiToken=xxxxxx&site=my&keyword=iphone&by=relevancy&order=desc&page=1&pageSize=20'
```
## Response Example
```json
{
"code": 200,
"msg": "success",
"data": {
"page": 1,
"page_size": 30,
"total_count": 202,
"total_ads_count": 0,
"has_next_page": true,
"max_count": 202,
"items": [
{
"item_id": 40313246304,
"shop_id": 1278832578,
"title": "Apple iPhone 17",
"img": "https://cf.shopee.com.my/file/sg-11134301-824gc-megbzrqg87ica4",
"main_imgs": [
"https://cf.shopee.com.my/file/sg-11134301-824gc-megbzrqg87ica4",
"https://cf.shopee.com.my/file/sg-11134301-824gi-megbwz85vny950",
"https://cf.shopee.com.my/file/sg-11134301-824jh-megbwz84h3id01",
"https://cf.shopee.com.my/file/sg-11134301-824j4-megbwzc6r6kj44",
"https://cf.shopee.com.my/file/sg-11134301-824i8-megbwz4jppfl47",
"https://cf.shopee.com.my/file/sg-11134301-824gx-megbwzbdzy10f6",
"https://cf.shopee.com.my/file/sg-11134301-824g9-megbwzcw9tz5e8",
"https://cf.shopee.com.my/file/sg-11134301-824jd-megbwz9sividd3",
"https://cf.shopee.com.my/file/sg-11134301-824h2-megc6vam641xc0"
],
"video_url": "https://mms.vod.susercontent.com/api/v4/11110105/mms/my-11110105-6v6x5-mejr2gv69ouc85.default.mp4",
"currency": "MYR",
"brand": "Apple",
"category_id": 100013,
"price_info": {
"price": "4998.9",
"price_min": "4998.9",
"price_max": "4999.0"
},
"shop_info": {
"shop_id": 1278832578,
"shop_location": "Selangor",
"shopee_verified": false,
"is_cb": false,
"is_official_shop": true,
"is_mart": false
},
"is_on_flash_sale": false,
"is_service_by_shopee": true,
"has_lowest_price_guarantee": true,
"discount": 1,
"size_chart": null,
"monthly_sold": 996,
"historical_sold": 1895,
"liked_count": 4000,
"comment_count": 665,
"is_adult": false,
"sku_props": [
{
"pid": "1",
"prop_name": "Colour",
"values": [
{
"vid": "1",
"name": "Lavender",
"imageUrl": "https://cf.shopee.com.my/file/sg-11134301-824gi-megbwz85vny950"
},
{
"vid": "2",
"name": "Sage",
"imageUrl": "https://cf.shopee.com.my/file/sg-11134301-824je-megc1ibenls47f"
},
{
"vid": "3",
"name": "Mist Blue",
"imageUrl": "https://cf.shopee.com.my/file/sg-11134301-824hp-megc1mghwykm3a"
},
{
"vid": "4",
"name": "White",
"imageUrl": "https://cf.shopee.com.my/file/sg-11134301-824he-megc1pfwda12cf"
},
{
"vid": "5",
"name": "Black",
"imageUrl": "https://cf.shopee.com.my/file/sg-11134301-824is-megc1rvy87wj20"
}
]
},
{
"pid": "2",
"prop_name": "Storage",
"values": [
{
"vid": "1",
"name": "256GB",
"imageUrl": ""
},
{
"vid": "2",
"name": "512GB",
"imageUrl": ""
}
]
}
],
"ctime": 1755252796,
"stock": 1,
"item_status": "normal"
},
{
"item_id": 43865095343,
"shop_id": 304504082,
"title": "Apple iPhone 17 (ETA: 2 days - 2 weeks)",
"img": "https://cf.shopee.com.my/file/my-11134211-820li-mejmo9jc11xh49",
"main_imgs": [
"https://cf.shopee.com.my/file/my-11134211-820li-mejmo9jc11xh49",
"https://cf.shopee.com.my/file/my-11134211-820l5-mejmo9j7mbr70d",
"https://cf.shopee.com.my/file/my-11134211-820le-mejmo9j7nqbndd",
"https://cf.shopee.com.my/file/my-11134211-820li-mejmo9j7kx6re6",
"https://cf.shopee.com.my/file/my-11134211-820la-mejmo9j7p4w3a1",
"https://cf.shopee.com.my/file/my-11134207-820l9-megve8zp2neodb",
"https://cf.shopee.com.my/file/my-11134207-820l9-megve8wo7myqe2",
"https://cf.shopee.com.my/file/my-11134207-820lb-megve8wo91j6f4",
"https://cf.shopee.com.my/file/my-11134207-820la-megve8wn8irpca"
],
"video_url": "",
"currency": "MYR",
"brand": "Apple",
"category_id": 100013,
"price_info": {
"price": "3999.0",
"price_min": "3999.0",
"price_max": "4999.0"
},
"shop_info": {
"shop_id": 304504082,
"shop_location": "Selangor",
"shopee_verified": false,
"is_cb": false,
"is_official_shop": true,
"is_mart": false
},
"is_on_flash_sale": false,
"is_service_by_shopee": false,
"has_lowest_price_guarantee": false,
"discount": 0,
"size_chart": null,
"monthly_sold": 274,
"historical_sold": 694,
"liked_count": 2989,
"comment_count": 286,
"is_adult": false,
"sku_props": [
{
"pid": "1",
"prop_name": "Color",
"values": [
{
"vid": "1",
"name": "Lavender",
"imageUrl": "https://cf.shopee.com.my/file/my-11134207-820l5-megve90a6kn670"
},
{
"vid": "2",
"name": "White",
"imageUrl": "https://cf.shopee.com.my/file/my-11134207-820l6-megve8wnl5vla5"
},
{
"vid": "3",
"name": "Mist Blue",
"imageUrl": "https://cf.shopee.com.my/file/my-11134207-820lg-megve8xnu3gn33"
},
{
"vid": "4",
"name": "Black",
"imageUrl": "https://cf.shopee.com.my/file/my-11134207-820l9-megve91e7rb696"
},
{
"vid": "5",
"name": "Sage",
"imageUrl": "https://cf.shopee.com.my/file/my-11134207-820l5-megve90u75z697"
}
]
},
{
"pid": "2",
"prop_name": "Capacity",
"values": [
{
"vid": "1",
"name": "256GB",
"imageUrl": ""
},
{
"vid": "2",
"name": "512GB",
"imageUrl": ""
}
]
}
],
"ctime": 1756180136,
"stock": 1,
"item_status": "normal"
},
{
"item_id": 43065687776,
"shop_id": 304509804,
"title": "[Pre Order] Apple iPhone 17",
"img": "https://cf.shopee.com.my/file/my-11134207-820lg-mejpyc024wlddc",
"main_imgs": [
"https://cf.shopee.com.my/file/my-11134207-820lg-mejpyc024wlddc",
"https://cf.shopee.com.my/file/my-11134207-820le-mejpyc07ve2q33",
"https://cf.shopee.com.my/file/my-11134207-820lh-mejpyc08dngjd4",
"https://cf.shopee.com.my/file/my-11134207-820lh-mejpyc01ct8m92",
"https://cf.shopee.com.my/file/my-11134207-820la-mejpyc0bdt6u68",
"https://cf.shopee.com.my/file/my-11134207-7rasa-mdct7u4hifxrc5"
],
"video_url": "",
"currency": "MYR",
"brand": "Apple",
"category_id": 100013,
"price_info": {
"price": "3999.0",
"price_min": "3999.0",
"price_max": "4998.0"
},
"shop_info": {
"shop_id": 304509804,
"shop_location": "Selangor",
"shopee_verified": false,
"is_cb": false,
"is_official_shop": true,
"is_mart": false
},
"is_on_flash_sale": false,
"is_service_by_shopee": false,
"has_lowest_price_guarantee": true,
"discount": 1,
"size_chart": null,
"monthly_sold": 744,
"historical_sold": 1702,
"liked_count": 2996,
"comment_count": 664,
"is_adult": false,
"sku_props": [
{
"pid": "1",
"prop_name": "Colour",
"values": [
{
"vid": "1",
"name": "Black",
"imageUrl": "https://cf.shopee.com.my/file/my-11134207-820l5-megmot65plvm77"
},
{
"vid": "2",
"name": "White",
"imageUrl": "https://cf.shopee.com.my/file/my-11134207-820le-megmpeh8nuv7c9"
},
{
"vid": "3",
"name": "Mist Blue",
"imageUrl": "https://cf.shopee.com.my/file/my-11134207-820lg-megmph34r30n4e"
},
{
"vid": "4",
"name": "Lavender",
"imageUrl": "https://cf.shopee.com.my/file/my-11134207-820lh-megmpjd0zhmpe7"
},
{
"vid": "5",
"name": "Sage",
"imageUrl": "https://cf.shopee.com.my/file/my-11134207-820li-megmpmpaieiuf3"
}
]
},
{
"pid": "2",
"prop_name": "Capacity",
"values": [
{
"vid": "1",
"name": "256GB",
"imageUrl": ""
},
{
"vid": "2",
"name": "512GB",
"imageUrl": ""
}
]
}
],
"ctime": 1756453485,
"stock": 1,
"item_status": "normal"
}
]
}
}
```