参数说明
通用参数说明
version:API版本
key:调用key,测试key:test_api_key
api_name:API类型[item_search,item_get]
cache:[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type:[json,xml,serialize,var_export]返回数据格式，默认为json
lang:[cn,en,ru] 翻译语言，默认cn简体中文
API:item_search 参数说明: q:搜索关键词 cat:分类ID start_price:开始价格 end_price:结束
价格 sort:排序 page:
API:item_get 参数说明: num_iid:商品id【num_iid=1520294】
shopee.item_search
公共参数
名称 类型 必须 描述
key String 是 调用key（必须以GET方式拼接在URL中）
secret String 是 调用密钥（接口v，18870288846；）
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 宝贝链接
请求示例
请求示例（Curl、PHP、PHPsdk、JAVA、C#、Python...）
#include<iostream>
#include<string>
#include<curl/curl.h>
using namespace std;
static size_t Data(void *ptr, size_t size, size_t nmemb, string *stream)
{
std::size_t realSize = size *nmemb;
auto *realPtr = reinterpret_cast<char *>(ptr);
for (std::size_t i=0;i<realSize;++i) {
*(stream) += *(realPtr + i);
}
return realSize;
}
int main(){
CURL *curl;
CURLcode result;
string readBuffer;
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "v,x；18870288846/key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=dress&page=1&sort=&country=.com.my");
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, Data);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &readBuffer);
result = curl_easy_perform(curl);
if(result == CURLE_OK) {
cout<<readBuffer<<endl;
}else{
cerr<<"curl_easy error:"<<curl_easy_strerror(result)<<endl;
}
curl_easy_cleanup(curl);
}
return 0;
}
响应示例
{
"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"
}
文章内容有限，欢迎私信沟通交流。