接口参考

监控任务的广告文案（最长运营） API

POST/open-api/v1/ad-monitor-task/ad-copy-longest-run

免费·api.ppspy.com

数据与监控消耗规则

数据消耗规则：1. 获取一条shopify数据结果消耗 1 数据或者获取一条广告库数据结果消耗 2 数据，获取数据结果的更多数据详情不消耗数据。 2. 广告监控 & 销量监控，每次监控 $1 / 月。单个监控有效期为一个月，一个月后自动停止。删除监控不会恢复监控次数，请谨慎删除。监控调用为随时且无限次。

请求头

AUTHORIZATIONAuthorization: {API Key}

CONTENT-TYPEapplication/json

ACCEPTapplication/json

请求示例

cURL

curl --location --request POST 'https://api.ppspy.com/open-api/v1/ad-monitor-task/ad-copy-longest-run' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}' \
--data-raw '{
    "task_id": "902175d02614903e4944dfdfe85bbb4d",
    "order_by": "active_days",
    "direction": "desc",
    "page": 1,
    "per_page": 10
}'

请求参数 8 项

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

参数	类型	说明
body body · 可选	object	\| none
» task_id body · 必填	string	监控任务ID \| none
» advertiser_id body · 可选	string	广告主ID \| none
» related_store_id body · 可选	string	店铺ID \| none
» order_by body · 可选	string	排序字段 \| 可选值：active_days-投放天数，ad_started_at-广告开始日期。
» direction body · 可选	string	排序方式 \| 可选值：desc-降序，asc-升序。
» page body · 可选	integer	页码 \| 最小值等于1。
» per_page body · 可选	integer	分页大小 \| 取值范围1-100。

返回示例

返回示例 · JSON

{
    "code": 200,
    "message": "success",
    "data": {
        "current_page": 1,
        "data": [
            {
                "ad_id": "690790813314649",
                "media_format": 1,
                "images": null,
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/ca4036d3719ad12ff6b2520f6d584c0b.png",
                        "url": "https:\/\/cdn.pipidata.com\/videos\/db4c201c62aa3f6ce493fe65b13a9a18.mp4"
                    }
                ],
                "cards": null,
                "ad_content": "🙌 Embrace a world of choice, comfort, and stunning style for sizes 10-30. Shop now and express yourself like never before.💃",
                "active_days": 203,
                "ad_status": 1,
                "ad_started_at": 1743577200
            },
            {
                "ad_id": "1359998978580431",
                "media_format": 1,
                "images": null,
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/fcab53598cfeb9b21d23fa955499ca46.png",
                        "url": "https:\/\/cdn.pipidata.com\/videos\/cb879bc2d6c0194b7d13cd44b413fe01.mp4"
                    }
                ],
                "cards": null,
                "ad_content": "🏖️ From size 10 to 30, every body deserves to shine! Our inclusive range of plus-size swimwear offers unbeatable prices without compromising on style or fit. Don't settle for less, dive into affordable luxury today!",
                "active_days": 193,
                "ad_status": 3,
                "ad_started_at": 1744268400
            },
            {
                "ad_id": "1170464520973657",
                "media_format": 1,
                "images": null,
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/3b6cb641180776ccaf8e8fdb0fdc002d.png",
                        "url": "https:\/\/cdn.pipidata.com\/videos\/b4a0ade7eec7979ffd7a1deb65cc5b2a.mp4"
                    }
                ],
                "cards": null,
                "ad_content": "🏖️ From size 10 to 30, every body deserves to shine! Our inclusive range of plus-size swimwear offers unbeatable prices without compromising on style or fit. Don't settle for less, dive into affordable luxury today!",
                "active_days": 193,
                "ad_status": 3,
                "ad_started_at": 1744268400
            },
            {
                "ad_id": "1139941097886071",
                "media_format": 1,
                "images": null,
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/7245c7a14294400880f85d26b19c8618.png",
                        "url": "https:\/\/cdn.pipidata.com\/videos\/55c4b667bd876f12f51759fd775dd26a.mp4"
                    }
                ],
                "cards": null,
                "ad_content": "🏖️ From size 10 to 30, every body deserves to shine! Our inclusive range of plus-size swimwear offers unbeatable prices without compromising on style or fit. Don't settle for less, dive into affordable luxury today!",
                "active_days": 193,
                "ad_status": 3,
                "ad_started_at": 1744268400
            },
            {
                "ad_id": "984602047119089",
                "media_format": 1,
                "images": null,
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/f647a4ffb7572835dbf839b04c5239b3.png",
                        "url": "https:\/\/cdn.pipidata.com\/videos\/92a4277a84a1a47a8e55390aee0c4c41.mp4"
                    }
                ],
                "cards": null,
                "ad_content": "🙌 Embrace a world of choice, comfort, and stunning style for sizes 10-30. Shop now and express yourself like never before.💃",
                "active_days": 192,
                "ad_status": 3,
                "ad_started_at": 1744268400
            },
            {
                "ad_id": "3809882962598700",
                "media_format": 1,
                "images": null,
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/5b86e11a70f7e1245379fc87c9081b03.png",
                        "url": "https:\/\/cdn.pipidata.com\/videos\/54e3f1059af27a48e43c578a7fb9ce1b.mp4"
                    }
                ],
                "cards": null,
                "ad_content": "Dive into style with BloomChic's swimwear! 🌊 Designed for sizes 10-30, our collection offers unparalled comfort and elegance. Feel confident and beautiful this summer 👙",
                "active_days": 192,
                "ad_status": 3,
                "ad_started_at": 1744268400
            },
            {
                "ad_id": "2400280980339121",
                "media_format": 1,
                "images": null,
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/0e357a9243a7529c2e17f5bf80568538.png",
                        "url": "https:\/\/cdn.pipidata.com\/videos\/dcebaa93c6a0e8aece146ccff7bde885.mp4"
                    }
                ],
                "cards": null,
                "ad_content": "Get ready to be amazed! Our latest arrivals at BloomChic are flying off the shelves. Don't wait too long – grab them before they're gone!",
                "active_days": 192,
                "ad_status": 3,
                "ad_started_at": 1744268400
            },
            {
                "ad_id": "1430163374615759",
                "media_format": 1,
                "images": null,
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/a4a5f9aeb01d5d533343aa20180607a6.png",
                        "url": "https:\/\/cdn.pipidata.com\/videos\/98cc09a03eb6eaa4d99e946c9bfb60d5.mp4"
                    }
                ],
                "cards": null,
                "ad_content": "🏖️ Dive in and redefine your beach days with a fashion-forward splash! Time to shop, strut, and shine! 👙🌈🌞",
                "active_days": 192,
                "ad_status": 3,
                "ad_started_at": 1744268400
            },
            {
                "ad_id": "1321573755618157",
                "media_format": 1,
                "images": null,
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/5473f256f86af7dba4460968dfbfc17e.png",
                        "url": "https:\/\/cdn.pipidata.com\/videos\/fd32d5fda75d447700c3e7d359286e3e.mp4"
                    }
                ],
                "cards": null,
                "ad_content": "🏖️ From size 10 to 30, every body deserves to shine! Our inclusive range of plus-size swimwear offers unbeatable prices without compromising on style or fit. Don't settle for less, dive into affordable luxury today!",
                "active_days": 192,
                "ad_status": 3,
                "ad_started_at": 1744268400
            },
            {
                "ad_id": "1310855453309641",
                "media_format": 1,
                "images": null,
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/08b203190118e730f62d8ea7e7094767.png",
                        "url": "https:\/\/cdn.pipidata.com\/videos\/f7745adceedac57f89397d53301cddda.mp4"
                    }
                ],
                "cards": null,
                "ad_content": "🙌 Embrace a world of choice, comfort, and stunning style for sizes 10-30. Shop now and express yourself like never before.💃",
                "active_days": 192,
                "ad_status": 3,
                "ad_started_at": 1744268400
            }
        ],
        "last_page": 5123,
        "per_page": 10,
        "total": 51225
    },
    "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
