关键词搜索商品API接口在电商平台中具有重要的作用,可以提供精准搜索、增加用户转化率、优化用户体验、精准广告投放以及市场调研和商品策划等功能。这些功能有助于提高用户的购物体验、提升电商平台的竞争力,并增加用户的忠诚度和购买意愿。
公共参数
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
请求参数
请求参数: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:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
items |
item[] | 0 | 根据关键词取商品列表 | |
title |
String | 0 | Real Shot Long Dress Female Summer New Womens Waist Slimming Dress Summer Temperament Dress Popular Fake Two-Piece Dres | 商品标题 |
pic_url |
String | 0 | https://cf.shopee.com.my/file/902d7fd4f24d056d89163e4f32fcc8c2 | 宝贝图片 |
promotion_price |
Float | 0 | 82.00 | 优惠价 |
price_range |
Float | 0 | 0 | 折扣价 |
price |
Float | 0 | 82.00 | 价格 |
sales |
Int | 0 | 0 | 销量 |
num_iid |
Bigint | 0 | 334425154/8200081234 | 宝贝ID |
shop_id |
Bigint | 0 | 334425154 | 店铺ID |
area |
String | 0 | Kuala Lumpur | 店铺所在地 |
detail_url |
String | 0 | https://shopee.com.my/product/334425154/8200081234 | 宝贝链接 |
响应示例
{
"items": {
"url": "https://shopee.com.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": "https://cf.shopee.com.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": "https://shopee.com.my/product/277113808/4577557680"
},
{
"title": "Color ",
"pic_url": "https://cf.shopee.com.my/file/bcad44beb00c73a6e4521d6a9d9f5c27",
"price": 48,
"promotion_price": 109,
"price_range": 0,
"num_iid": "54302529/6310239196",
"shop_id": "54302529",
"sales": 439,
"area": "Selangor",
"detail_url": "https://shopee.com.my/product/54302529/6310239196"
},
{
"title": "COLOUR",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/277113808/4577557680"
},
{
"title": "COLOUR",
"pic_url": "https://cf.shopee.com.my/file/f22290486f37305dbee21e25824894dc",
"price": 18.9,
"promotion_price": 50,
"price_range": 0,
"num_iid": "78566717/2019203919",
"shop_id": "78566717",
"sales": 887,
"area": "Mainland China",
"detail_url": "https://shopee.com.my/product/78566717/2019203919"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/240981936/3767955639"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/390574271/8216725690"
},
{
"title": "option1",
"pic_url": "https://cf.shopee.com.my/file/c7aa7707e693d01279879e2e2f042009",
"price": 32,
"promotion_price": 53.34,
"price_range": 0,
"num_iid": "26973388/5351395820",
"shop_id": "26973388",
"sales": 1271,
"area": "Mainland China",
"detail_url": "https://shopee.com.my/product/26973388/5351395820"
},
{
"title": "Color ",
"pic_url": "https://cf.shopee.com.my/file/bcad44beb00c73a6e4521d6a9d9f5c27",
"price": 48,
"promotion_price": 109,
"price_range": 0,
"num_iid": "54302529/6310239196",
"shop_id": "54302529",
"sales": 439,
"area": "Selangor",
"detail_url": "https://shopee.com.my/product/54302529/6310239196"
},
{
"title": "colour",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/118973108/5244061133"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/368772413/4773662993"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/273313466/4038282148"
},
{
"title": "\u989c\u8272",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/166802812/2619757261"
},
{
"title": "COLOR",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/240979832/3627357801"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/390574271/8316886597"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/240873459/6332529823"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/116989194/7643529171"
},
{
"title": "Variasi",
"pic_url": "https://cf.shopee.com.my/file/78dd16816995d5094e6ccce39fe2ab52",
"price": 34,
"promotion_price": 0,
"price_range": 0,
"num_iid": "30168757/2120468722",
"shop_id": "30168757",
"sales": 94,
"area": "Kelantan",
"detail_url": "https://shopee.com.my/product/30168757/2120468722"
},
{
"title": "Colour",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/272814704/3152795864"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/294988554/3548057895"
},
{
"title": "colour",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/311778196/7857696922"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/26973388/3159579136"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.my/file/f35b103b9b494eb9619a4057742efc0a",
"price": 80,
"promotion_price": 0,
"price_range": 0,
"num_iid": "12320460/7013179933",
"shop_id": "12320460",
"sales": 0,
"area": "Johor",
"detail_url": "https://shopee.com.my/product/12320460/7013179933"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/273313598/7238332374"
},
{
"title": "Size",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/68712033/2255244034"
},
{
"title": "Moscrepe Aluna",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/240979181/3825017904"
},
{
"title": "\u989c\u8272",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/364991146/5578503551"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.my/file/51e95bf0b8422f67ed2e4e47151e2d9d",
"price": 37.9,
"promotion_price": 0,
"price_range": 0,
"num_iid": "80042016/7278146503",
"shop_id": "80042016",
"sales": 130,
"area": "Kelantan",
"detail_url": "https://shopee.com.my/product/80042016/7278146503"
},
{
"title": "colour",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/85110711/3547753198"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/50941176/5757678929"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/153111370/7577984519"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/240873459/5232553407"
},
{
"title": "option1",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/26973388/3625841277"
},
{
"title": "color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/269975455/7360159652"
},
{
"title": "colour",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/296705887/6053171855"
},
{
"title": "colour",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/85110711/2263563999"
},
{
"title": "Warna",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/76724328/4548751809"
},
{
"title": "colour",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/78566717/5745307039"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/392471109/8222833825"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/241096510/6224823482"
},
{
"title": "option1",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/26973388/7254299229"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/190633906/4957517903"
},
{
"title": "colour",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/315952398/4775083030"
},
{
"title": "\u5c3a\u7801",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/91416052/2128812451"
},
{
"title": "COLOR",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/190633906/4065896254"
},
{
"title": "size",
"pic_url": "https://cf.shopee.com.my/file/dcd31f57e2e3984536c773d161a8bed1",
"price": 23.9,
"promotion_price": 43.5,
"price_range": 0,
"num_iid": "31201638/2911032143",
"shop_id": "31201638",
"sales": 116,
"area": "Mainland China",
"detail_url": "https://shopee.com.my/product/31201638/2911032143"
},
{
"title": "\u989c\u8272\u5206\u7c7b",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/378874096/6679043850"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/274849642/6957372204"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/25923976/4138240940"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/279153738/5849377285"
},
{
"title": "Color",
"pic_url": "https://cf.shopee.com.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": "https://shopee.com.my/product/131857747/3561843082"
}
]
},
"error_code": "0000",
"reason": "ok",
"secache": "c223e77fc7d95dc48aa390259d5198a8",
"secache_time": 1615425217,
"secache_date": "2021-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/2021-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"
}