接口参考

店铺流量列表 API

GET/open-api/v1/shop/traffic-shop

每获取一条记录扣除1积分·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/shop/traffic-shop' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}'

请求参数 45 项

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

参数	类型	说明
url query · 可选	string	店铺Url，多个值需要使用英文逗号“,”分隔。
pixel query · 可选	string	广告平台，多个值需要使用英文逗号“,”分隔。可选值：snap，tiktok，pinterest。
last_sold_at_start query · 可选	string	最新出单时间（开始），格式：Y-m-d，示例：2025-01-01。
last_sold_at_end query · 可选	string	最新出单时间（结束），格式：Y-m-d，示例：2025-01-01。
month_visits_start query · 可选	integer	月访问量（开始）
month_visits_end query · 可选	integer	月访问量（结束）
published_products_count_start query · 可选	integer	店铺产品数（开始）
published_products_count_end query · 可选	integer	店铺产品数（结束）
language query · 可选	string	店铺语言，多个值需要使用英文逗号“,”分隔。
country query · 可选	string	店铺地区，多个值需要使用英文逗号“,”分隔。
last_product_published_at_start query · 可选	string	最新产品创建时间（开始），格式：Y-m-d，示例：2025-01-01。
last_product_published_at_end query · 可选	string	最新产品创建时间（结束），格式：Y-m-d，示例：2025-01-01。
first_product_published_at_start query · 可选	string	创建时间（开始），格式：Y-m-d，示例：2025-01-01。
first_product_published_at_end query · 可选	string	创建时间（结束），格式：Y-m-d，示例：2025-01-01。
currency query · 可选	string	店铺货币，多个值需要使用英文逗号“,”分隔。
page query · 可选	integer	页码，最小值等于1。
per_page query · 可选	integer	分页大小，取值范围1-100。
order_by query · 可选	string	排序字段，可选值：direct-直接访问，mail-邮件，paid_referrals-展示广告，referrals-外链引荐，search-搜索，social-社交灭提，growth-访问增加，growth_rate-访问增长率，month_visits-月访问量，monthly_revenue-月收入。
direction query · 可选	string	排序方式，可选值：desc-降序，asc-升序。
description query · 可选	string	店铺描述，多个值需要使用英文逗号“,”分隔。
title query · 可选	string	店铺Title，多个值需要使用英文逗号“,”分隔。
exclude_title query · 可选	string	排除店铺Title，多个值需要使用英文逗号“,”分隔。
exclude_url query · 可选	string	排除店铺Url，多个值需要使用英文逗号“,”分隔。
exclude_description query · 可选	string	排除店铺描述，多个值需要使用英文逗号“,”分隔。
monthly_sale_start query · 可选	integer	月销量（开始）
monthly_sale_end query · 可选	integer	月销量（结束）
monthly_revenue_start query · 可选	number	美元月收入（开始）
monthly_revenue_end query · 可选	number	美元月收入（结束）
direct_start query · 可选	number	流量来源是直接访问的占比（开始），取值范围0-1。
direct_end query · 可选	number	流量来源是直接访问的占比（结束），取值范围0-1。
mail_start query · 可选	number	流量来源是邮件的占比（开始），取值范围0-1。
mail_end query · 可选	number	流量来源是邮件的占比（结束），取值范围0-1。
paid_referrals_start query · 可选	number	流量来源是展示广告的占比（开始），取值范围0-1。
paid_referrals_end query · 可选	number	流量来源是展示广告的占比（结束），取值范围0-1。
referrals_start query · 可选	number	流量来源是外链引荐的占比（开始），取值范围0-1。
referrals_end query · 可选	number	流量来源是外链引荐的占比（结束），取值范围0-1。
search_start query · 可选	number	流量来源是搜索的占比（开始），取值范围0-1。
search_end query · 可选	number	流量来源是搜索的占比（结束），取值范围0-1。
social_start query · 可选	number	流量来源是社交媒体的占比（开始），取值范围0-1。
social_end query · 可选	number	流量来源是社交媒体的占比（结束），取值范围0-1。
growth_start query · 可选	integer	访问增长（开始）
growth_end query · 可选	integer	访问增长（结束）
growth_rate_start query · 可选	number	访问增长率（开始），取值范围0-1。
growth_rate_end query · 可选	number	访问增长率（结束），取值范围0-1。
category_tags query · 可选	string	商品类型，多个值需要使用英文逗号“,”分隔。可选值：1-Dropshipping，2-Print on demand (POD)，3-Cash/collect on delivery (COD)，4-Digital products。

返回示例

返回示例 · JSON

