接口参考

店铺主题模版库 API

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

请求参数 25 项

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

参数	类型	说明
url query · 可选	string	店铺Url，多个值需要使用英文逗号“,”分隔。
tags query · 可选	string	标签，多个值需要使用英文逗号“,”分隔。
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_text query · 可选	string	主题名称
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-月访问量。
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	排除店铺描述，多个值需要使用英文逗号“,”分隔。
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",
                "url": "https://bloomchic.com",
                "domain": "bloomchic.com",
                "boom_theme": "Impulse",
                "shopify_theme": "生产环境",
                "web_snapshot": "https://web-screenshot.ppspy.com/shopify/123.jpeg",
                "first_product_published_at": 1615691957,
                "category_tags": null
            },
            {
                "id": 499112,
                "name": "Bodega  Store",
                "url": "https://bdgastore.com",
                "domain": "bdgastore.com",
                "boom_theme": null,
                "shopify_theme": "bodega-shopify/main",
                "web_snapshot": "https://web-screenshot.ppspy.com/shopify/c8b0a325fefe5f638fa9e36bfe263d46.jpeg",
                "first_product_published_at": 1462909661,
                "category_tags": null
            }
        ],
        "last_page": 53,
        "current_page": 1,
        "total": 105,
        "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
»»» name	string	true	none	商家名字	none
»»» url	string	true	none	店铺Url	none
»»» domain	string	true	none	店铺域名	none
»»» boom_theme	string¦null	true	none	主题名称	none
»»» shopify_theme	string¦null	true	none	自定义主题名字	none
»»» web_snapshot	string¦null	true	none	网站快照	none
»»» first_product_published_at	integer¦null	true	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/theme-shop
价格说明: 每获取一条记录扣除1积分