接口参考

Shopify 店铺列表 API

使用 Shopify 店铺列表 API，按店铺链接、标签、地区和月访问量等条件筛选店铺。下方提供请求参数、cURL 调用示例、JSON 返回数据与积分消耗说明。

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

请求参数 35 项

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

参数	类型	说明
url query · 可选	string	店铺链接，多个值需要使用英文逗号“,”分隔。
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	App应用，按安装的应用来搜索店铺。
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	店铺名称，多个值需要使用英文逗号“,”分隔。
exclude_title query · 可选	string	排除店铺名称，多个值需要使用英文逗号“,”分隔。
exclude_url query · 可选	string	排除店铺链接，多个值需要使用英文逗号“,”分隔。
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。
shield_shop query · 可选	integer	屏蔽异常店铺，可选值：1-是，2-否。

返回示例

返回示例 · 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",
                "first_product_published_at": 1615691957,
                "category_tags": null,
                "user_collected": 0,
                "newest_product_data": [
                    {
                        "id": 7703375282346,
                        "images": [
                            "https://cdn.shopify.com/s/files/1/0510/7171/3450/products/537471130_ix_1df8dcbc-3247-42d4-b6ed-e9bdea4efd0e.jpg?v=1678859332"
                        ]
                    },
                    {
                        "id": 7702865936554,
                        "images": [
                            "https://cdn.shopify.com/s/files/1/0510/7171/3450/products/61404126_sy.jpg?v=1678800358"
                        ]
                    },
                    {
                        "id": 7702865576106,
                        "images": [
                            "https://cdn.shopify.com/s/files/1/0510/7171/3450/products/283164683_gb_8c5b8239-7e07-46df-b908-9d15039482c0.jpg?v=1678800296"
                        ]
                    }
                ],
                "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",
                "first_product_published_at": 1473349821,
                "category_tags": null,
                "user_collected": 0,
                "newest_product_data": [
                    {
                        "id": 6805157380298,
                        "images": [
                            "https://cdn.shopify.com/s/files/1/0156/6146/products/GfxMaxedOutJoggerBlackB5A3O-BBBB-0032.3_d41b0bbb-d7b8-428b-8aea-12d786d936cc.jpg?v=1678107505"
                        ]
                    },
                    {
                        "id": 6805157347530,
                        "images": [
                            "https://cdn.shopify.com/s/files/1/0156/6146/products/IconTrendCamiTankWhiteB4A8H-WBBM-2685.32_38bce070-d832-4025-8eab-047267a1ffe4.jpg?v=1678107505"
                        ]
                    },
                    {
                        "id": 6805157216458,
                        "images": [
                            "https://cdn.shopify.com/s/files/1/0156/6146/products/GfxMaxedOutOversizedTeeWhiteB5A3V-WBBM-0454.46_0e2b2421-1ce4-4123-a61c-8f922d994381.jpg?v=1678107505"
                        ]
                    }
                ],
                "monthly_revenue_usd": 1911258.8
            }
        ],
        "last_page": 428997,
        "current_page": 1,
        "total": 857993,
        "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]	false	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	店铺链接	none
»»» domain	string	true	none	店铺域名	none
»»» tags	[string]	true	none	店铺的标签	none
»»» month_visits	integer¦null	true	none	店铺的月访问量	none
»»» user_collected	integer	true	none	是否是收藏	0：未收藏；1：已收藏；
»»» newest_product_data	[object]	true	none	最新的产品	none
»»»» id	integer	true	none	产品ID	none
»»»» images	[string]	true	none	产品图片集	none
»»» last_sold_at	integer	true	none	最新的更新时间	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
»»» category_tags	[integer]¦null	true	none	商品类型	none
»»» monthly_revenue_usd	number¦null	true	none	店铺的美元月收入	none
»» last_page	integer	false	none	最后一页的页码	none
»» current_page	integer	false	none	当前页码	none
»» total	integer	false	none	总数据量	none
»» per_page	integer	false	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

接口信息

接口名称: Shopify店铺列表
请求方法: GET
接口地址: /open-api/v1/shop
价格说明: 每获取一条记录扣除1积分