{
    "code": 200,
    "message": "success",
    "data": {
        "data": [
            {
                "id": 51071713450,
                "name": "BloomChic",
                "web_snapshot": "https://web-screenshot.ppspy.com/shopify/123.jpeg",
                "url": "https://bloomchic.com",
                "domain": "bloomchic.com",
                "tags": [
                    "pocket",
                    "dress",
                    "solid",
                    "neck",
                    "sleeve",
                    "ruffle",
                    "floral",
                    "button",
                    "hem",
                    "v"
                ],
                "month_visits": 1152049,
                "last_sold_at": 1678860714,
                "country": "HK",
                "monthly_sale": 67521,
                "monthly_revenue": 1800201.3,
                "published_products_count": 4890,
                "currency": "USD",
                "category_tags": null,
                "user_collected": 0,
                "growth": -113490,
                "growth_rate": -0.0897,
                "bounce_rate": 0.3438168040011765,
                "traffic_sources": {
                    "Mail": 0.02260848470151113,
                    "Direct": 0.4751189773580862,
                    "Search": 0.18168899075150327,
                    "Social": 0.2366663899874296,
                    "Referrals": 0.010025684541017647,
                    "Paid Referrals": 0.0738914726604522
                },
                "estimated_monthly_visits_list": [
                    {
                        "date": "2022-12-01",
                        "value": 1619796
                    },
                    {
                        "date": "2023-01-01",
                        "value": 1265539
                    },
                    {
                        "date": "2023-02-01",
                        "value": 1152049
                    }
                ],
                "top_country_shares": [
                    {
                        "value": 0.7338776021052733,
                        "country": 840,
                        "two_code": "US"
                    },
                    {
                        "value": 0.09193735327006752,
                        "country": 124,
                        "two_code": "CA"
                    },
                    {
                        "value": 0.05230801973565279,
                        "country": 826,
                        "two_code": "GB"
                    },
                    {
                        "value": 0.021218671670495334,
                        "country": 36,
                        "two_code": "AU"
                    },
                    {
                        "value": 0.019929043821990625,
                        "country": 276,
                        "two_code": "DE"
                    }
                ],
                "monthly_revenue_usd": 1800201.3
            },
            {
                "id": 1566146,
                "name": "Gymshark US",
                "web_snapshot": null,
                "url": "https://www.gymshark.com",
                "domain": "www.gymshark.com",
                "tags": [
                    "gymshark",
                    "black",
                    "seamless",
                    "t",
                    "shirt",
                    "grey",
                    "shorts",
                    "sport",
                    "marl",
                    "blue"
                ],
                "month_visits": null,
                "last_sold_at": 1678449318,
                "country": "US",
                "monthly_sale": 54438,
                "monthly_revenue": 1911258.8,
                "published_products_count": 2234,
                "currency": "USD",
                "category_tags": null,
                "user_collected": 0,
                "growth": 0,
                "growth_rate": 0,
                "bounce_rate": 0,
                "traffic_sources": {},
                "estimated_monthly_visits_list": [],
                "top_country_shares": [],
                "monthly_revenue_usd": 1911258.8
            }
        ],
        "last_page": 428994,
        "current_page": 1,
        "total": 857987,
        "per_page": 2
    },
    "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
»» data	[object]	true	none	数据列表	none
»»» id	integer	true	none	店铺ID	none
»»» country	string	true	none	店铺地区	none
»»» name	string	true	none	商家名字	none
»»» web_snapshot	string¦null	true	none	网站快照	none
»»» url	string	true	none	店铺Url	none
»»» domain	string	true	none	店铺域名	none
»»» tags	[string]	true	none	店铺的标签	none
»»» month_visits	integer¦null	true	none	月访问量	none
»»» user_collected	integer	false	none	是否已收藏	0-未收藏，1-已收藏
»»» last_sold_at	integer¦null	true	none	最新出单时间	时间戳：秒。
»»» monthly_sale	integer¦null	true	none	月销量	none
»»» monthly_revenue	number¦null	true	none	月收入	none
»»» published_products_count	integer	true	none	店铺产品数	none
»»» currency	string	true	none	店铺货币	none
»»» growth	integer¦null	true	none	访问增长	none
»»» growth_rate	number¦null	true	none	访问增长率	取值范围0-1。
»»» bounce_rate	number¦null	true	none	跳出率	取值范围0-1。
»»» traffic_sources	object¦null	true	none	流量来源占比	none
»»»» Mail	number¦null	false	none	邮件	取值范围0-1。
»»»» Direct	number¦null	false	none	直接访问	取值范围0-1。
»»»» Search	number¦null	false	none	搜索	取值范围0-1。
»»»» Social	number¦null	false	none	社交媒体	取值范围0-1。
»»»» Referrals	number¦null	false	none	外链引荐	取值范围0-1。
»»»» Paid Referrals	number¦null	false	none	展示广告	取值范围0-1。
»»» estimated_monthly_visits_list	[object]	true	none	月访问量的趋势	none
»»»» date	string	true	none	日期	none
»»»» value	integer	true	none	月访问量	none
»»» top_country_shares	[object]¦null	true	none	流量最高国家的占比	none
»»»» value	number	true	none	流量占比	取值范围0-1。
»»»» country	integer	true	none	国家代码	none
»»»» two_code	string	true	none	国家简码	none
»»» monthly_revenue_usd	number¦null	true	none	美元月收入	none
»» last_page	integer	true	none	最后一页的页码	none
»» current_page	integer	true	none	当前页码	none
»» total	integer	true	none	总数据量	none
»» per_page	integer	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/shop/traffic-shop
价格说明: 每获取一条记录扣除1积分