一、参数
公共参数
请求地址: https://api-/shopee/item_search（前往获取key和secret）
请求参数
请求参数：q=dress&page=1&sort=&country=.com.my
参数说明：q:搜索关键词-country:网站后缀（.com.my;.vn;.ph）,
sort:排序[bid,_bid,_sale,new]
(bid:总价,sale:销量,new:新品,加_前缀为从大到小排序)
page:页数
响应参数
Version: Date:
二、示例
请求示例
CurlPHPPHPsdkJAVAC#Python<?php// 请求示例 url 默认请求参数已经URL编码处理// 本示例代码未加密secret参数明文传输，若要加密请参考：/help/demo/sdk/demo-sign.php$method = "GET";$url = "https://api-/shopee/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=dress&page=1&sort=&country=.com.my";$curl = curl_init();curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);curl_setopt($curl, CURLOPT_URL, $url);curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);curl_setopt($curl, CURLOPT_FAILONERROR, false);curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);curl_setopt($curl, CURLOPT_HEADER, true);curl_setopt($curl, CURLOPT_ENCODING, "gzip");var_dump(curl_exec($curl));?>
响应示例
{"items": {"url": ".my/search?keyword=dress","keyword": "dress","list_page": "1","real_total_results": "4269453","total_results": 5000,"pagecount": 100,"current_lang": "en","currency_code": "MYR","item": [{"title": "COLOUR","pic_url": ".my/file/79ec29aaa306ec1defd6bd555967702d","price": 38.9,"promotion_price": 0,"price_range": 0,"num_iid": "277113808/4577557680","shop_id": "277113808","sales": 293,"area": "Kelantan","detail_url": ".my/product/277113808/4577557680"},{"title": "Color ","pic_url": ".my/file/bcad44beb00c73a6e4521d6a9d9f5c27","price": 48,"promotion_price": 109,"price_range": 0,"num_iid": "54302529/6310239196","shop_id": "54302529","sales": 439,"area": "Selangor","detail_url": ".my/product/54302529/6310239196"},{"title": "COLOUR","pic_url": ".my/file/79ec29aaa306ec1defd6bd555967702d","price": 38.9,"promotion_price": 0,"price_range": 0,"num_iid": "277113808/4577557680","shop_id": "277113808","sales": 293,"area": "Kelantan","detail_url": ".my/product/277113808/4577557680"},{"title": "COLOUR","pic_url": ".my/file/f22290486f37305dbee21e25824894dc","price": 18.9,"promotion_price": 50,"price_range": 0,"num_iid": "78566717/203919","shop_id": "78566717","sales": 887,"area": "Mainland China","detail_url": ".my/product/78566717/203919"},{"title": "Color","pic_url": ".my/file/69ddc45fbedfb8eb054c915199cfda99","price": 25.26,"promotion_price": 0,"price_range": 0,"num_iid": "240981936/3767955639","shop_id": "240981936","sales": 22,"area": "Indonesia","detail_url": ".my/product/240981936/3767955639"},{"title": "Color","pic_url": ".my/file/531b217d8c9c23844a27c43e8dd4f7c0","price": 18.9,"promotion_price": 21,"price_range": 0,"num_iid": "390574271/8216725690","shop_id": "390574271","sales": 0,"area": "Mainland China","detail_url": ".my/product/390574271/8216725690"},{"title": "option1","pic_url": ".my/file/c7aa7707e693d01279879e2e2f04","price": 32,"promotion_price": 53.34,"price_range": 0,"num_iid": "26973388/5351395820","shop_id": "26973388","sales": 1271,"area": "Mainland China","detail_url": ".my/product/26973388/5351395820"},{"title": "Color ","pic_url": ".my/file/bcad44beb00c73a6e4521d6a9d9f5c27","price": 48,"promotion_price": 109,"price_range": 0,"num_iid": "54302529/6310239196","shop_id": "54302529","sales": 439,"area": "Selangor","detail_url": ".my/product/54302529/6310239196"},{"title": "colour","pic_url": ".my/file/e5bc52ad097fbdfbaaaf2eae3da39880","price": 23.9,"promotion_price": 48,"price_range": 0,"num_iid": "118973108/5244061133","shop_id": "118973108","sales": 268,"area": "Mainland China","detail_url": ".my/product/118973108/5244061133"},{"title": "Color","pic_url": ".my/file/c48b6ca6496ed80ba47c0a21a8b243ce","price": 26,"promotion_price": 42,"price_range": 0,"num_iid": "368772413/4773662993","shop_id": "368772413","sales": 0,"area": "Mainland China","detail_url": ".my/product/368772413/4773662993"},{"title": "Color","pic_url": ".my/file/16a71110a030cfe43bfb617b6bc32abb","price": 10.24,"promotion_price": 10.34,"price_range": 0,"num_iid": "273313466/4038282148","shop_id": "273313466","sales": 132,"area": "Indonesia","detail_url": ".my/product/273313466/4038282148"},{"title": "\u989c\u8272","pic_url": ".my/file/1a8c372af4c52b11717ab4f0ffb9c00b","price": 16,"promotion_price": 32,"price_range": 0,"num_iid": "166802812/2619757261","shop_id": "166802812","sales": 38,"area": "Mainland China","detail_url": ".my/product/166802812/2619757261"},{"title": "COLOR","pic_url": ".my/file/3eca8b3323a29f999504b394f6b30c56","price": 24.29,"promotion_price": 35.63,"price_range": 0,"num_iid": "240979832/3627357801","shop_id": "240979832","sales": 6,"area": "Indonesia","detail_url": ".my/product/240979832/3627357801"},{"title": "Color","pic_url": ".my/file/27cda947ff9286b7d5a4e7923b06ccdd","price": 18,"promotion_price": 20,"price_range": 0,"num_iid": "390574271/8316886597","shop_id": "390574271","sales": 2,"area": "Mainland China","detail_url": ".my/product/390574271/8316886597"},{"title": "Color","pic_url": ".my/file/4ce9ba7aec97238b6552a9f0d124d0d6","price": 16.75,"promotion_price": 22.4,"price_range": 0,"num_iid": "240873459/6332529823","shop_id": "240873459","sales": 120,"area": "Indonesia","detail_url": ".my/product/240873459/6332529823"},{"title": "Color","pic_url": ".my/file/610dfbe249afa5afaa2947338f57b849","price": 29.8,"promotion_price": 54.29,"price_range": 0,"num_iid": "116989194/7643529171","shop_id": "116989194","sales": 1,"area": "Mainland China","detail_url": ".my/product/116989194/7643529171"},{"title": "Variasi","pic_url": ".my/file/78dd16816995d5094e6ccce39fe2ab52","price": 34,"promotion_price": 0,"price_range": 0,"num_iid": "30168757/2120468722","shop_id": "30168757","sales": 94,"area": "Kelantan","detail_url": ".my/product/30168757/2120468722"},{"title": "Colour","pic_url": ".my/file/e01a4687db19ab188aacb930a41771a7","price": 16.9,"promotion_price": 27.8,"price_range": 0,"num_iid": "272814704/3152795864","shop_id": "272814704","sales": 257,"area": "Mainland China","detail_url": ".my/product/272814704/3152795864"},{"title": "Color","pic_url": ".my/file/12ecc59c016ce51740b45e5455af1bfc","price": 15,"promotion_price": 28.75,"price_range": 0,"num_iid": "294988554/3548057895","shop_id": "294988554","sales": 176,"area": "Mainland China","detail_url": ".my/product/294988554/3548057895"},{"title": "colour","pic_url": ".my/file/505f3e0cf78e9c94fe473e0cc1016946","price": 59.8,"promotion_price": 92.86,"price_range": 0,"num_iid": "311778196/7857696922","shop_id": "311778196","sales": 1,"area": "Mainland China","detail_url": ".my/product/311778196/7857696922"},{"title": "Color","pic_url": ".my/file/fa8cb30e3150087d07f7a5e967a861e9","price": 35.9,"promotion_price": 359,"price_range": 0,"num_iid": "26973388/3159579136","shop_id": "26973388","sales": 161,"area": "Mainland China","detail_url": ".my/product/26973388/3159579136"},{"title": "Color","pic_url": ".my/file/f35b103b9b494eb9619a4057742efc0a","price": 80,"promotion_price": 0,"price_range": 0,"num_iid": "12320460/7013179933","shop_id": "12320460","sales": 0,"area": "Johor","detail_url": ".my/product/12320460/7013179933"},{"title": "Color","pic_url": ".my/file/6bf33fda1f38bae6378d861886ae2e8f","price": 16.39,"promotion_price": 0,"price_range": 0,"num_iid": "273313598/7238332374","shop_id": "273313598","sales": 65,"area": "Indonesia","detail_url": ".my/product/273313598/7238332374"},{"title": "Size","pic_url": ".my/file/23fc72ee140222c60c2a01765ffa05f7","price": 23.4,"promotion_price": 39,"price_range": 0,"num_iid": "68712033/2255244034","shop_id": "68712033","sales": 64,"area": "Mainland China","detail_url": ".my/product/68712033/2255244034"},{"title": "Moscrepe Aluna","pic_url": ".my/file/4c912ac2ad3cda4529ceba861f31ff28","price": 30.25,"promotion_price": 40.1,"price_range": 0,"num_iid": "240979181/3825017904","shop_id": "240979181","sales": 26,"area": "Indonesia","detail_url": ".my/product/240979181/3825017904"},{"title": "\u989c\u8272","pic_url": ".my/file/14de9cc56c7a6a0fbae96d761f41e4d0","price": 16.5,"promotion_price": 55,"price_range": 0,"num_iid": "364991146/5578503551","shop_id": "364991146","sales": 0,"area": "Mainland China","detail_url": ".my/product/364991146/5578503551"},{"title": "Color","pic_url": ".my/file/51e95bf0b8422f67ed2e4e47151e2d9d","price": 37.9,"promotion_price": 0,"price_range": 0,"num_iid": "8004/7278146503","shop_id": "8004","sales": 130,"area": "Kelantan","detail_url": ".my/product/8004/7278146503"},{"title": "colour","pic_url": ".my/file/a5982e8e7b00385880b70460e66cf979","price": 29.9,"promotion_price": 65,"price_range": 0,"num_iid": "85110711/3547753198","shop_id": "85110711","sales": 204,"area": "Mainland China","detail_url": ".my/product/85110711/3547753198"},{"title": "Color","pic_url": ".my/file/cb80c011268dc3b328e721eaa319828e","price": 17.8,"promotion_price": 26.65,"price_range": 0,"num_iid": "50941176/5757678929","shop_id": "50941176","sales": 279,"area": "Mainland China","detail_url": ".my/product/50941176/5757678929"},{"title": "Color","pic_url": ".my/file/f4f66325663acd2a7621dfcacf5b9048","price": 26,"promotion_price": 54,"price_range": 0,"num_iid": "153111370/7577984519","shop_id": "153111370","sales": 9,"area": "Mainland China","detail_url": ".my/product/153111370/7577984519"},{"title": "Color","pic_url": ".my/file/f995bc98ccfc9bafc7d019574439bb69","price": 12.19,"promotion_price": 21.14,"price_range": 0,"num_iid": "240873459/5232553407","shop_id": "240873459","sales": 41,"area": "Indonesia","detail_url": ".my/product/240873459/5232553407"},{"title": "option1","pic_url": ".my/file/fad83fed4fab8d040ffc4450aef600ef","price": 33,"promotion_price": 0,"price_range": 0,"num_iid": "26973388/3625841277","shop_id": "26973388","sales": 31,"area": "Mainland China","detail_url": ".my/product/26973388/3625841277"},{"title": "color","pic_url": ".my/file/5c566443083012c92cfdd255bb116e36","price": 28.7,"promotion_price": 41,"price_range": 0,"num_iid": "269975455/7360159652","shop_id": "269975455","sales": 4,"area": "Selangor","detail_url": ".my/product/269975455/7360159652"},{"title": "colour","pic_url": ".my/file/2c27504fb4455666c3f451538d0dc16d","price": 28.17,"promotion_price": 281.7,"price_range": 0,"num_iid": "296705887/6053171855","shop_id": "296705887","sales": 0,"area": "Mainland China","detail_url": ".my/product/296705887/6053171855"},{"title": "colour","pic_url": ".my/file/27b4c073e90d04b7f57f0b62a46e9a4e","price": 18.8,"promotion_price": 50,"price_range": 0,"num_iid": "85110711/2263563999","shop_id": "85110711","sales": 423,"area": "Mainland China","detail_url": ".my/product/85110711/2263563999"},{"title": "Warna","pic_url": ".my/file/c9d7f3f8c8ca8de0c3556a1a9cbeded5","price": 35.9,"promotion_price": 0,"price_range": 0,"num_iid": "76724328/4548751809","shop_id": "76724328","sales": 410,"area": "Kelantan","detail_url": ".my/product/76724328/4548751809"},{"title": "colour","pic_url": ".my/file/1f85b2cf192acd20a26142dd4ab9fbee","price": 29.9,"promotion_price": 69,"price_range": 0,"num_iid": "78566717/5745307039","shop_id": "78566717","sales": 273,"area": "Mainland China","detail_url": ".my/product/78566717/5745307039"},{"title": "Color","pic_url": ".my/file/30723f5141f74cced951319a2924c235","price": 29.92,"promotion_price": 34,"price_range": 0,"num_iid": "392471109/8222833825","shop_id": "392471109","sales": 0,"area": "Mainland China","detail_url": ".my/product/392471109/8222833825"},{"title": "Color","pic_url": ".my/file/2130c2b2b37eed64f3c064bd166f62f3","price": 47.99,"promotion_price": 0,"price_range": 0,"num_iid": "241096510/6224823482","shop_id": "241096510","sales": 2,"area": "Indonesia","detail_url": ".my/product/241096510/6224823482"},{"title": "option1","pic_url": ".my/file/f1648e0a9f0132489995670aafff02d1","price": 38.5,"promotion_price": 96.25,"price_range": 0,"num_iid": "26973388/7254299229","shop_id": "26973388","sales": 162,"area": "Mainland China","detail_url": ".my/product/26973388/7254299229"},{"title": "Color","pic_url": ".my/file/5293afb8d03bfe7e58fe77ab638fd28d","price": 10.99,"promotion_price": 29.6,"price_range": 0,"num_iid": "190633906/4957517903","shop_id": "190633906","sales": 164,"area": "Penang","detail_url": ".my/product/190633906/4957517903"},{"title": "colour","pic_url": ".my/file/556318a4800946f504aeadd08343c002","price": 12.99,"promotion_price": 0,"price_range": 0,"num_iid": "315952398/4775083030","shop_id": "315952398","sales": 5,"area": "Selangor","detail_url": ".my/product/315952398/4775083030"},{"title": "\u5c3a\u7801","pic_url": ".my/file/81aabf540b0657fa45266cf222b8d214","price": 41.9,"promotion_price": 69.82,"price_range": 0,"num_iid": "91416052/2128812451","shop_id": "91416052","sales": 5,"area": "Mainland China","detail_url": ".my/product/91416052/2128812451"},{"title": "COLOR","pic_url": ".my/file/9b33c95178bd0ccaf23e5c784f29d1a1","price": 36.99,"promotion_price": 70,"price_range": 0,"num_iid": "190633906/4065896254","shop_id": "190633906","sales": 6,"area": "Penang","detail_url": ".my/product/190633906/4065896254"},{"title": "size","pic_url": ".my/file/dcd31f57e2e3984536c773d161a8bed1","price": 23.9,"promotion_price": 43.5,"price_range": 0,"num_iid": "3138/2911032143","shop_id": "3138","sales": 116,"area": "Mainland China","detail_url": ".my/product/3138/2911032143"},{"title": "\u989c\u8272\u5206\u7c7b","pic_url": ".my/file/a9023f8d8be2fbcc1a938bcfc7b27512","price": 48.3,"promotion_price": 69,"price_range": 0,"num_iid": "378874096/6679043850","shop_id": "378874096","sales": 0,"area": "Mainland China","detail_url": ".my/product/378874096/6679043850"},{"title": "Color","pic_url": ".my/file/848c826842b59b27c1b31dabd653efa9","price": 16.99,"promotion_price": 42,"price_range": 0,"num_iid": "274849642/6957372204","shop_id": "274849642","sales": 262,"area": "Penang","detail_url": ".my/product/274849642/6957372204"},{"title": "Color","pic_url": ".my/file/8f9a01874b165a4e00776cbf60500885","price": 17.99,"promotion_price": 28.47,"price_range": 0,"num_iid": "25923976/4138240940","shop_id": "25923976","sales": 9,"area": "Mainland China","detail_url": ".my/product/25923976/4138240940"},{"title": "Color","pic_url": ".my/file/e1bc892a6ccbde64603240fb27541359","price": 19.6,"promotion_price": 28,"price_range": 0,"num_iid": "279153738/5849377285","shop_id": "279153738","sales": 32,"area": "Mainland China","detail_url": ".my/product/279153738/5849377285"},{"title": "Color","pic_url": ".my/file/22de9f90c55e72d3f44d918c7dd4f36a","price": 24.88,"promotion_price": 47,"price_range": 0,"num_iid": "131857747/3561843082","shop_id": "131857747","sales": 76,"area": "Mainland China","detail_url": ".my/product/131857747/3561843082"}]},"error_code": "0000","reason": "ok","secache": "c223e77fc7d95dc48aa390259d5198a8","secache_time": 1615425217,"secache_date": "-03-11 09:13:37","translate_status": "","translate_time": 0,"language": {"default_lang": "cn","current_lang": "cn"},"error": "","cache": 0,"api_info": "today:2 max:10000","execution_time": 3.715,"server_time": "Beijing/-03-11 09:13:37","client_ip": "106.6.35.144","call_args": {"q": "dress","start_price": "1","page": ".com.my"},"api_type": "shopee","translate_language": "zh-CN","translate_engine": "baidu","server_memory": "3.07MB","request_id": "gw-1.60496ebd9ed56"}
异常示例
{"error": "item-not-found","reason": "商品没找到","error_code": "2000","success": 0,"cache": 0,"api_info": "today:0 max:10000","execution_time": 0.081,"server_time": "Beijing/-06-10 23:44:00","call_args": [],"api_type": "taobao","request_id": "15ee0ffc041242"}
