接口参考

单商品店铺列表 API

GET/open-api/v1/shop/single-product-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/single-product-shop' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}'

请求参数 34 项

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

参数	类型	说明
url query · 可选	string	店铺Url，多个值需要使用英文逗号“,”分隔。
tags query · 可选	string	标签，多个值需要使用英文逗号“,”分隔。
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	店铺货币，多个值需要使用英文逗号“,”分隔。
social_media query · 可选	string	社交媒体，多个值需要使用英文逗号“,”分隔。可选值：facebook，instagram，tiktok，twitter，pinterest，youtube。
themes query · 可选	string	按主题/主题名字来搜索店铺
app query · 可选	string	按安装的应用来搜索店铺
pixel_text query · 可选	string	按像素名字或id来搜索店铺
page query · 可选	integer	页码，最小值等于1。
per_page query · 可选	integer	分页大小，取值范围1-100。
order_by query · 可选	string	排序字段，可选值：last_sold_at-最新出单时间，published_products_count-店铺产品数，last_product_published_at-最新产品创建时间，first_product_published_at-创建时间，month_visits-月访问量，monthly_sale-月销量，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	美元月收入（结束）
category_tags query · 可选	string	商品类型，多个值需要使用英文逗号“,”分隔。可选值：1-Dropshipping，2-Print on demand (POD)，3-Cash/collect on delivery (COD)，4-Digital products。

返回示例

返回示例 · JSON

{
    "code": 200,
    "message": "请求成功",
    "data": {
        "data": [
            {
                "id": 8064761971,
                "name": "Babylist",
                "url": "https:\/\/checkout.babylist.com",
                "domain": "checkout.babylist.com",
                "tags": [
                    "showroom",
                    "return",
                    "gift",
                    "card"
                ],
                "currency": "USD",
                "category_tags": [],
                "ads_platforms": [
                    "facebook"
                ],
                "user_collected": 0,
                "product": {
                    "id": 7178069409907,
                    "created_at": 1689956748,
                    "updated_at": 1754974481,
                    "images": [],
                    "price": 25,
                    "price_usd": 25,
                    "monthly_sale": 6391,
                    "monthly_revenue": 159775,
                    "monthly_revenue_usd": 159775
                }
            },
            {
                "id": 79513387341,
                "name": "vivanmn",
                "url": "https:\/\/vivanmn.com",
                "domain": "vivanmn.com",
                "tags": [
                    "pure",
                    "nmn",
                    "500mg",
                    "capsules"
                ],
                "currency": "GBP",
                "category_tags": [],
                "ads_platforms": [
                    "tiktok"
                ],
                "user_collected": 0,
                "product": {
                    "id": 8764586066253,
                    "created_at": 1702370237,
                    "updated_at": 1754715901,
                    "images": [
                        "https:\/\/cdn.shopify.com\/s\/files\/1\/0795\/1338\/7341\/files\/NMNSide2_7_0a790628-a6ee-47d3-a1bc-5caacbe4370f.png?v=1712346641"
                    ],
                    "price": 29.99,
                    "price_usd": 40.27,
                    "monthly_sale": null,
                    "monthly_revenue": null,
                    "monthly_revenue_usd": null
                }
            }
        ],
        "last_page": 5139,
        "current_page": 1,
        "total": 102772,
        "per_page": 20
    },
    "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
»»» name	string	true	none	商家名字	none
»»» url	string	true	none	店铺Url	none
»»» domain	string	true	none	店铺域名	none
»»» tags	[string]	true	none	店铺的标签	none
»»» user_collected	integer	true	none	是否已收藏	0-未收藏，1-已收藏
»»» currency	string	true	none	店铺货币	none
»»» ads_platforms	[string]	true	none	广告平台	none
»»» product	object	true	none	产品信息	none
»»»» id	integer	true	none	产品ID	none
»»»» created_at	integer	true	none	创建时间	时间戳：秒。
»»»» updated_at	integer	true	none	最新出单时间	时间戳：秒。
»»»» images	[string]	true	none	产品图片列表	none
»»»» price	number	true	none	价格	none
»»»» price_usd	number¦null	true	none	美元价格	none
»»»» monthly_sale	integer¦null	true	none	月销量	none
»»»» monthly_revenue	number¦null	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/single-product-shop
价格说明: 每获取一条记录扣除1积分