PPSPYAPI Platform
中文 / EN
文档/销量监控/接口参考
接口参考

销量监控任务详情 API

GET/open-api/v1/sales-monitor-task/detail
免费·api.ppspy.com
数据与监控消耗规则

数据消耗规则：1. 获取一条shopify数据结果消耗 1 数据 或者 获取一条广告库数据结果消耗 2 数据，获取数据结果的更多数据详情不消耗数据。 2. 广告监控 & 销量监控，每次监控 $1 / 月。单个监控有效期为一个月，一个月后自动停止。删除监控不会恢复监控次数，请谨慎删除。监控调用为随时且无限次。

请求头

AUTHORIZATIONAuthorization: {API Key}
CONTENT-TYPEapplication/json
ACCEPTapplication/json

请求示例

cURL
curl --location --request GET 'https://api.ppspy.com/open-api/v1/sales-monitor-task/detail?site_domain=wheelsup.cz&period_id=9e22dafdfa8899970767642edfcfb123b35ba89338637be7f0a650e861f2bea4' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}'

请求参数 2 项

按参数标注的位置传入请求。

参数 类型 说明
site_domain
query · 必填
string 店铺域名 |
period_id
query · 可选
string 监控周期ID，不填写时，默认返回最新一个监控周期的数据。 |

返回示例

返回示例 · JSON
{
    "code": 200,
    "message": "success",
    "data": {
        "monitor_site": {
            "site_domain": "wheelsup.cz",
            "site_name": "WheelsUp",
            "site_icon": "https://wheelsup.cz/cdn/shop/files/apple-touch-icon.png?crop=center&height=96&v=1675197115&width=96",
            "currency": "CZK",
            "monitor_task_status": 1,
            "note": null,
            "monthly_visits": 0,
            "tracked_users": 0,
            "first_product_created_at": 1670722999,
            "is_fake_sales": false
        },
        "periods": [
            {
                "id": "9e22dafdfa8899970767642edfcfb123b35ba89338637be7f0a650e861f2bea4",
                "started_at": 1762504305,
                "ended_at": 1762766114,
                "task_status": 1,
                "reported_at": 1762758710
            }
        ],
        "period_details": {
            "income": 205636976.8,
            "sales": 19472,
            "income_today": 19822340.05,
            "sales_today": 1877,
            "income_yesterday": 69985427.55,
            "sales_yesterday": 6627,
            "product_quantity": 25001,
            "product_avg_price": 10560.65,
            "income_usd": 0,
            "income_usd_today": 0,
            "income_usd_yesterday": 0,
            "income_7days": 205636976.8,
            "income_usd_7days": 0,
            "sales_7days": 19472,
            "product_avg_price_usd": null,
            "real_time_sales_task_id": "e72e0578cc760e7f06989082bde42547"
        },
        "sales_daily": [
            {
                "sold_date": "2025-11-07",
                "income": 43446514.1,
                "income_usd": null,
                "sales": 4114,
                "sales_hour": []
            },
            {
                "sold_date": "2025-11-08",
                "income": 72382695.1,
                "income_usd": null,
                "sales": 6854,
                "sales_hour": []
            },
            {
                "sold_date": "2025-11-09",
                "income": 69985427.55,
                "income_usd": null,
                "sales": 6627,
                "sales_hour": []
            },
            {
                "sold_date": "2025-11-10",
                "income": 19822340.05,
                "income_usd": null,
                "sales": 1877,
                "sales_hour": [
                    {
                        "sold_date": "2025-11-10",
                        "sold_hour": "2025-11-10 00:00:00",
                        "income": 3168195,
                        "income_usd": null,
                        "sales": 300
                    },
                    {
                        "sold_date": "2025-11-10",
                        "sold_hour": "2025-11-10 01:00:00",
                        "income": 2428949.5,
                        "income_usd": null,
                        "sales": 230
                    },
                    {
                        "sold_date": "2025-11-10",
                        "sold_hour": "2025-11-10 02:00:00",
                        "income": 2978103.3,
                        "income_usd": null,
                        "sales": 282
                    },
                    {
                        "sold_date": "2025-11-10",
                        "sold_hour": "2025-11-10 03:00:00",
                        "income": 2978103.3,
                        "income_usd": null,
                        "sales": 282
                    },
                    {
                        "sold_date": "2025-11-10",
                        "sold_hour": "2025-11-10 04:00:00",
                        "income": 2407828.2,
                        "income_usd": null,
                        "sales": 228
                    },
                    {
                        "sold_date": "2025-11-10",
                        "sold_hour": "2025-11-10 05:00:00",
                        "income": 2714087.05,
                        "income_usd": null,
                        "sales": 257
                    },
                    {
                        "sold_date": "2025-11-10",
                        "sold_hour": "2025-11-10 06:00:00",
                        "income": 2756329.65,
                        "income_usd": null,
                        "sales": 261
                    },
                    {
                        "sold_date": "2025-11-10",
                        "sold_hour": "2025-11-10 07:00:00",
                        "income": 390744.05,
                        "income_usd": null,
                        "sales": 37
                    }
                ]
            }
        ],
        "sales_today": {
            "sales_hour": [
                {
                    "sold_date": "2025-11-10",
                    "sold_hour": "2025-11-10 00:00:00",
                    "income": 3168195,
                    "income_usd": null,
                    "sales": 300
                },
                {
                    "sold_date": "2025-11-10",
                    "sold_hour": "2025-11-10 01:00:00",
                    "income": 2428949.5,
                    "income_usd": null,
                    "sales": 230
                },
                {
                    "sold_date": "2025-11-10",
                    "sold_hour": "2025-11-10 02:00:00",
                    "income": 2978103.3,
                    "income_usd": null,
                    "sales": 282
                },
                {
                    "sold_date": "2025-11-10",
                    "sold_hour": "2025-11-10 03:00:00",
                    "income": 2978103.3,
                    "income_usd": null,
                    "sales": 282
                },
                {
                    "sold_date": "2025-11-10",
                    "sold_hour": "2025-11-10 04:00:00",
                    "income": 2407828.2,
                    "income_usd": null,
                    "sales": 228
                },
                {
                    "sold_date": "2025-11-10",
                    "sold_hour": "2025-11-10 05:00:00",
                    "income": 2714087.05,
                    "income_usd": null,
                    "sales": 257
                },
                {
                    "sold_date": "2025-11-10",
                    "sold_hour": "2025-11-10 06:00:00",
                    "income": 2756329.65,
                    "income_usd": null,
                    "sales": 261
                },
                {
                    "sold_date": "2025-11-10",
                    "sold_hour": "2025-11-10 07:00:00",
                    "income": 390744.05,
                    "income_usd": null,
                    "sales": 37
                }
            ]
        }
    },
    "credits": {
        "remaining_credits": 745,
        "consumed_credits": 0,
        "total_credits": 745
    }
}
文档中的示例数据

