店铺流量排名数据接口
接口信息
-
接口名称: 获取店铺流量排名数据
-
请求方法: POST
-
接口地址:
/open-api/v1/data -
接口路径:
/v3/api/open/store/rank-data -
接口描述: 获取指定店铺的网站流量排名数据,包括全球排名、国家排名、分类排名等信息。数据来源于第三方流量分析工具SimilarWeb,可用于评估店铺网站的流量表现和行业地位。注意:并非所有店铺都有流量排名数据,对于流量较小或新建立的网站,可能返回空数据。
-
价格说明:
免费请求头: -
Content-Type: application/json
-
Accept: application/json
请求参数
请求结构
| 参数名 | 类型 | 描述 | 示例 | 必填 | 默认值 |
|---|---|---|---|---|---|
key | string | 用户申请的外部 api 请求 key | "your_api_key_here" | 是 | |
uri | string | 接口路径 | "/v3/api/open/store/rank-data" | 是 | |
params | object | 接口入参对象 | 见参数列表 | 是 |
请求体参数 (params 对象)
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
id | String | 是 | - | 店铺 ID 为 13 位字符串(例如: c2d5b2547218a),对应店铺榜单列表接口返回结果中的 store_id 字段 |
请求示例
curl -X POST "https://www.pipispy.com/open-api/v1/data" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"key": "your_api_key_here",
"uri": "/v3/api/open/store/rank-data",
"params": {
"id": "9407a696eb444"
}
}'
响应参数
响应体结构
{
"code": 200,
"message": "success",
"data": {
"data": {}
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 0,
"success": true,
"fail": false
}
响应字段说明
| 字段名 | 类型 | 描述 |
|---|---|---|
code | Integer | 响应状态码,200 表示成功 |
message | String | 响应消息描述 |
data | Object | 响应数据主体 |
data.data | Object | 店铺流量排名数据对象(SimilarWeb数据) |
version | String | API 版本号 |
timestamp | String | 响应时间戳 |
sign | String | 响应签名(预留字段) |
remaining_credits | Long | 当前请求后的剩余可用积分 |
consumed_credits | Long | 本次请求消耗的积分 |
success | Boolean | 请求是否成功的布尔值 |
fail | Boolean | 请求是否失败的布尔值 |
流量排名数据字段 (data.data)
此对象包含来自SimilarWeb的网站流量排名数据。以下是完整的字段说明:
基础信息字段
| 字段名 | 类型 | 描述 |
|---|---|---|
SiteName | String | 网站域名。去除协议头的纯域名,如"kuose.com" |
Title | String | 网站标题。从网站HTML的 <title>标签提取 |
Description | String | 网站描述。简要描述网站内容,通常从Meta Description提取 |
Category | String | 网站所属类目。格式为"一级类目/二级类目",如"lifestyle/fashion_and_apparel"。类目使用小写字母和下划线分隔 |
LargeScreenshot | String | 网站截图URL。完整的CDN图片地址,用于展示网站首页截图 |
SnapshotDate | String | 数据快照日期。ISO 8601格式的日期时间字符串,表示此次数据采集的时间点 |
Version | Integer | 数据版本号。用于标识数据格式的版本 |
IsSmall | Boolean | 是否为小流量网站。true表示月访问量较低(通常<5000),false表示中等或高流量网站 |
IsDataFromGa | Boolean | 数据是否来源于Google Analytics。true表示数据来自GA,false表示来自SimilarWeb自有数据源 |
Policy | Integer | 策略标识。用于系统内部标记数据处理策略 |
update_time | Long | 数据更新时间。Unix时间戳(秒级),表示数据在系统中最后一次更新的时间 |
next_update_time | Long | 下次更新时间。Unix时间戳(秒级),表示预计下次数据刷新的时间 |
排名相关字段
| 字段名 | 类型 | 描述 |
|---|---|---|
GlobalRank | Object | 全球排名对象。包含 Rank字段,表示该网站在全球所有网站中的流量排名位次。数值越小排名越靠前。例如:{"Rank": 179954}表示全球排名第179,954位。此指标用于评估网站的全球影响力 |
GlobalCategoryRank | Object/Null | 全球类目排名对象。包含该网站在全球范围内特定类目的排名。如果网站未被分配类目排名,则为null |
CategoryRank | Object | 类目排名对象。包含两个字段: Category(类目名称,如"Lifestyle/Fashion_and_Apparel")和Rank(该类目内的排名数值,如"2409"表示该类目排名第2409位)。此指标用于评估网站在垂直领域的竞争力 |
CountryRank | Object | 主要国家排名对象。包含三个字段: Country(国家代码数字,如840代表美国)、Rank(该国家的排名数值)、CountryCode(ISO 3166-1 alpha-2标准的国家代码,如"US")。表示该网站在主要访问来源国的排名位次 |
流量与访问数据字段
| 字段名 | 类型 | 描述 |
|---|---|---|
EstimatedMonthlyVisits | Object | 近期月访问量趋势对象。键为Unix时间戳(秒级),值为该月的访问量数值。通常包含最近3个月的数据。例如: {"1754006400": 181479, "1756684800": 157196, "1759276800": 183701}表示三个月的访问量分别为181,479、157,196和183,701 |
Engagments | Object | 用户参与度指标对象(注意拼写为Engagments)。包含详细的用户行为数据,见下方"用户参与度字段"详细说明 |
TrafficSources | Object | 流量来源分布对象。包含不同渠道的流量占比,所有渠道百分比加总为1.0。详细字段包括:<br>- Direct:直接访问流量占比(用户直接输入网址或书签访问)<br>- Search:搜索引擎流量占比(来自Google、Bing等搜索引擎)<br>- Social:社交媒体流量占比(来自Facebook、Instagram、TikTok等)<br>- Referrals:推荐链接流量占比(来自其他网站的链接)<br>- Mail:邮件流量占比(来自Email营销链接)<br>- Paid Referrals:付费推荐流量占比(来自付费广告链接)<br>例如:{"Direct": "0.49163060258951263"}表示49.16%的流量来自直接访问 |
TopCountryShares | Array[Object] | 主要访问国家流量分布列表。包含访问该网站流量最多的5个国家及其流量占比。每个对象包含四个字段:<br>- code:国家代码(2位字母)<br>- Value:流量占比(字符串格式的小数,如"0.5616358457921382"表示56.16%)<br>- Country:国家代码(数字)<br>- CountryCode:国家代码(2位字母,与code相同)<br>流量占比之和通常小于1.0,因为只包含前5名国家 |
Countries | Array[Object] | 完整的国家列表数组。包含SimilarWeb支持的所有国家信息,每个对象包含 UrlCode(URL友好的国家代码)、Code(ISO国家代码)、Name(国家名称)。此字段主要用于前端国家选择器,通常不需要关注 |
用户参与度字段 (Engagments对象)
| 字段名 | 类型 | 描述 |
|---|---|---|
Month | String | 数据所属月份。1-12的字符串表示,如"10"表示10月 |
Year | String | 数据所属年份。四位数字的字符串,如"2025" |
Visits | String | 该月总访问量。字符串格式的数字,如"183701"表示183,701次访问。此值与EstimatedMonthlyVisits中对应月份的值相同 |
BounceRate | String | 跳出率。字符串格式的小数,取值范围0.0-1.0。如"0.38498812605523314"表示38.5%的跳出率。跳出率是指用户访问网站后没有进行任何交互就离开的比例,数值越低说明用户粘性越好 |
TimeOnSite | String | 平均访问时长。字符串格式的数字,单位为秒。如"236.7671408104057"表示平均停留时间约237秒(约3分57秒)。时长越长说明用户对网站内容越感兴趣 |
PagePerVisit | String | 平均访问页数。字符串格式的数字,如"5.1769465367470895"表示用户平均访问5.18个页面。数值越高说明用户对网站内容越感兴趣,网站粘性越好 |
SEO与关键词字段
| 字段名 | 类型 | 描述 |
|---|---|---|
TopKeywords | Array[Object] | 网站主要关键词列表。包含为网站带来最多流量的5个关键词及其数据。每个对象包含四个字段:<br>- Name:关键词文本,如"kuose"<br>- Volume:月搜索量,表示该关键词每月的搜索次数<br>- Cpc:每次点击成本,字符串格式的数字(美元),如"1.38"。如果没有广告竞价数据则为null<br>- EstimatedValue:预估流量价值,根据关键词搜索量、排名和CPC估算的月流量价值(美元)<br>此字段可用于分析竞争对手的SEO策略和核心关键词 |
竞争对手字段
| 字段名 | 类型 | 描述 |
|---|---|---|
Competitors | Object | 竞争对手数据对象。包含 TopSimilarityCompetitors字段(数组),列出与该网站相似度最高的竞争对手网站。如果数组为空,表示暂无竞争对手数据 |
通知字段
| 字段名 | 类型 | 描述 |
|---|---|---|
Notification | Object | 通知信息对象。包含 Content字段,如果有针对该网站的特殊通知或说明,会在此字段显示。通常为null |
重要说明:
-
数据可用性: 并非所有店铺都有SimilarWeb数据。对于以下情况,
data.data将返回空对象{}:- 网站流量过小(通常月访问量低于5000次)
- 新建立的网站(运营时间少于3个月)
- 网站未被SimilarWeb收录
- 店铺ID对应的网站域名无效
-
数据结构动态性: SimilarWeb返回的数据结构可能随其API版本更新而变化,上述字段列表仅供参考。实际返回的字段以响应数据为准。
-
数据时效性: SimilarWeb数据通常有1-2个月的延迟,不是实时数据。系统每周更新一次排名数据。
响应示例
示例1: 有流量排名数据的店铺
{
"code": 200,
"message": "success",
"data": {
"Policy": 0,
"Description": "KUOSE.com",
"Category": "lifestyle/fashion_and_apparel",
"TopKeywords": [
{
"Volume": 9820,
"Cpc": "1.39",
"EstimatedValue": 7640,
"Name": "kuose"
},
{
"Volume": 670,
"Cpc": 1,
"EstimatedValue": 580,
"Name": "kuose clothing"
},
{
"Volume": 510,
"Cpc": "1.25",
"EstimatedValue": 190,
"Name": "kouse"
},
{
"Volume": 190,
"EstimatedValue": 180,
"Name": "kurose clothing"
},
{
"Volume": 150,
"EstimatedValue": 150,
"Name": "kuose white skirt"
}
],
"SiteName": "kuose.com",
"TopCountryShares": [
{
"code": "US",
"Value": "0.527240794320651",
"Country": 840,
"CountryCode": "US"
},
{
"code": "KR",
"Value": "0.09030019847364731",
"Country": 410,
"CountryCode": "KR"
},
{
"code": "CA",
"Value": "0.08972755877450395",
"Country": 124,
"CountryCode": "CA"
},
{
"code": "AU",
"Value": "0.05482726259335732",
"Country": 36,
"CountryCode": "AU"
},
{
"code": "VN",
"Value": "0.048566543892607804",
"Country": 704,
"CountryCode": "VN"
}
],
"CountryRank": {
"Country": 840,
"Rank": 82929,
"CountryCode": "US"
},
"Countries": [
{
"UrlCode": "afghanistan",
"Code": "AF",
"Name": "Afghanistan"
},
{
"UrlCode": "land-islands",
"Code": "AX",
"Name": "Åland Islands"
},
{
"UrlCode": "albania",
"Code": "AL",
"Name": "Albania"
},
{
"UrlCode": "algeria",
"Code": "DZ",
"Name": "Algeria"
},
{
"UrlCode": "american-samoa",
"Code": "AS",
"Name": "American Samoa"
},
{
"UrlCode": "andorra",
"Code": "AD",
"Name": "Andorra"
},
{
"UrlCode": "angola",
"Code": "AO",
"Name": "Angola"
},
{
"UrlCode": "anguilla",
"Code": "AI",
"Name": "Anguilla"
},
{
"UrlCode": "antarctica",
"Code": "AQ",
"Name": "Antarctica"
},
{
"UrlCode": "antigua-and-barbuda",
"Code": "AG",
"Name": "Antigua and Barbuda"
},
{
"UrlCode": "argentina",
"Code": "AR",
"Name": "Argentina"
},
{
"UrlCode": "armenia",
"Code": "AM",
"Name": "Armenia"
},
{
"UrlCode": "aruba",
"Code": "AW",
"Name": "Aruba"
},
{
"UrlCode": "australia",
"Code": "AU",
"Name": "Australia"
},
{
"UrlCode": "austria",
"Code": "AT",
"Name": "Austria"
},
{
"UrlCode": "azerbaijan",
"Code": "AZ",
"Name": "Azerbaijan"
},
{
"UrlCode": "bahamas",
"Code": "BS",
"Name": "Bahamas"
},
{
"UrlCode": "bahrain",
"Code": "BH",
"Name": "Bahrain"
},
{
"UrlCode": "bangladesh",
"Code": "BD",
"Name": "Bangladesh"
},
{
"UrlCode": "barbados",
"Code": "BB",
"Name": "Barbados"
},
{
"UrlCode": "belarus",
"Code": "BY",
"Name": "Belarus"
},
{
"UrlCode": "belgium",
"Code": "BE",
"Name": "Belgium"
},
{
"UrlCode": "belize",
"Code": "BZ",
"Name": "Belize"
},
{
"UrlCode": "benin",
"Code": "BJ",
"Name": "Benin"
},
{
"UrlCode": "bermuda",
"Code": "BM",
"Name": "Bermuda"
},
{
"UrlCode": "bhutan",
"Code": "BT",
"Name": "Bhutan"
},
{
"UrlCode": "bolivia-plurinational-state-of",
"Code": "BO",
"Name": "Bolivia"
},
{
"UrlCode": "bonaire-sint-eustatius-and-saba",
"Code": "BQ",
"Name": "Bonaire, Sint Eustatius and Saba"
},
{
"UrlCode": "bosnia-and-herzegovina",
"Code": "BA",
"Name": "Bosnia and Herzegovina"
},
{
"UrlCode": "botswana",
"Code": "BW",
"Name": "Botswana"
},
{
"UrlCode": "bouvet-island",
"Code": "BV",
"Name": "Bouvet Island"
},
{
"UrlCode": "brazil",
"Code": "BR",
"Name": "Brazil"
},
{
"UrlCode": "british-indian-ocean-territory",
"Code": "IO",
"Name": "British Indian Ocean Territory"
},
{
"UrlCode": "brunei-darussalam",
"Code": "BN",
"Name": "Brunei Darussalam"
},
{
"UrlCode": "bulgaria",
"Code": "BG",
"Name": "Bulgaria"
},
{
"UrlCode": "burkina-faso",
"Code": "BF",
"Name": "Burkina Faso"
},
{
"UrlCode": "burundi",
"Code": "BI",
"Name": "Burundi"
},
{
"UrlCode": "cabo-verde",
"Code": "CV",
"Name": "Cabo Verde"
},
{
"UrlCode": "cambodia",
"Code": "KH",
"Name": "Cambodia"
},
{
"UrlCode": "cameroon",
"Code": "CM",
"Name": "Cameroon"
},
{
"UrlCode": "canada",
"Code": "CA",
"Name": "Canada"
},
{
"UrlCode": "cayman-islands",
"Code": "KY",
"Name": "Cayman Islands"
},
{
"UrlCode": "central-african-republic",
"Code": "CF",
"Name": "Central African Republic"
},
{
"UrlCode": "chad",
"Code": "TD",
"Name": "Chad"
},
{
"UrlCode": "chile",
"Code": "CL",
"Name": "Chile"
},
{
"UrlCode": "china",
"Code": "CN",
"Name": "China"
},
{
"UrlCode": "christmas-island",
"Code": "CX",
"Name": "Christmas Island"
},
{
"UrlCode": "cocos-keeling-islands",
"Code": "CC",
"Name": "Cocos (Keeling) Islands"
},
{
"UrlCode": "colombia",
"Code": "CO",
"Name": "Colombia"
},
{
"UrlCode": "comoros",
"Code": "KM",
"Name": "Comoros"
},
{
"UrlCode": "congo",
"Code": "CG",
"Name": "Congo"
},
{
"UrlCode": "congo-the-democratic-republic-of-the",
"Code": "CD",
"Name": "Congo, the Democratic Republic of the"
},
{
"UrlCode": "cook-islands",
"Code": "CK",
"Name": "Cook Islands"
},
{
"UrlCode": "costa-rica",
"Code": "CR",
"Name": "Costa Rica"
},
{
"UrlCode": "cte-divoire",
"Code": "CI",
"Name": "Côte d'Ivoire"
},
{
"UrlCode": "croatia",
"Code": "HR",
"Name": "Croatia"
},
{
"UrlCode": "cuba",
"Code": "CU",
"Name": "Cuba"
},
{
"UrlCode": "curaao",
"Code": "CW",
"Name": "Curaçao"
},
{
"UrlCode": "cyprus",
"Code": "CY",
"Name": "Cyprus"
},
{
"UrlCode": "czech-republic",
"Code": "CZ",
"Name": "Czech Republic"
},
{
"UrlCode": "denmark",
"Code": "DK",
"Name": "Denmark"
},
{
"UrlCode": "djibouti",
"Code": "DJ",
"Name": "Djibouti"
},
{
"UrlCode": "dominica",
"Code": "DM",
"Name": "Dominica"
},
{
"UrlCode": "dominican-republic",
"Code": "DO",
"Name": "Dominican Republic"
},
{
"UrlCode": "ecuador",
"Code": "EC",
"Name": "Ecuador"
},
{
"UrlCode": "egypt",
"Code": "EG",
"Name": "Egypt"
},
{
"UrlCode": "el-salvador",
"Code": "SV",
"Name": "El Salvador"
},
{
"UrlCode": "equatorial-guinea",
"Code": "GQ",
"Name": "Equatorial Guinea"
},
{
"UrlCode": "eritrea",
"Code": "ER",
"Name": "Eritrea"
},
{
"UrlCode": "estonia",
"Code": "EE",
"Name": "Estonia"
},
{
"UrlCode": "ethiopia",
"Code": "ET",
"Name": "Ethiopia"
},
{
"UrlCode": "falkland-islands-malvinas",
"Code": "FK",
"Name": "Falkland Islands (Malvinas)"
},
{
"UrlCode": "faroe-islands",
"Code": "FO",
"Name": "Faroe Islands"
},
{
"UrlCode": "fiji",
"Code": "FJ",
"Name": "Fiji"
},
{
"UrlCode": "finland",
"Code": "FI",
"Name": "Finland"
},
{
"UrlCode": "france",
"Code": "FR",
"Name": "France"
},
{
"UrlCode": "french-guiana",
"Code": "GF",
"Name": "French Guiana"
},
{
"UrlCode": "french-polynesia",
"Code": "PF",
"Name": "French Polynesia"
},
{
"UrlCode": "french-southern-territories",
"Code": "TF",
"Name": "French Southern Territories"
},
{
"UrlCode": "gabon",
"Code": "GA",
"Name": "Gabon"
},
{
"UrlCode": "gambia",
"Code": "GM",
"Name": "Gambia"
},
{
"UrlCode": "georgia",
"Code": "GE",
"Name": "Georgia"
},
{
"UrlCode": "germany",
"Code": "DE",
"Name": "Germany"
},
{
"UrlCode": "ghana",
"Code": "GH",
"Name": "Ghana"
},
{
"UrlCode": "gibraltar",
"Code": "GI",
"Name": "Gibraltar"
},
{
"UrlCode": "greece",
"Code": "GR",
"Name": "Greece"
},
{
"UrlCode": "greenland",
"Code": "GL",
"Name": "Greenland"
},
{
"UrlCode": "grenada",
"Code": "GD",
"Name": "Grenada"
},
{
"UrlCode": "guadeloupe",
"Code": "GP",
"Name": "Guadeloupe"
},
{
"UrlCode": "guam",
"Code": "GU",
"Name": "Guam"
},
{
"UrlCode": "guatemala",
"Code": "GT",
"Name": "Guatemala"
},
{
"UrlCode": "guernsey",
"Code": "GG",
"Name": "Guernsey"
},
{
"UrlCode": "guinea",
"Code": "GN",
"Name": "Guinea"
},
{
"UrlCode": "guinea-bissau",
"Code": "GW",
"Name": "Guinea-Bissau"
},
{
"UrlCode": "guyana",
"Code": "GY",
"Name": "Guyana"
},
{
"UrlCode": "haiti",
"Code": "HT",
"Name": "Haiti"
},
{
"UrlCode": "heard-island-and-mcdonald-islands",
"Code": "HM",
"Name": "Heard Island and McDonald Islands"
},
{
"UrlCode": "holy-see-vatican-city-state",
"Code": "VA",
"Name": "Holy See (Vatican City State)"
},
{
"UrlCode": "honduras",
"Code": "HN",
"Name": "Honduras"
},
{
"UrlCode": "hong-kong",
"Code": "HK",
"Name": "Hong Kong"
},
{
"UrlCode": "hungary",
"Code": "HU",
"Name": "Hungary"
},
{
"UrlCode": "iceland",
"Code": "IS",
"Name": "Iceland"
},
{
"UrlCode": "india",
"Code": "IN",
"Name": "India"
},
{
"UrlCode": "indonesia",
"Code": "ID",
"Name": "Indonesia"
},
{
"UrlCode": "iran-islamic-republic-of",
"Code": "IR",
"Name": "Iran"
},
{
"UrlCode": "iraq",
"Code": "IQ",
"Name": "Iraq"
},
{
"UrlCode": "ireland",
"Code": "IE",
"Name": "Ireland"
},
{
"UrlCode": "isle-of-man",
"Code": "IM",
"Name": "Isle of Man"
},
{
"UrlCode": "israel",
"Code": "IL",
"Name": "Israel"
},
{
"UrlCode": "italy",
"Code": "IT",
"Name": "Italy"
},
{
"UrlCode": "jamaica",
"Code": "JM",
"Name": "Jamaica"
},
{
"UrlCode": "japan",
"Code": "JP",
"Name": "Japan"
},
{
"UrlCode": "jersey",
"Code": "JE",
"Name": "Jersey"
},
{
"UrlCode": "jordan",
"Code": "JO",
"Name": "Jordan"
},
{
"UrlCode": "kazakhstan",
"Code": "KZ",
"Name": "Kazakhstan"
},
{
"UrlCode": "kenya",
"Code": "KE",
"Name": "Kenya"
},
{
"UrlCode": "kiribati",
"Code": "KI",
"Name": "Kiribati"
},
{
"UrlCode": "korea-democratic-peoples-republic-of",
"Code": "KP",
"Name": "Korea, Democratic People's Republic of"
},
{
"UrlCode": "korea-republic-of",
"Code": "KR",
"Name": "Korea, Republic of"
},
{
"UrlCode": "kuwait",
"Code": "KW",
"Name": "Kuwait"
},
{
"UrlCode": "kyrgyzstan",
"Code": "KG",
"Name": "Kyrgyzstan"
},
{
"UrlCode": "lao-peoples-democratic-republic",
"Code": "LA",
"Name": "Lao People's Democratic Republic"
},
{
"UrlCode": "latvia",
"Code": "LV",
"Name": "Latvia"
},
{
"UrlCode": "lebanon",
"Code": "LB",
"Name": "Lebanon"
},
{
"UrlCode": "lesotho",
"Code": "LS",
"Name": "Lesotho"
},
{
"UrlCode": "liberia",
"Code": "LR",
"Name": "Liberia"
},
{
"UrlCode": "libya",
"Code": "LY",
"Name": "Libya"
},
{
"UrlCode": "liechtenstein",
"Code": "LI",
"Name": "Liechtenstein"
},
{
"UrlCode": "lithuania",
"Code": "LT",
"Name": "Lithuania"
},
{
"UrlCode": "luxembourg",
"Code": "LU",
"Name": "Luxembourg"
},
{
"UrlCode": "macao",
"Code": "MO",
"Name": "Macao"
},
{
"UrlCode": "macedonia-the-former-yugoslav-republic-of",
"Code": "MK",
"Name": "Macedonia (FYROM)"
},
{
"UrlCode": "madagascar",
"Code": "MG",
"Name": "Madagascar"
},
{
"UrlCode": "malawi",
"Code": "MW",
"Name": "Malawi"
},
{
"UrlCode": "malaysia",
"Code": "MY",
"Name": "Malaysia"
},
{
"UrlCode": "maldives",
"Code": "MV",
"Name": "Maldives"
},
{
"UrlCode": "mali",
"Code": "ML",
"Name": "Mali"
},
{
"UrlCode": "malta",
"Code": "MT",
"Name": "Malta"
},
{
"UrlCode": "marshall-islands",
"Code": "MH",
"Name": "Marshall Islands"
},
{
"UrlCode": "martinique",
"Code": "MQ",
"Name": "Martinique"
},
{
"UrlCode": "mauritania",
"Code": "MR",
"Name": "Mauritania"
},
{
"UrlCode": "mauritius",
"Code": "MU",
"Name": "Mauritius"
},
{
"UrlCode": "mayotte",
"Code": "YT",
"Name": "Mayotte"
},
{
"UrlCode": "mexico",
"Code": "MX",
"Name": "Mexico"
},
{
"UrlCode": "micronesia-federated-states-of",
"Code": "FM",
"Name": "Micronesia, Federated States of"
},
{
"UrlCode": "moldova-republic-of",
"Code": "MD",
"Name": "Moldova"
},
{
"UrlCode": "monaco",
"Code": "MC",
"Name": "Monaco"
},
{
"UrlCode": "mongolia",
"Code": "MN",
"Name": "Mongolia"
},
{
"UrlCode": "montenegro",
"Code": "ME",
"Name": "Montenegro"
},
{
"UrlCode": "montserrat",
"Code": "MS",
"Name": "Montserrat"
},
{
"UrlCode": "morocco",
"Code": "MA",
"Name": "Morocco"
},
{
"UrlCode": "mozambique",
"Code": "MZ",
"Name": "Mozambique"
},
{
"UrlCode": "myanmar",
"Code": "MM",
"Name": "Myanmar"
},
{
"UrlCode": "namibia",
"Code": "NA",
"Name": "Namibia"
},
{
"UrlCode": "nauru",
"Code": "NR",
"Name": "Nauru"
},
{
"UrlCode": "nepal",
"Code": "NP",
"Name": "Nepal"
},
{
"UrlCode": "netherlands",
"Code": "NL",
"Name": "Netherlands"
},
{
"UrlCode": "netherlands-antilles",
"Code": "AN",
"Name": "Netherlands Antilles"
},
{
"UrlCode": "new-caledonia",
"Code": "NC",
"Name": "New Caledonia"
},
{
"UrlCode": "new-zealand",
"Code": "NZ",
"Name": "New Zealand"
},
{
"UrlCode": "nicaragua",
"Code": "NI",
"Name": "Nicaragua"
},
{
"UrlCode": "niger",
"Code": "NE",
"Name": "Niger"
},
{
"UrlCode": "nigeria",
"Code": "NG",
"Name": "Nigeria"
},
{
"UrlCode": "niue",
"Code": "NU",
"Name": "Niue"
},
{
"UrlCode": "non-spec-asia-pas-location",
"Code": "AP",
"Name": "Non-spec Asia Pas Location"
},
{
"UrlCode": "norfolk-island",
"Code": "NF",
"Name": "Norfolk Island"
},
{
"UrlCode": "northern-mariana-islands",
"Code": "MP",
"Name": "Northern Mariana Islands"
},
{
"UrlCode": "norway",
"Code": "NO",
"Name": "Norway"
},
{
"UrlCode": "oman",
"Code": "OM",
"Name": "Oman"
},
{
"UrlCode": "pakistan",
"Code": "PK",
"Name": "Pakistan"
},
{
"UrlCode": "palau",
"Code": "PW",
"Name": "Palau"
},
{
"UrlCode": "palestine-state-of",
"Code": "PS",
"Name": "Palestine"
},
{
"UrlCode": "panama",
"Code": "PA",
"Name": "Panama"
},
{
"UrlCode": "papua-new-guinea",
"Code": "PG",
"Name": "Papua New Guinea"
},
{
"UrlCode": "paraguay",
"Code": "PY",
"Name": "Paraguay"
},
{
"UrlCode": "peru",
"Code": "PE",
"Name": "Peru"
},
{
"UrlCode": "philippines",
"Code": "PH",
"Name": "Philippines"
},
{
"UrlCode": "pitcairn",
"Code": "PN",
"Name": "Pitcairn"
},
{
"UrlCode": "poland",
"Code": "PL",
"Name": "Poland"
},
{
"UrlCode": "portugal",
"Code": "PT",
"Name": "Portugal"
},
{
"UrlCode": "puerto-rico",
"Code": "PR",
"Name": "Puerto Rico"
},
{
"UrlCode": "qatar",
"Code": "QA",
"Name": "Qatar"
},
{
"UrlCode": "runion",
"Code": "RE",
"Name": "Réunion"
},
{
"UrlCode": "romania",
"Code": "RO",
"Name": "Romania"
},
{
"UrlCode": "russian-federation",
"Code": "RU",
"Name": "Russia"
},
{
"UrlCode": "rwanda",
"Code": "RW",
"Name": "Rwanda"
},
{
"UrlCode": "saint-barthlemy",
"Code": "BL",
"Name": "Saint Barthélemy"
},
{
"UrlCode": "saint-helena-ascension-and-tristan-da-cunha",
"Code": "SH",
"Name": "Saint Helena, Ascension and Tristan da Cunha"
},
{
"UrlCode": "saint-kitts-and-nevis",
"Code": "KN",
"Name": "Saint Kitts and Nevis"
},
{
"UrlCode": "saint-lucia",
"Code": "LC",
"Name": "Saint Lucia"
},
{
"UrlCode": "saint-martin-french-part",
"Code": "MF",
"Name": "Saint Martin (French part)"
},
{
"UrlCode": "saint-pierre-and-miquelon",
"Code": "PM",
"Name": "Saint Pierre and Miquelon"
},
{
"UrlCode": "saint-vincent-and-the-grenadines",
"Code": "VC",
"Name": "Saint Vincent and the Grenadines"
},
{
"UrlCode": "samoa",
"Code": "WS",
"Name": "Samoa"
},
{
"UrlCode": "san-marino",
"Code": "SM",
"Name": "San Marino"
},
{
"UrlCode": "sao-tome-and-principe",
"Code": "ST",
"Name": "Sao Tome and Principe"
},
{
"UrlCode": "saudi-arabia",
"Code": "SA",
"Name": "Saudi Arabia"
},
{
"UrlCode": "senegal",
"Code": "SN",
"Name": "Senegal"
},
{
"UrlCode": "serbia",
"Code": "RS",
"Name": "Serbia"
},
{
"UrlCode": "serbia-and-montenegro",
"Code": "CS",
"Name": "SERBIA AND MONTENEGRO"
},
{
"UrlCode": "seychelles",
"Code": "SC",
"Name": "Seychelles"
},
{
"UrlCode": "sierra-leone",
"Code": "SL",
"Name": "Sierra Leone"
},
{
"UrlCode": "singapore",
"Code": "SG",
"Name": "Singapore"
},
{
"UrlCode": "sint-maarten-dutch-part",
"Code": "SX",
"Name": "Sint Maarten (Dutch part)"
},
{
"UrlCode": "slovakia",
"Code": "SK",
"Name": "Slovakia"
},
{
"UrlCode": "slovenia",
"Code": "SI",
"Name": "Slovenia"
},
{
"UrlCode": "solomon-islands",
"Code": "SB",
"Name": "Solomon Islands"
},
{
"UrlCode": "somalia",
"Code": "SO",
"Name": "Somalia"
},
{
"UrlCode": "south-africa",
"Code": "ZA",
"Name": "South Africa"
},
{
"UrlCode": "south-georgia-and-the-south-sandwich-islands",
"Code": "GS",
"Name": "South Georgia and the South Sandwich Islands"
},
{
"UrlCode": "south-sudan",
"Code": "SS",
"Name": "South Sudan"
},
{
"UrlCode": "spain",
"Code": "ES",
"Name": "Spain"
},
{
"UrlCode": "sri-lanka",
"Code": "LK",
"Name": "Sri Lanka"
},
{
"UrlCode": "sudan",
"Code": "SD",
"Name": "Sudan"
},
{
"UrlCode": "suriname",
"Code": "SR",
"Name": "Suriname"
},
{
"UrlCode": "svalbard-and-jan-mayen",
"Code": "SJ",
"Name": "Svalbard and Jan Mayen"
},
{
"UrlCode": "swaziland",
"Code": "SZ",
"Name": "Swaziland"
},
{
"UrlCode": "sweden",
"Code": "SE",
"Name": "Sweden"
},
{
"UrlCode": "switzerland",
"Code": "CH",
"Name": "Switzerland"
},
{
"UrlCode": "syrian-arab-republic",
"Code": "SY",
"Name": "Syrian Arab Republic"
},
{
"UrlCode": "taiwan",
"Code": "TW",
"Name": "Taiwan"
},
{
"UrlCode": "tajikistan",
"Code": "TJ",
"Name": "Tajikistan"
},
{
"UrlCode": "tanzania-united-republic-of",
"Code": "TZ",
"Name": "Tanzania, United Republic of"
},
{
"UrlCode": "thailand",
"Code": "TH",
"Name": "Thailand"
},
{
"UrlCode": "timor-leste",
"Code": "TL",
"Name": "Timor-Leste"
},
{
"UrlCode": "togo",
"Code": "TG",
"Name": "Togo"
},
{
"UrlCode": "tokelau",
"Code": "TK",
"Name": "Tokelau"
},
{
"UrlCode": "tonga",
"Code": "TO",
"Name": "Tonga"
},
{
"UrlCode": "trinidad-and-tobago",
"Code": "TT",
"Name": "Trinidad and Tobago"
},
{
"UrlCode": "tunisia",
"Code": "TN",
"Name": "Tunisia"
},
{
"UrlCode": "turkey",
"Code": "TR",
"Name": "Turkey"
},
{
"UrlCode": "turkmenistan",
"Code": "TM",
"Name": "Turkmenistan"
},
{
"UrlCode": "turks-and-caicos-islands",
"Code": "TC",
"Name": "Turks and Caicos Islands"
},
{
"UrlCode": "tuvalu",
"Code": "TV",
"Name": "Tuvalu"
},
{
"UrlCode": "uganda",
"Code": "UG",
"Name": "Uganda"
},
{
"UrlCode": "ukraine",
"Code": "UA",
"Name": "Ukraine"
},
{
"UrlCode": "united-arab-emirates",
"Code": "AE",
"Name": "United Arab Emirates"
},
{
"UrlCode": "united-kingdom",
"Code": "GB",
"Name": "United Kingdom"
},
{
"UrlCode": "united-states",
"Code": "US",
"Name": "United States"
},
{
"UrlCode": "united-states-minor-outlying-islands",
"Code": "UM",
"Name": "United States Minor Outlying Islands"
},
{
"UrlCode": "uruguay",
"Code": "UY",
"Name": "Uruguay"
},
{
"UrlCode": "uzbekistan",
"Code": "UZ",
"Name": "Uzbekistan"
},
{
"UrlCode": "vanuatu",
"Code": "VU",
"Name": "Vanuatu"
},
{
"UrlCode": "venezuela-bolivarian-republic-of",
"Code": "VE",
"Name": "Venezuela"
},
{
"UrlCode": "vietnam",
"Code": "VN",
"Name": "Vietnam"
},
{
"UrlCode": "virgin-islands-british",
"Code": "VG",
"Name": "Virgin Islands, British"
},
{
"UrlCode": "virgin-islands-us",
"Code": "VI",
"Name": "Virgin Islands, U.S."
},
{
"UrlCode": "wallis-and-futuna",
"Code": "WF",
"Name": "Wallis and Futuna"
},
{
"UrlCode": "western-sahara",
"Code": "EH",
"Name": "Western Sahara"
},
{
"UrlCode": "yemen",
"Code": "YE",
"Name": "Yemen"
},
{
"UrlCode": "zambia",
"Code": "ZM",
"Name": "Zambia"
},
{
"UrlCode": "zimbabwe",
"Code": "ZW",
"Name": "Zimbabwe"
}
],
"next_update_time": 1764214104,
"Title": "KUOSE.com",
"Engagments": {
"BounceRate": "0.3658702925231566",
"Month": "9",
"Year": "2025",
"Visits": "157196",
"TimeOnSite": "171.18898233918964",
"PagePerVisit": "5.183859363385903"
},
"SnapshotDate": "2025-09-01T00:00:00+00:00",
"EstimatedMonthlyVisits": {
"1754006400": 181479,
"1756684800": 157196,
"1751328000": 124874
},
"GlobalRank": {
"Rank": 188495
},
"Notification": {},
"update_time": 1761622104,
"Version": 1,
"IsSmall": false,
"TrafficSources": {
"Social": "0.09741661361619032",
"Mail": "0.001184550837573985",
"Referrals": "0.03595114837028244",
"Search": "0.37041352611386147",
"Paid Referrals": "0.0056197611782149055",
"Direct": "0.4894143998836085"
},
"CategoryRank": {
"Category": "Lifestyle/Fashion_and_Apparel",
"Rank": "2437"
},
"LargeScreenshot": "https://site-images.similarcdn.com/image?url=kuose.com&t=1&s=1&h=3b1b8c98a661481ba356795b6c9d886c6d65780d1f71757ee379b18b995ecd31",
"Competitors": {
"TopSimilarityCompetitors": []
},
"IsDataFromGa": false
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 0,
"success": true,
"fail": false
}
注意:为简化展示,上述示例省略了Countries字段(完整的国家列表包含200+个国家对象)。
示例2: 无流量排名数据的店铺
{
"code": 200,
"message": "success",
"data": {},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 0,
"success": true,
"fail": false
}
错误码说明
| 错误码 | 描述 | 解决方案 |
|---|---|---|
200 | 成功 | - |
400 | 请求参数错误 | 检查id格式是否正确 |
401 | 未授权 | 检查API Key是否有效,是否已过期 |
403 | 权限不足 | 检查API Key是否有访问此接口的权限 |
404 | 店铺不存在 | 检查id是否正确,该店铺是否已从系统中删除 |
500 | 服务器内部错误 | 联系技术支持或稍后重试 |