店铺竞争分析接口文档
本文档包含两个关联接口,用于完整实现店铺竞争分析功能:
- 产品选项列表接口 (
/v3/api/open/store/detail/competition/products): 获取店铺下所有产品列表,用于筛选特定产品进行竞争分析
- 竞争店铺列表接口 (
/v3/api/open/store/detail/competition): 获取店铺的竞争对手列表
接口1: 获取店铺产品选项列表
接口信息
- 接口名称: 获取店铺产品选项列表(用于竞争分析筛选)
- 请求方法: GET
- 接口地址:
/open-api/v1/data
- 接口路径:
/v3/api/open/store/detail/competition/products
- 接口描述: 获取指定店铺下所有产品的ID和图片信息。此接口返回的产品ID(
id字段)可作为竞争店铺列表接口的product_id参数,用于筛选基于特定产品的竞争分析。使用建议:在调用竞争店铺列表接口前,建议先调用此接口获取产品列表,让用户选择要分析的产品,或直接传递所有产品进行全面竞争分析。
- 价格说明:
免费
请求头:
- Content-Type: application/json
- Accept: application/json
请求参数
请求结构
| 参数名 |
类型 |
描述 |
示例 |
必填 |
默认值 |
| key |
string |
用户申请的外部 api 请求 key |
"your_api_key_here" |
是 |
|
| uri |
string |
接口路径 |
"/v3/api/open/store/detail/competition/products" |
是 |
|
| params |
object |
接口入参对象 |
见参数列表 |
是 |
|
请求体参数 (params 对象)
| 参数名 |
类型 |
必填 |
默认值 |
描述 |
| id |
String |
是 |
- |
店铺 ID 为 13 位字符串(例如:c2d5b2547218a),对应店铺榜单列表接口返回结果中的 store_id 字段 |
请求示例
curl -X GET "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/detail/competition/products",
"params": {
"id": "cac90b02df723"
}
}'
响应参数
响应体结构
{
"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 |
Array |
产品信息列表数组 |
| version |
String |
API 版本号 |
| timestamp |
String |
响应时间戳 |
| sign |
String |
响应签名(预留字段) |
| remaining_credits |
Long |
当前请求后的剩余可用积分 |
| consumed_credits |
Long |
本次请求消耗的积分 |
| success |
Boolean |
请求是否成功的布尔值 |
| fail |
Boolean |
请求是否失败的布尔值 |
产品信息字段 (data.data[])
| 字段名 |
类型 |
描述 |
| id |
String |
产品唯一标识ID(MongoDB ObjectId格式)。重要:此ID可直接用于竞争店铺列表接口的product_id参数,用于筛选基于该产品的竞争对手 |
| icon |
String |
产品图片完整URL地址。图片托管在CDN上,格式为:"https://cdn-product.pipiads.com/xxxxx.jpg"。此图片为产品的主图或首图,用于在UI界面展示产品缩略图,方便用户识别和选择 |
响应示例
{
"code": 200,
"message": "success",
"data": {
"data": [
{
"id": "62739afc38365b2f72048ebe",
"icon": "https://cdn-product.pipiads.com/images/product_image_001.jpg"
},
{
"id": "62739b0438365b2f72048ebf",
"icon": "https://cdn-product.pipiads.com/images/product_image_002.jpg"
},
{
"id": "62739b1238365b2f72048ec0",
"icon": "https://cdn-product.pipiads.com/images/product_image_003.jpg"
}
]
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 0,
"success": true,
"fail": false
}
使用说明
- 获取产品列表: 调用此接口获取店铺下所有产品的ID和图片
- 用户选择产品: 在前端界面展示产品图片列表,让用户选择要分析的产品
- 传递产品ID: 将选中的产品ID传递给竞争店铺列表接口的
product_id参数
- 全店铺分析: 如果想基于店铺所有产品进行竞争分析,可以不调用此接口,直接调用竞争店铺列表接口且不传
product_id参数
错误码说明
| 错误码 |
描述 |
解决方案 |
| 200 |
成功 |
- |
| 400 |
请求参数错误 |
检查id格式是否正确(必须是有效的MongoDB ObjectId) |
| 401 |
未授权 |
检查API Key是否有效,是否已过期 |
| 403 |
权限不足 |
检查API Key是否有访问此接口的权限 |
| 404 |
店铺不存在 |
检查id是否正确,该店铺是否已从系统中删除 |
| 500 |
服务器内部错误 |
联系技术支持或稍后重试 |
接口2: 获取店铺竞争分析列表
接口信息
- 接口名称: 获取店铺竞争分析列表
- 请求方法: GET
- 接口地址:
/open-api/v1/data
- 接口路径:
/v3/api/open/store/detail/competition
- 接口描述: 根据店铺ID获取该店铺的竞争对手店铺列表。系统通过AI图像识别技术分析店铺销售的产品图片,找出销售相似产品的其他店铺,按照相似度评分(score)从高到低排序返回。支持分页查询和按指定产品筛选竞争店铺。
- 价格说明: 获取一条数据结果消耗1 credit
请求头:
- Content-Type: application/json
- Accept: application/json
请求参数
请求结构
| 参数名 |
类型 |
描述 |
示例 |
必填 |
默认值 |
| key |
string |
用户申请的外部 api 请求 key |
"your_api_key_here" |
是 |
|
| uri |
string |
接口路径 |
"/v3/api/open/store/detail/competition" |
是 |
|
| params |
object |
接口入参对象 |
见参数列表 |
是 |
|
请求体参数 (params 对象)
| 参数名 |
类型 |
必填 |
默认值 |
描述 |
| id |
String |
是 |
- |
店铺 ID 为 13 位字符串(例如:c2d5b2547218a),对应店铺榜单列表接口返回结果中的 store_id 字段 |
| product_id |
String |
否 |
null |
指定产品ID进行筛选。当传入此参数时,只返回与该店铺下指定产品相似的竞争店铺。此ID是PipiAds系统内部生成的产品唯一标识符(MongoDB ObjectId格式)。如果不传此参数,则基于该店铺所有产品进行竞争分析 |
| page_size |
Integer |
否 |
20 |
每页返回的店铺数量。指定单页返回的竞争店铺记录数。取值范围:1-200,建议设置在20-100之间以获得最佳性能 |
| current_page |
Integer |
否 |
1 |
当前页码。页码从1开始计数,用于分页查询。当请求页码超过总页数时,返回空列表 |
请求示例
# 示例1: 查询店铺的所有竞争对手(基于所有产品)
curl -X GET "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/detail/competition",
"params": {
"id": "cac90b02df723",
"current_page": 1,
"page_size": 20
}
}'
# 示例2: 查询店铺指定产品的竞争对手
curl -X GET "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/detail/competition",
"params": {
"id": "cac90b02df723",
"product_id": "62739afc38365b2f72048ebe",
"current_page": 1,
"page_size": 50
}
}'
响应参数
响应体结构
{
"code": 200,
"message": "success",
"data": {
"data": [],
"page": {}
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 20,
"success": true,
"fail": false
}
响应字段说明
| 字段名 |
类型 |
描述 |
| code |
Integer |
响应状态码,200 表示成功 |
| message |
String |
响应消息描述 |
| data |
Object |
响应数据主体 |
| data.data |
Array |
竞争店铺列表数组 |
| data.page |
Object |
分页信息对象 |
| version |
String |
API 版本号 |
| timestamp |
String |
响应时间戳 |
| sign |
String |
响应签名(预留字段) |
| success |
Boolean |
请求是否成功的布尔值 |
| fail |
Boolean |
请求是否失败的布尔值 |
竞争店铺信息字段 (data.data[])
基础信息字段
| 字段名 |
类型 |
描述 |
| id |
String |
数据记录ID,等同于id,用于系统内部关联 |
| store_id |
String |
店铺唯一标识ID,可用于查询店铺详情 |
| root_path |
String |
店铺的根域名路径。去除了协议头(https://)和www前缀的纯域名,例如:"shop.example.com"。此字段用于标识店铺的主域名 |
| shop_type |
String |
店铺使用的电商建站系统类型。常见值包括:shopify(Shopify平台)、woocommerce(WooCommerce)、magento(Magento)、shoplazza(店匠)、shopline(店线通)、shopyy(ShopYY)、squarespace、wix、prestashop、bigcommerce、ecwid、cafe24、wordpress等。此字段有助于了解竞争对手的技术栈 |
| plat_type |
Array[String] |
该店铺投放广告的平台列表。可能的值:["tiktok", "facebook", "facebook-library"]。其中"tiktok"表示TikTok平台,"facebook"表示Facebook广告平台,"facebook-library"表示Meta广告资料库。此字段帮助您了解竞争对手的广告投放渠道 |
| icon |
String |
店铺的头像/Logo图片完整URL地址。图片托管在CDN上,格式为:"https://fb-cdn.pipispy.com/images/xxxxx.png"。如果店铺未设置头像,则返回默认图标或空字符串 |
| is_collection |
Boolean |
当前API调用用户是否已收藏该竞争店铺。true表示已收藏,false表示未收藏。此字段用于前端展示收藏状态 |
| popular_person_count |
Long |
关注该店铺的用户总数。表示有多少用户将该店铺添加到了关注列表,可作为店铺受欢迎程度的参考指标 |
综合平台数据字段(all_前缀)
以下字段统计了该店铺在所有广告平台(TikTok + Facebook + Meta广告资料库)的汇总数据:
| 字段名 |
类型 |
描述 |
| all_data_count |
Long |
所有平台的广告总数。统计该店铺在TikTok、Facebook和Meta广告资料库中发布的所有广告素材总数量 |
| all_play_count |
Long |
所有平台的广告总播放/曝光次数。对于视频广告表示播放次数,对于图片广告表示展示次数。此数值越大说明广告覆盖面越广 |
| all_digg_count |
Long |
所有平台的广告总点赞数。仅统计支持点赞功能的平台(如TikTok)的点赞数,可反映广告的用户互动程度 |
| all_put_days |
Long |
所有平台的广告投放总天数。从该店铺首次投放广告到最后一次投放广告的累计天数,表示店铺的广告投放持续时间 |
| all_found_time |
Long |
所有平台中最早发现的广告投放时间。Unix时间戳格式(秒级),表示系统记录到该店铺第一条广告的时间。可用于判断店铺进入市场的时间 |
| all_latest_found_time |
Long |
所有平台中最近发现的广告投放时间。Unix时间戳格式(秒级),表示系统记录到该店铺最新一条广告的时间。可用于判断店铺是否仍在活跃投放广告 |
| all_min_cpm |
Double |
所有平台的最低CPM(千次展示成本)预估值,单位:美元(USD)。CPM是衡量广告成本效益的重要指标,此值为系统基于广告数据预估的最低成本 |
| all_max_cpm |
Double |
所有平台的最高CPM(千次展示成本)预估值,单位:美元(USD)。与all_min_cpm配合使用,可了解该店铺广告投放的成本区间 |
| all_min_cpa |
Long |
所有平台的最低预估订单转化数。基于广告曝光数据和行业转化率模型预估的最少订单数量,仅供参考 |
| all_max_cpa |
Long |
所有平台的最高预估订单转化数。基于广告曝光数据和行业转化率模型预估的最多订单数量,仅供参考 |
| all_page_count |
Long |
所有平台的广告主账号总数。统计为该店铺投放广告的不同广告主账号(Page/Account)数量。一个店铺可能使用多个账号投放广告 |
| all_store_ad_state |
Integer |
店铺在所有平台的综合广告投放状态。取值:-1表示已停止投放(最近3天无新广告),0表示已下架,1表示活跃投放(最近3天有新广告)。此字段帮助判断竞争对手当前是否活跃 |
TikTok平台数据字段(tiktok_前缀)
以下字段仅统计该店铺在TikTok平台的广告数据:
| 字段名 |
类型 |
描述 |
| tiktok_data_count |
Long |
TikTok平台的广告总数。仅统计在TikTok平台发布的广告素材数量 |
| tiktok_play_count |
Long |
TikTok平台的广告总播放次数。仅统计TikTok平台广告的视频播放次数或图片展示次数 |
| tiktok_page_count |
Long |
TikTok平台的广告主账号数。统计在TikTok平台为该店铺投放广告的不同账号数量 |
| tiktok_min_cpm |
Double |
TikTok平台的最低CPM预估值,单位:美元(USD) |
| tiktok_max_cpm |
Double |
TikTok平台的最高CPM预估值,单位:美元(USD) |
| tiktok_min_cpa |
Long |
TikTok平台的最低预估订单转化数 |
| tiktok_max_cpa |
Long |
TikTok平台的最高预估订单转化数 |
| tiktok_put_days |
Long |
TikTok平台的广告投放天数。从首次投放到最后一次投放的累计天数 |
| tiktok_found_time |
Long |
TikTok平台首次发现广告的时间,Unix时间戳(秒) |
| tiktok_latest_found_time |
Long |
TikTok平台最近发现广告的时间,Unix时间戳(秒) |
| tiktok_store_ad_state |
Integer |
TikTok平台广告投放状态。-1=已停止,0=已下架,1=活跃 |
Facebook平台数据字段(facebook_前缀)
以下字段仅统计该店铺在Facebook广告平台的数据:
| 字段名 |
类型 |
描述 |
| facebook_data_count |
Long |
Facebook平台的广告总数。仅统计在Facebook广告平台发布的广告素材数量 |
| facebook_play_count |
Long |
Facebook平台的广告总曝光/展示次数 |
| facebook_page_count |
Long |
Facebook平台的广告主账号数。统计在Facebook平台为该店铺投放广告的不同Page账号数量 |
| facebook_min_cpm |
Double |
Facebook平台的最低CPM预估值,单位:美元(USD) |
| facebook_max_cpm |
Double |
Facebook平台的最高CPM预估值,单位:美元(USD) |
| facebook_min_cpa |
Long |
Facebook平台的最低预估订单转化数 |
| facebook_max_cpa |
Long |
Facebook平台的最高预估订单转化数 |
| facebook_put_days |
Long |
Facebook平台的广告投放天数 |
| facebook_found_time |
Long |
Facebook平台首次发现广告的时间,Unix时间戳(秒) |
| facebook_latest_found_time |
Long |
Facebook平台最近发现广告的时间,Unix时间戳(秒) |
| facebook_store_ad_state |
Integer |
Facebook平台广告投放状态。-1=已停止,0=已下架,1=活跃 |
以下字段仅统计该店铺在Meta广告资料库(Facebook Ad Library)的公开数据:
| 字段名 |
类型 |
描述 |
| facebook_library_data_count |
Long |
Meta广告资料库中的广告总数。统计在Meta广告资料库公开展示的广告素材总数 |
| facebook_library_play_count |
Long |
Meta广告资料库的广告总曝光次数 |
| facebook_library_reach |
Long |
Meta广告资料库的广告覆盖人数(Reach)。表示广告至少展示一次的独立用户数量,数据来源于Meta官方公开数据,是衡量广告触达范围的重要指标 |
| facebook_library_page_count |
Long |
Meta广告资料库中的广告主账号数 |
| facebook_library_adset_count |
Long |
Meta广告资料库中的广告组(Ad Set)总数。一个广告组包含多个广告素材,共享相同的受众定位和预算设置 |
| facebook_library_adset_active_count |
Long |
Meta广告资料库中正在投放的活跃广告组数量。表示当前正在运行的广告组数 |
| facebook_library_ad_active_count |
Long |
Meta广告资料库中正在投放的活跃广告数量。表示当前正在展示给用户的广告素材数 |
| facebook_library_ad_inactive_count |
Long |
Meta广告资料库中已暂停投放的广告数量。表示暂时停止投放但未删除的广告素材数 |
| facebook_library_ad_offline_count |
Long |
Meta广告资料库中已下线/删除的广告数量。表示已完全停止投放并从系统中移除的广告数 |
| facebook_library_min_cpm |
Double |
Meta广告资料库的最低CPM预估值,单位:美元(USD) |
| facebook_library_max_cpm |
Double |
Meta广告资料库的最高CPM预估值,单位:美元(USD) |
| facebook_library_min_cpa |
Long |
Meta广告资料库的最低预估订单转化数 |
| facebook_library_max_cpa |
Long |
Meta广告资料库的最高预估订单转化数 |
| facebook_library_put_days |
Long |
Meta广告资料库的广告投放天数 |
| facebook_library_found_time |
Long |
Meta广告资料库首次发现广告的时间,Unix时间戳(秒) |
| facebook_library_latest_found_time |
Long |
Meta广告资料库最近发现广告的时间,Unix时间戳(秒) |
| facebook_library_store_ad_state |
Integer |
Meta广告资料库广告投放状态。-1=已停止,0=已下架,1=活跃 |
| facebook_library_ad_platform |
Array[String] |
Meta广告资料库显示的广告投放平台列表。可能的值包括:["FACEBOOK", "INSTAGRAM", "AUDIENCE_NETWORK", "MESSENGER", "THREADS"]。表示该店铺的广告在Meta生态系统中哪些平台上展示 |
其他分类字段
| 字段名 |
类型 |
描述 |
| is_ai |
Boolean |
是否为AI相关产品/服务店铺。true表示该店铺主要销售或推广AI相关的产品或服务,false表示非AI类店铺。此字段由系统AI算法自动识别分类 |
| is_drama |
Boolean |
是否为短剧类内容店铺。true表示该店铺主要推广短剧、剧集等视频内容,false表示非短剧类店铺。此字段由系统AI算法自动识别分类 |
| app_type2 |
String |
店铺/产品类型分类。可能的值:"web"(网站类电商)、"game"(游戏类)、"app"(移动应用类)。帮助您快速了解竞争对手的业务类型 |
| ai_category |
Array[Object] |
AI自动识别的产品分类标签数组。每个对象包含分类信息(如类目名称、分类ID等),由AI图像识别和NLP算法自动标注,帮助了解竞争对手的产品定位 |
| region |
Array[String] |
店铺广告投放的目标国家/地区列表。使用ISO 3166-1 alpha-2标准的国家代码(2位大写字母),如["US", "CA", "GB"]。表示该店铺广告定向投放的地理位置 |
广告素材展示字段
| 字段名 |
类型 |
描述 |
| good_source |
Array[Object] |
店铺最新发布的广告素材列表(最多返回3条)。展示该竞争店铺最近的广告创意,帮助您了解对手的营销策略。详细字段说明见下方"广告素材信息对象" |
网站信息字段
| 字段名 |
类型 |
描述 |
| website_info |
Object |
店铺网站的详细信息对象。包含网站流量、用户行为等数据,帮助评估竞争对手的网站运营情况。详细字段说明见下方"网站信息对象" |
广告素材信息对象 (good_source[])
| 字段名 |
类型 |
描述 |
| app_image |
String |
广告应用图标/产品图片URL。完整的CDN图片地址,格式为:"https://fb-cdn.pipispy.com/images/xxxxx.png"。通常为广告中展示的产品主图或App图标 |
| count |
Long |
该广告素材的播放/展示次数。表示这条广告被用户观看或看到的总次数,可用于评估广告的传播力度 |
| cover |
String |
广告封面图片URL。完整的CDN图片地址,格式为:"https://fb-cdn.pipispy.com/images/xxxxx.png"。对于视频广告为视频封面图,对于图片广告为主图 |
| video_id |
String |
关联的视频素材ID。如果该广告包含视频内容,此字段为视频的唯一标识符,可用于查询完整视频信息。如果是纯图片广告则可能为空 |
| platform |
Integer |
广告素材所属平台。取值:1=TikTok平台,2=Facebook平台,3=Meta广告资料库(facebook-library)。表示该广告素材来源于哪个广告平台 |
网站信息对象 (website_info)
| 字段名 |
类型 |
描述 |
| website_id |
String |
网站唯一标识ID。由域名(去除www前缀)的MD5哈希值生成,用于系统内部唯一标识一个网站 |
| website_icon |
String |
网站的Favicon图标URL。完整的CDN图片地址,通常为网站的Logo或品牌标识 |
| website_url |
String |
网站完整URL地址。包含协议头的完整网站地址,如:"https://www.example.com" |
| website_title |
String |
网站标题。从网站HTML的<title>标签中提取的网站名称或标题 |
| website_monthly_visits |
Long |
网站月访问量。表示该网站每月的访问次数(Visits),数据来源于第三方流量分析工具(如SimilarWeb)。此指标反映网站的流量规模,数值越大说明网站访问量越高 |
| website_bounce_rate |
Double |
网站跳出率。取值范围:0.0-1.0(如0.45表示45%)。跳出率是指用户访问网站后没有进行任何交互就离开的比例。跳出率越低说明网站内容质量越好、用户粘性越强 |
| website_visit_seconds |
Long |
网站平均访问时长,单位:秒。表示用户在网站上的平均停留时间。时长越长说明用户对网站内容越感兴趣、用户体验越好 |
| website_languages |
Array[String] |
网站支持的语言列表。使用ISO 639-1标准的语言代码(2位小写字母),如["en", "de", "fr"]。帮助了解竞争对手的目标市场语言 |
| website_countries |
Array[String] |
网站主要访问来源国家列表。使用ISO 3166-1 alpha-2标准的国家代码(2位大写字母),如["US", "GB", "CA"]。表示网站流量主要来自哪些国家 |
| website_currencies |
Array[String] |
网站支持的货币列表。使用ISO 4217标准的货币代码(3位大写字母),如["USD", "EUR", "GBP"]。帮助了解竞争对手的目标市场和定价策略 |
| website_what_is_summary |
String |
网站描述摘要。简要描述网站的主要业务、产品或服务内容,通常从网站的Meta Description或About页面提取 |
分页信息对象 (page)
| 字段名 |
类型 |
描述 |
| total_count |
Long |
符合条件的竞争店铺总记录数 |
| page_count |
Long |
总页数。根据total_count和page_size计算得出:page_count = ⌈total_count / page_size⌉ |
| current_page |
Long |
当前页码。与请求参数中的current_page一致 |
| page_size |
Long |
每页记录数。与请求参数中的page_size一致 |
| is_next |
Boolean |
是否有下一页。true表示还有更多数据可以查询,false表示已是最后一页 |
响应示例
{
"code": 200,
"message": "success",
"data": {
"data": [
{
"id": "690b25aabf0efeab51093e0c",
"icon": "https://cdn-video.pipiads.com/avatar_d1046d3f1fac466bdba8.jpg",
"store_id": "2e93e5996be3a",
"root_path": "femin.lol",
"shop_type": "shopify",
"plat_type": [
"tiktok"
],
"good_source": [
{
"cover": "https://cdn-video.pipiads.com/cover_d1046d3f1fac466bdba8.jpg",
"app_image": "https://cdn-video.pipiads.com/avatar_d1046d3f1fac466bdba8.jpg",
"count": 94365,
"video_id": "d1046d3f1fac466bdba8",
"platform": 0
},
{
"cover": "https://cdn-video.pipiads.com/cover_a497f88964b28c573128.jpg",
"app_image": "https://cdn-video.pipiads.com/avatar_a497f88964b28c573128.jpg",
"count": 1721,
"video_id": "a497f88964b28c573128",
"platform": 0
},
{
"cover": "https://cdn-video.pipiads.com/cover_9cb2ffef3392a20a7fde.jpg",
"app_image": "https://cdn-video.pipiads.com/avatar_9cb2ffef3392a20a7fde.jpg",
"count": 20618,
"video_id": "9cb2ffef3392a20a7fde",
"platform": 0
}
],
"is_collection": false,
"popular_person_count": 2,
"website_info": {
"website_icon": "https://cdn-video.pipiads.com/avatar_d1046d3f1fac466bdba8.jpg",
"website_title": "femin.lol"
},
"all_data_count": 6,
"tiktok_data_count": 6,
"facebook_data_count": 0,
"all_page_count": 2,
"all_play_count": 148119,
"tiktok_play_count": 148119,
"facebook_play_count": 0,
"all_min_cpm": 212.8,
"all_max_cpm": 852.7,
"tiktok_min_cpm": 212.87,
"tiktok_max_cpm": 852.74,
"facebook_min_cpm": 0.0,
"facebook_max_cpm": 0.0,
"all_min_cpa": 9,
"all_max_cpa": 94,
"tiktok_min_cpa": 9,
"tiktok_max_cpa": 94,
"facebook_min_cpa": 0,
"facebook_max_cpa": 0,
"all_put_days": 1,
"tiktok_put_days": 1,
"facebook_put_days": 0,
"all_found_time": 1699580469,
"tiktok_found_time": 1699580469,
"facebook_found_time": 0,
"all_latest_found_time": 1719449698,
"tiktok_latest_found_time": 1719449698,
"facebook_latest_found_time": 0,
"tiktok_store_ad_state": -1,
"facebook_store_ad_state": -1,
"facebook_library_store_ad_state": -1,
"all_store_ad_state": -1
}
],
"page": {
"total_count": 257,
"current_page": 50,
"page_count": 257,
"page_size": 1
}
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 20,
"success": true,
"fail": false
}
错误码说明
| 错误码 |
描述 |
解决方案 |
| 200 |
成功 |
- |
| 400 |
请求参数错误 |
检查id或product_id格式是否正确(必须是有效的MongoDB ObjectId) |
| 401 |
未授权 |
检查API Key是否有效,是否已过期 |
| 403 |
权限不足 |
检查API Key是否有访问此接口的权限 |
| 404 |
店铺/产品不存在 |
检查id或product_id是否正确,该资源是否已从系统中删除 |
| 500 |
服务器内部错误 |
联系技术支持或稍后重试 |