返回数据结构

名称 类型 必选 约束 中文名 说明
» code integer true none 业务状态码 none
» message string true none 响应的消息 none
» data object true none 响应的数据 none
»» monitor_site object false none 店铺基本信息 none
»»» site_domain string true none 店铺域名 none
»»» site_name string true none 店铺名称 none
»»» site_icon string¦null true none 店铺图标 none
»»» currency string true none 货币 none
»»» monitor_task_status integer true none 监控任务状态 可选值：0-已停止，1-监控中。
»»» note string¦null true none 备注 none
»»» monthly_visits integer¦null true none 每月访问量 none
»»» tracked_users integer true none 同时监控的用户数量 none
»»» first_product_created_at integer¦null true none 首个商品的创建时间 时间戳：秒。
»»» is_fake_sales boolean¦null true none 是否监控虚假销量的店铺 none
»» periods [object] false none 监控周期列表 none
»»» id string true none 监控周期ID none
»»» started_at integer true none 监控开始时间 时间戳：秒。
»»» ended_at integer true none 监控结束时间 时间戳：秒。
»»» task_status integer true none 监控任务状态 可选值：0-已停止，1-监控中。
»»» reported_at integer¦null true none 最后统计时间 时间戳：秒。
»» period_details object false none 当前周期（监控时间段）的监控数据 none
»»» income number¦null true none 预估总销售额 none
»»» sales integer¦null true none 总销量 none
»»» income_today number¦null true none 今日预估销售额 none
»»» sales_today integer¦null true none 今日销量 none
»»» income_yesterday number¦null true none 昨日预估销售额 none
»»» sales_yesterday integer¦null true none 昨日销量 none
»»» income_7days number¦null true none 7日预估销售额 none
»»» income_usd_7days number¦null true none 7日预估销售额（美元） none
»»» sales_7days integer true none 7日销量 none
»»» product_quantity integer¦null true none 店铺商品数 none
»»» product_avg_price number¦null true none 店铺平均价格 none
»»» product_avg_price_usd number¦null true none 店铺平均价格（美元） none
»»» income_usd number¦null true none 预估总销售额（美元） none
»»» income_usd_today number¦null true none 今日预估销售额（美元） none
»»» income_usd_yesterday number¦null true none 昨日预估销售额（美元） none
»»» real_time_sales_task_id string¦null true none 实时销量的任务ID 监控中才会返回，否则为null
»» sales_daily [object] false none 每日销售统计 none
»»» sold_date string true none 销售日期 UTC时间
»»» income number true none 当日预估销售额 none
»»» sales integer true none 当日销量 none
»»» income_usd number¦null true none 当预估销售额（美元） none
»»» sales_hour [object] true none 每小时销售统计 none
»»»» sold_hour string true none 销售时间 UTC时间
»»»» income number true none 预估销售额 none
»»»» sales integer true none 销量 none
»»»» income_usd number¦null true none 收入（美元） none
»» sales_today object false none 今日销量统计 none
»»» sales_hour [object] true none 每小时销售统计 none
»»»» sold_hour string true none 销售时间 UTC时间
»»»» income number true none 预估销售额 none
»»»» sales integer true none 销量 none
»»»» income_usd number¦null true none 预估销售额（美元） none
» credits object true none Credits 信息 当前 API 请求对应的 credits 信息
»» remaining_credits integer true none 剩余 credits 本次请求后剩余的 credits 数量
»» consumed_credits integer true none 消耗 credits 本次请求消耗的 credits 数量
»» total_credits integer true none 总 credits 当前 credits 类型的总数量
原始接口信息与服务地址

