接口参考

Shopify 产品列表 API

GET/open-api/v1/product

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

请求参数 28 项

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

参数	类型	说明
title query · 可选	string	产品标题，多个值需要使用英文逗号“,”分隔。
url query · 可选	string	店铺url，多个值需要使用英文逗号“,”分隔。
pixel query · 可选	string	广告平台，多个值需要使用英文逗号“,”分隔。可选值：snap，tiktok，pinterest。
country query · 可选	string	店铺地区，多个值需要使用英文逗号“,”分隔。
created_at_start query · 可选	string	创建时间（开始），格式：Y-m-d，示例：2025-01-01。
created_at_end query · 可选	string	创建时间（结束），格式：Y-m-d，示例：2025-01-01。
updated_at_start query · 可选	string	最新出单时间（开始），格式：Y-m-d，示例：2025-01-01。
updated_at_end query · 可选	string	最新出单时间（结束），格式：Y-m-d，示例：2025-01-01。
price_start query · 可选	number	价格（开始）
price_end query · 可选	number	价格（结束）
currency query · 可选	string	店铺货币，多个值需要使用英文逗号“,”分隔。
language query · 可选	string	店铺语言，多个值需要使用英文逗号“,”分隔。
is_bestselling query · 可选	integer	是否是bestseller 1是 0否
order_by query · 可选	string	排序字段，可选值：updated_at-最新出单时间，created_at-创建时间，published_products_count-店铺产品数，price-价格，monthly_sale-月销量，monthly_revenue-月收入
direction query · 可选	string	排序方式，可选值：desc-降序，asc-升序。
page query · 可选	integer	页码，最小值等于1。
per_page query · 可选	integer	分页大小，取值范围1-100。
published_products_count_start query · 可选	integer	店铺产品数（开始）
published_products_count_end query · 可选	integer	店铺产品数（结束）
shop_id query · 可选	string	店铺ID
category_id query · 可选	integer	产品分类，多个值需要使用英文逗号“,”分隔。
monthly_sale_start query · 可选	string	月销量（开始）
monthly_sale_end query · 可选	integer	月销量（结束）
monthly_revenue_start query · 可选	number	月收入（开始）
monthly_revenue_end query · 可选	number	月收入（结束）
exclude_title query · 可选	string	排除产品标题，多个值需要使用英文逗号“,”分隔。
exclude_url query · 可选	string	排除店铺url，多个值需要使用英文逗号“,”分隔。
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": 7658016374828,
                "shop_id": 63175819308,
                "images": [
                    "https://cdn.shopify.com/s/files/1/0631/7581/9308/files/PXL_20231221_062347601.PORTRAIT.jpg?v=1719914829",
                    "https://cdn.shopify.com/s/files/1/0631/7581/9308/files/PXL_20231221_062519768.PORTRAIT.jpg?v=1719914829"
                ],
                "title": "Sienna Striped Mugs",
                "price": 1500,
                "created_at": 1719914783,
                "updated_at": 1752949914,
                "handle": "sienna-striped-mugs",
                "category_id": "62739b6038365b2f72048ec1",
                "monthly_sale": null,
                "monthly_revenue": null,
                "price_usd": 17.41,
                "category": {
                    "id": "62739b6038365b2f72048ec1",
                    "name_en": "Home & Garden",
                    "name_zh": "家居和园艺"
                },
                "shop": {
                    "id": 63175819308,
                    "name": "Asyouwish",
                    "url": "https://asyouwish.co.in",
                    "domain": "asyouwish.co.in",
                    "myshopify_domain": "3fc80a-ab.myshopify.com",
                    "currency": "INR",
                    "category_tags": [],
                    "ads_platforms": []
                },
                "user_collected": 0,
                "monthly_revenue_usd": 0
            },
            {
                "id": 7660239552556,
                "shop_id": 63175819308,
                "images": [
                    "https://cdn.shopify.com/s/files/1/0631/7581/9308/files/PhotofromDee_28.jpg?v=1720024435",
                    "https://cdn.shopify.com/s/files/1/0631/7581/9308/files/IMG-20230124-WA0028_2.jpg?v=1720024435"
                ],
                "title": "Agate Photo Frame",
                "price": 3500,
                "created_at": 1720024521,
                "updated_at": 1752949914,
                "handle": "agate-photo-frame",
                "category_id": "62739bd238365b2f72048ed0",
                "monthly_sale": null,
                "monthly_revenue": null,
                "price_usd": 40.62,
                "category": {
                    "id": "62739bd238365b2f72048ed0",
                    "name_en": "Jewelry & Accessories",
                    "name_zh": "珠宝首饰及配饰"
                },
                "shop": {
                    "id": 63175819308,
                    "name": "Asyouwish",
                    "url": "https://asyouwish.co.in",
                    "domain": "asyouwish.co.in",
                    "myshopify_domain": "3fc80a-ab.myshopify.com",
                    "currency": "INR",
                    "category_tags": [],
                    "ads_platforms": []
                },
                "user_collected": 0,
                "monthly_revenue_usd": 0
            }
        ],
        "last_page": 297513503,
        "current_page": 1,
        "total": 595027005,
        "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
»»» handle	string	true	none	产品handle	none
»»» shop_id	integer	true	none	店铺ID	none
»»» images	[string]	true	none	产品图片列表	none
»»» title	string	true	none	产品标题	none
»»» price	number	true	none	价格	none
»»» created_at	integer	true	none	创建时间	none
»»» updated_at	integer	true	none	最新出单时间	none
»»» shop	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
»»»» myshopify_domain	string	true	none	Shopify店铺域名	none
»»»» currency	string	true	none	店铺货币	none
»»»» ads_platforms	[string]	true	none	广告像素平台	none
»»»» category_tags	[integer]¦null	true	none	商品类型	none
»»» user_collected	integer	true	none	是否已收藏	0-未收藏，2-已收藏
»»» category	object	true	none	分类	none
»»»» id	string	true	none	分类ID	none
»»»» name_en	string	true	none	分类的英文名称	none
»»»» name_zh	string	true	none	分类的中文名称	none
»»» monthly_sale	integer¦null	true	none	月销量	none
»»» monthly_revenue	number¦null	true	none	月收入	none
»»» price_usd	number¦null	true	none	价格（美元）	none
»»» monthly_revenue_usd	number¦null	true	none	月收入（美元）	none
»»» url	string	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

接口信息

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