»» current_page	integer	true	none	当前页码	none
»» data	[object]	true	none	数据列表	none
»»» ad_id	string	true	none	广告ID	none
»»» media_format	integer	true	none	媒体格式	可选值：1-视频，2-图片，3-轮播图。
»»» images	[object]¦null	true	none	图片	none
»»»» height	integer	false	none	图片的高度	none
»»»» url	string	false	none	图片的链接	none
»»»» width	integer	false	none	图片的宽度	none
»»» videos	[object]¦null	true	none	视频	none
»»»» cover_url	string¦null	false	none	视频的封面图链接	none
»»»» duration	integer¦null	false	none	视频的时长	none
»»»» height	integer	false	none	视频的高度	none
»»»» url	string	false	none	视频的链接	none
»»»» width	integer	false	none	视频的宽度	none
»»» cards	[object]¦null	true	none	轮播	none
»»»» cover_url	string¦null	false	none	视频的封面图链接	none
»»»» duration	integer¦null	false	none	视频的时长	none
»»»» height	integer	false	none	视频/图片的高度	none
»»»» media_type	integer	false	none	媒体类型	可选值：1-视频，2-图片。
»»»» url	string	false	none	视频/图片的链接	none
»»»» width	integer	false	none	视频/图片的宽度	none
»»» ad_content	string	true	none	文案内容	none
»»» active_days	integer	true	none	投放天数	none
»»» ad_status	integer	true	none	广告状态	可选值：1-投放中，2-已停止，3-已下架。
»»» ad_started_at	integer	true	none	广告开始日期	时间戳：秒。
»» last_page	integer	true	none	最后一页的页码	none
»» per_page	integer	true	none	分页大小	none
»» total	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

接口信息

接口名称: 监控任务的广告文案（最长运营）
请求方法: POST
接口地址: /open-api/v1/ad-monitor-task/ad-copy-longest-run
价格说明: 免费