Base URLs

  • 生产环境: https://api.ppspy.com

接口信息

  • 接口名称: 销量监控任务详情
  • 请求方法: GET
  • 接口地址: /open-api/v1/sales-monitor-task/detail
  • 价格说明: 免费
GET查询当前积分/open-api/v1/creditsGETShopify店铺列表/open-api/v1/shopGETShopify店铺详情/open-api/v1/shop/{id}GET店铺流量列表/open-api/v1/shop/traffic-shopGET单商品店铺列表/open-api/v1/shop/single-product-shopGET店铺主题模版库/open-api/v1/shop/theme-shopGETShopify产品列表/open-api/v1/productGETShopify畅销产品列表/open-api/v1/bestsellersPOST广告列表/open-api/v1/advertisements/searchGET广告详情/open-api/v1/advertisements/{id}POST广告店铺列表/open-api/v1/ad-stores/searchGET广告店铺详情/open-api/v1/ad-stores/{id}GET广告店铺的落地页统计/open-api/v1/ad-stores/landing-pages-ad-countGET店铺的广告趋势/open-api/v1/ad-stores/analysisGET店铺的投放分析/open-api/v1/ad-stores/deep-analysisGET店铺的广告文案 最多使用/open-api/v1/ad-stores/ad-contentGET店铺的广告文案 最长运营/open-api/v1/ad-stores/ad-content-longest-runGET店铺的广告主/open-api/v1/ad-stores/advertisersPOST广告产品列表/open-api/v1/ad-products/searchGET广告产品详情/open-api/v1/ad-products/{id}POST创建分组/open-api/v1/ad-monitor-groupsGET分组列表/open-api/v1/ad-monitor-groupsPUT编辑分组/open-api/v1/ad-monitor-groups/{id}DELETE删除分组/open-api/v1/ad-monitor-groups/{id}POST搜索广告主/open-api/v1/ad-monitor-task/search-fb-ads-advertiser
来自现有接口目录与文档 · 支持接口名称和地址搜索