接口参考

监控任务列表 API

POST/open-api/v1/ad-monitor-task/list

免费·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/list' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}' \
--data-raw '{
    "page": 1,
    "per_page": 10
}'

请求参数 9 项

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

参数	类型	说明
body body · 可选	object	\| none
» keyword body · 可选	string	搜索关键词 \| none
» monitor_task_type body · 可选	integer	监控任务类型 \| 可选值：1-Facebook广告主，2-店铺/网站。
» country body · 可选	string	国家 \| none
» order_by body · 可选	string	排序字段 \| 可选值：started_at-开始监控时间，ad_total_count-总广告数，ad_total_active_count-总活跃广告数，ad_today_count-今日新增广告数，ad_yesterday_count-昨日新增广告数，landing_page_total_count-落地页总数，landing_page_today_count-落地页今日新增，landing_page_yesterday_count-落地页昨日新增，product_total_count-总产品数，product_today_count-产品今日新增，product_yesterday_count-产品昨日新增。
» direction body · 可选	string	排序方式 \| 可选值：desc-降序，asc-升序。
» page body · 可选	integer	页码 \| 最小值等于1。
» per_page body · 可选	integer	分页大小 \| 取值范围1-100。
» group_id body · 可选	string	分组ID \| none

返回示例

返回示例 · JSON

{
    "code": 200,
    "message": "success",
    "data": {
        "current_page": 1,
        "data": [
            {
                "task_id": "902175d02614903e4944dfdfe85bbb4d",
                "updated_at": 1761229088,
                "monitor_task_type": 1,
                "facebook_page_id": "100726615757315",
                "facebook_page_url": null,
                "facebook_shop_url": null,
                "facebook_shop_search_url": null,
                "name": "Coloringbook",
                "avatar_url": "https://scontent-nrt1-2.xx.fbcdn.net/v/t39.30808-1/250115514_100726659090644_7405549375147557340_n.png?stp=dst-png_s100x100&_nc_cat=101&ccb=1-7&_nc_sid=418b77&_nc_ohc=oR82bdd8LsEQ7kNvwFR9css&_nc_oc=AdnOlwugd-a_Yt-WSY-rJGMEasY4EGYZ8Exjb64rrr672pxh0Voz_F8o46bTAjEKo0M&_nc_zt=24&_nc_ht=scontent-nrt1-2.xx&_nc_gid=4fHEZoJRgLMnM34BI30F8w&oh=00_AfcOORyQ7zhijv2OZ5YnwEslo6BS2i0Nb6SCZp7TjzhhcA&oe=690014F0",
                "category": "Brand",
                "country": null,
                "ad_total_count": 0,
                "ad_total_active_count": 0,
                "ad_today_count": 0,
                "ad_yesterday_count": 0,
                "ad_seven_day_count": 0,
                "landing_page_total_count": 0,
                "landing_page_today_count": 0,
                "landing_page_yesterday_count": 0,
                "landing_page_seven_day_count": 0,
                "product_total_count": 0,
                "product_today_count": 0,
                "product_yesterday_count": 0,
                "product_seven_day_count": 0,
                "videos_ad_total_count": 0,
                "images_ad_total_count": 0,
                "cards_ad_total_count": 0,
                "latest_ad_data": null,
                "started_at": 1761229088,
                "group": {
                    "id": "d7fffb6c5166af6c285438ecf5202a87",
                    "name": "Popular"
                },
                "status": 1,
                "stoped_at": null,
                "expected_stoped_at": null,
                "group_id": "d7fffb6c5166af6c285438ecf5202a87"
            },
            {
                "task_id": "dc7ed8902c66fc5e1dfbe4ccad5c345b",
                "updated_at": 1752228309,
                "monitor_task_type": 1,
                "facebook_page_id": "100171795648072",
                "facebook_page_url": null,
                "facebook_shop_url": null,
                "facebook_shop_search_url": null,
                "name": "Drivseljawbvic",
                "avatar_url": "https://scontent.fhkg3-2.fna.fbcdn.net/v/t39.30808-1/306912264_172867825315290_6755609888012128163_n.png?stp=dst-png_s100x100&_nc_cat=111&ccb=1-7&_nc_sid=418b77&_nc_ohc=j6ltyg5Z8aEQ7kNvwEQ0Y-7&_nc_oc=AdkiFF0NURfFUSN4TmYrfO7OTUWoqbF1GOAEMn20mBqKHaLjQOQrFeVhWDijdw2Z8gE&_nc_zt=24&_nc_ht=scontent.fhkg3-2.fna&_nc_gid=qvmEW3KzY7mwh00zXsX2jA&oh=00_AfTYB5MD5CeDIrnGhb34ynmhsPO9ySgdFRnW4f2pZegAZw&oe=6876BE76",
                "category": "Website",
                "country": null,
                "ad_total_count": 0,
                "ad_total_active_count": 0,
                "ad_today_count": 0,
                "ad_yesterday_count": 0,
                "ad_seven_day_count": 0,
                "landing_page_total_count": 0,
                "landing_page_today_count": 0,
                "landing_page_yesterday_count": 0,
                "landing_page_seven_day_count": 0,
                "product_total_count": 0,
                "product_today_count": 0,
                "product_yesterday_count": 0,
                "product_seven_day_count": 0,
                "videos_ad_total_count": 0,
                "images_ad_total_count": 0,
                "cards_ad_total_count": 0,
                "latest_ad_data": null,
                "started_at": 1761206706,
                "group": null,
                "status": 1,
                "stoped_at": null,
                "expected_stoped_at": null,
                "group_id": null
            },
            {
                "task_id": "dbff999b121eecfad463c774b62411cb",
                "updated_at": 1752228333,
                "monitor_task_type": 1,
                "facebook_page_id": "100162026063843",
                "facebook_page_url": null,
                "facebook_shop_url": null,
                "facebook_shop_search_url": null,
                "name": "Digital Empires",
                "avatar_url": "https://scontent.fhkg3-1.fna.fbcdn.net/v/t39.30808-1/285700885_100165089396870_5023354579253836414_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=100&ccb=1-7&_nc_sid=418b77&_nc_ohc=UPBggd0uZOcQ7kNvwHSOgQb&_nc_oc=AdlWB06bQQC1_o4c2TkwB5Yn6tQikSwVuQEeCz_EDiFWh9FPVrJKWwa8g3XtJQ2wB7k&_nc_zt=24&_nc_ht=scontent.fhkg3-1.fna&_nc_gid=fsIB0bc18WV2nZoNh0Kktg&oh=00_AfRY_ewBJ-o3e78E-YvoRoWHg86FHTPrggbQy533E7YxGw&oe=6876A94A",
                "category": "Professional networking",
                "country": null,
                "ad_total_count": 0,
                "ad_total_active_count": 0,
                "ad_today_count": 0,
                "ad_yesterday_count": 0,
                "ad_seven_day_count": 0,
                "landing_page_total_count": 0,
                "landing_page_today_count": 0,
                "landing_page_yesterday_count": 0,
                "landing_page_seven_day_count": 0,
                "product_total_count": 0,
                "product_today_count": 0,
                "product_yesterday_count": 0,
                "product_seven_day_count": 0,
                "videos_ad_total_count": 0,
                "images_ad_total_count": 0,
                "cards_ad_total_count": 0,
                "latest_ad_data": null,
                "started_at": 1761206551,
                "group": null,
                "status": 1,
                "stoped_at": null,
                "expected_stoped_at": null,
                "group_id": null
            },
            {
                "task_id": "79b81677cc7a2e628e7978c22e329d5f",
                "updated_at": 1755063602,
                "monitor_task_type": 1,
                "facebook_page_id": "100172286143867",
                "facebook_page_url": null,
                "facebook_shop_url": null,
                "facebook_shop_search_url": null,
                "name": "Nordstore11",
                "avatar_url": "https://cdn.pipidata.com/images/0d8431940a87f31120e0acfa07b06993b8ab9c92e6d4c8a40f469a8754231b64.png",
                "category": "Charity or second-hand shop",
                "country": null,
                "ad_total_count": 136,
                "ad_total_active_count": 136,
                "ad_today_count": 0,
                "ad_yesterday_count": 0,
                "ad_seven_day_count": 16,
                "landing_page_total_count": 16,
                "landing_page_today_count": 0,
                "landing_page_yesterday_count": 0,
                "landing_page_seven_day_count": 2,
                "product_total_count": 0,
                "product_today_count": 0,
                "product_yesterday_count": 0,
                "product_seven_day_count": 0,
                "videos_ad_total_count": 3,
                "images_ad_total_count": 0,
                "cards_ad_total_count": 133,
                "latest_ad_data": [
                    {
                        "id": "1312420270521735",
                        "type": 3,
                        "cover_url": "https://cdn.pipidata.com/images/18616d96c8fb6826c234b599ecdeed9530b3815c9f72d9c8946f2a4994eb15d5.png",
                        "video_url": "https://cdn.pipidata.com/videos/1d83fe7c7fa481e0c0123f53cf3d9a4f6b233cde358e37669360cd4a73cd81a0.mp4",
                        "ad_started_at": 1754809200,
                        "duration": 20,
                        "cards": [
                            {
                                "url": "https://cdn.pipidata.com/videos/1d83fe7c7fa481e0c0123f53cf3d9a4f6b233cde358e37669360cd4a73cd81a0.mp4",
                                "cover_url": "https://cdn.pipidata.com/images/18616d96c8fb6826c234b599ecdeed9530b3815c9f72d9c8946f2a4994eb15d5.png",
                                "type": 1,
                                "width": 720,
                                "height": 1280,
                                "duration": 20
                            },
                            {
                                "url": "https://cdn.pipidata.com/videos/1d83fe7c7fa481e0c0123f53cf3d9a4f6b233cde358e37669360cd4a73cd81a0.mp4",
                                "cover_url": "https://cdn.pipidata.com/images/18616d96c8fb6826c234b599ecdeed9530b3815c9f72d9c8946f2a4994eb15d5.png",
                                "type": 1,
                                "width": 720,
                                "height": 1280,
                                "duration": 20
                            },
                            {
                                "url": "https://cdn.pipidata.com/videos/c8c797aeae649de37b01a82464550dbcb51dd34239ce2e68344adbaed2278d5b.mp4",
                                "cover_url": "https://cdn.pipidata.com/images/b693cc8671c6fd359f6347ec21d2fd5eab5931c1c883281866f25bc9ccd8c625.png",
                                "type": 1,
                                "width": 720,
                                "height": 720,
                                "duration": 20
                            },
                            {
                                "url": "https://cdn.pipidata.com/videos/1d83fe7c7fa481e0c0123f53cf3d9a4f6b233cde358e37669360cd4a73cd81a0.mp4",
                                "cover_url": "https://cdn.pipidata.com/images/18616d96c8fb6826c234b599ecdeed9530b3815c9f72d9c8946f2a4994eb15d5.png",
                                "type": 1,
                                "width": 720,
                                "height": 1280,
                                "duration": 20
                            },
                            {
                                "url": "https://cdn.pipidata.com/videos/c2a1ed8828e8318d1b75874eb6178a95da41ff7fd706b3239c3790e24e402d4a.mp4",
                                "cover_url": "https://cdn.pipidata.com/images/7a50394e29e9ecfea2197fb6db6ab8ae08dfe874a1b215885dd63f33c06bd94a.png",
                                "type": 1,
                                "width": 720,
                                "height": 720,
                                "duration": 28
                            }
                        ]
                    },
                    {
                        "id": "1286817879641438",
                        "type": 3,
                        "cover_url": "https://cdn.pipidata.com/images/a1e079caacd85dce28e92fdf8b86544c649530dbd84396139c3e44785ace8451.png",
                        "video_url": "https://cdn.pipidata.com/videos/531f6bb8a9069f5618678cbf52d0e7f73fec2f16bf495067668bdbe9ddabc2e1.mp4",
                        "ad_started_at": 1754722800,
                        "duration": 26,
                        "cards": [
                            {
                                "url": "https://cdn.pipidata.com/videos/531f6bb8a9069f5618678cbf52d0e7f73fec2f16bf495067668bdbe9ddabc2e1.mp4",
                                "cover_url": "https://cdn.pipidata.com/images/a1e079caacd85dce28e92fdf8b86544c649530dbd84396139c3e44785ace8451.png",
                                "type": 1,
                                "width": 720,
                                "height": 1280,
                                "duration": 26
                            },
                            {
                                "url": "https://cdn.pipidata.com/videos/cdca46436bbea23d20b5097a4efdf380fb53a314c928a6e11746a0efb075239c.mp4",
                                "cover_url": "https://cdn.pipidata.com/images/f653a06cf66ff010a807750dc85d5b3e37729c8b343095091a75107114e47b19.png",
                                "type": 1,
                                "width": 720,
                                "height": 720,
                                "duration": 26
                            },
                            {
                                "url": "https://cdn.pipidata.com/videos/531f6bb8a9069f5618678cbf52d0e7f73fec2f16bf495067668bdbe9ddabc2e1.mp4",
                                "cover_url": "https://cdn.pipidata.com/images/a1e079caacd85dce28e92fdf8b86544c649530dbd84396139c3e44785ace8451.png",
                                "type": 1,
                                "width": 720,
                                "height": 1280,
                                "duration": 26
                            },
                            {
                                "url": "https://cdn.pipidata.com/videos/531f6bb8a9069f5618678cbf52d0e7f73fec2f16bf495067668bdbe9ddabc2e1.mp4",
                                "cover_url": "https://cdn.pipidata.com/images/a1e079caacd85dce28e92fdf8b86544c649530dbd84396139c3e44785ace8451.png",
                                "type": 1,
                                "width": 720,
                                "height": 1280,
                                "duration": 26
                            },
                            {
                                "url": "https://cdn.pipidata.com/videos/c2a1ed8828e8318d1b75874eb6178a95da41ff7fd706b3239c3790e24e402d4a.mp4",
                                "cover_url": "https://cdn.pipidata.com/images/7a50394e29e9ecfea2197fb6db6ab8ae08dfe874a1b215885dd63f33c06bd94a.png",
                                "type": 1,
                                "width": 720,
                                "height": 720,
                                "duration": 28
                            }
                        ]
                    },
                    {
                        "id": "1092924302406941",
                        "type": 3,
                        "cover_url": "https://cdn.pipidata.com/images/c073ce01682f9675d327773c1eb607b254c228b14a1db7d7c9ae2daecc1a32b3.png",
                        "video_url": "https://cdn.pipidata.com/videos/741497f7610a1e5615b56addc6012405afa3ee70c57e59ea7e5abe25b50bdc94.mp4",
                        "ad_started_at": 1754722800,
                        "duration": 35,
                        "cards": [
                            {
                                "url": "https://cdn.pipidata.com/videos/741497f7610a1e5615b56addc6012405afa3ee70c57e59ea7e5abe25b50bdc94.mp4",
                                "cover_url": "https://cdn.pipidata.com/images/c073ce01682f9675d327773c1eb607b254c228b14a1db7d7c9ae2daecc1a32b3.png",
                                "type": 1,
                                "width": 720,
                                "height": 1280,
                                "duration": 35
                            },
                            {
                                "url": "https://cdn.pipidata.com/videos/741497f7610a1e5615b56addc6012405afa3ee70c57e59ea7e5abe25b50bdc94.mp4",
                                "cover_url": "https://cdn.pipidata.com/images/c073ce01682f9675d327773c1eb607b254c228b14a1db7d7c9ae2daecc1a32b3.png",
                                "type": 1,
                                "width": 720,
                                "height": 1280,
                                "duration": 35
                            },
                            {
                                "url": "https://cdn.pipidata.com/videos/741497f7610a1e5615b56addc6012405afa3ee70c57e59ea7e5abe25b50bdc94.mp4",
                                "cover_url": "https://cdn.pipidata.com/images/c073ce01682f9675d327773c1eb607b254c228b14a1db7d7c9ae2daecc1a32b3.png",
                                "type": 1,
                                "width": 720,
                                "height": 1280,
                                "duration": 35
                            },
                            {
                                "url": "https://cdn.pipidata.com/videos/c5562c926a72166178e79e434af9b2ee5690dc098851d8d350cc64195dda62b2.mp4",
                                "cover_url": "https://cdn.pipidata.com/images/7da054c2dc933a362c21534cf3d204c99892f5ec2f335b8e03f1369be2c76ad5.png",
                                "type": 1,
                                "width": 720,
                                "height": 720,
                                "duration": 35
                            }
                        ]
                    }
                ],
                "started_at": 1752228298,
                "group": null,
                "status": 2,
                "stoped_at": 1755064501,
                "expected_stoped_at": 1755064320,
                "group_id": null
            },
            {
                "task_id": "4ab2e770342bd8deb033a5af8a25aa37",
                "updated_at": 1752228294,
                "monitor_task_type": 1,
                "facebook_page_id": "100173198660671",
                "facebook_page_url": null,
                "facebook_shop_url": null,
                "facebook_shop_search_url": null,
                "name": "Sindrella",
                "avatar_url": "https://scontent.fhkg3-1.fna.fbcdn.net/v/t39.30808-1/358691450_590084593276196_9086028703648647395_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=109&ccb=1-7&_nc_sid=418b77&_nc_ohc=uvRa02okqmwQ7kNvwF-gIMn&_nc_oc=Adnzy_iDiXxIh9hPzlBAF223mnFaFd78qDYTXWPxticDpDPTbQVbuLLvJ0u75qxK-Js&_nc_zt=24&_nc_ht=scontent.fhkg3-1.fna&_nc_gid=A_rFJ66U0QbMG6oStgOBBg&oh=00_AfROXawripZKrh7qUg4Fh5bBAcyO_3LGntOVseXqVPd5rg&oe=6876A4C4",
                "category": "Personal blog",
                "country": null,
                "ad_total_count": 0,
                "ad_total_active_count": 0,
                "ad_today_count": 0,
                "ad_yesterday_count": 0,
                "ad_seven_day_count": 0,
                "landing_page_total_count": 0,
                "landing_page_today_count": 0,
                "landing_page_yesterday_count": 0,
                "landing_page_seven_day_count": 0,
                "product_total_count": 0,
                "product_today_count": 0,
                "product_yesterday_count": 0,
                "product_seven_day_count": 0,
                "videos_ad_total_count": 0,
                "images_ad_total_count": 0,
                "cards_ad_total_count": 0,
                "latest_ad_data": null,
                "started_at": 1752228294,
                "group": null,
                "status": 2,
                "stoped_at": 1755064501,
                "expected_stoped_at": 1755064320,
                "group_id": null
            },
            {
                "task_id": "05b4b4d27e5bd81cffd67fe76d633bb5",
                "updated_at": 1755063602,
                "monitor_task_type": 1,
                "facebook_page_id": "100105571735840",
                "facebook_page_url": null,
                "facebook_shop_url": null,
                "facebook_shop_search_url": null,
                "name": "Tenmokus",
                "avatar_url": "https://cdn.pipidata.com/images/406ce8e8b836c6fd34b92c296b4159111748d640b19a64433fa0c9a370323f1c.png",
                "category": "Brand",
                "country": null,
                "ad_total_count": 2,
                "ad_total_active_count": 2,
                "ad_today_count": 0,
                "ad_yesterday_count": 0,
                "ad_seven_day_count": 0,
                "landing_page_total_count": 1,
                "landing_page_today_count": 0,
                "landing_page_yesterday_count": 0,
                "landing_page_seven_day_count": 0,
                "product_total_count": 1,
                "product_today_count": 0,
                "product_yesterday_count": 0,
                "product_seven_day_count": 0,
                "videos_ad_total_count": 1,
                "images_ad_total_count": 0,
                "cards_ad_total_count": 1,
                "latest_ad_data": [
                    {
                        "id": "1181314833828596",
                        "type": 1,
                        "cover_url": "https://cdn.pipidata.com/images/6b49e43132433fabe24de1293a5a4d7405e7e801c54f8da44e07b6a9238fae22.png",
                        "video_url": "https://cdn.pipidata.com/videos/1c1adf5b5e86dce586138494e40e10153c840c8c6ceca7d7dae6b3f2beb0cb4b.mp4",
                        "ad_started_at": 1754463600,
                        "duration": 41,
                        "cards": null
                    },
                    {
                        "id": "1456792355516909",
                        "type": 3,
                        "cover_url": "https://cdn.pipidata.com/images/c59ec09cc413f543b0cbda44bec7411cfddc614b395c58135f87ed351ed159e7.png",
                        "video_url": null,
                        "ad_started_at": 1754463600,
                        "duration": null,
                        "cards": [
                            {
                                "url": "https://cdn.pipidata.com/images/c59ec09cc413f543b0cbda44bec7411cfddc614b395c58135f87ed351ed159e7.png",
                                "cover_url": null,
                                "type": 2,
                                "width": 1080,
                                "height": 1080,
                                "duration": null
                            },
                            {
                                "url": "https://cdn.pipidata.com/images/5165adc797a61bb97dc843d01fb1ed33376a1d4c005009d4454c2220e95460a8.png",
                                "cover_url": null,
                                "type": 2,
                                "width": 1080,
                                "height": 1080,
                                "duration": null
                            },
                            {
                                "url": "https://cdn.pipidata.com/images/7de7ebdf111f09c86c8b5df1d9bb67aa81b7f5b2e8eccea83c05b22bf9819302.png",
                                "cover_url": null,
                                "type": 2,
                                "width": 1080,
                                "height": 1080,
                                "duration": null
                            },
                            {
                                "url": "https://cdn.pipidata.com/images/709214fb5135260f373741924af2081d85e0c5634064f9901d6c0422d2985e5a.png",
                                "cover_url": null,
                                "type": 2,
                                "width": 1080,
                                "height": 1080,
                                "duration": null
                            },
                            {
                                "url": "https://cdn.pipidata.com/images/759ec8b991e82ef4a29879b4695efa4855f46e0c647c48bdd31abf77d52d2354.png",
                                "cover_url": null,
                                "type": 2,
                                "width": 1080,
                                "height": 1080,
                                "duration": null
                            },
                            {
                                "url": "https://cdn.pipidata.com/images/2dfad0d966b00a721562e304f675efcc7002fd3a5443e47d1161154620021811.png",
                                "cover_url": null,
                                "type": 2,
                                "width": 1080,
                                "height": 1080,
                                "duration": null
                            }
                        ]
                    }
                ],
                "started_at": 1752228280,
                "group": null,
                "status": 2,
                "stoped_at": 1755064501,
                "expected_stoped_at": 1755064320,
                "group_id": null
            },
            {
                "task_id": "f52a7c73487887f8256f5401f964a8dc",
                "updated_at": 1752228269,
                "monitor_task_type": 1,
                "facebook_page_id": "100104419147228",
                "facebook_page_url": null,
                "facebook_shop_url": null,
                "facebook_shop_search_url": null,
                "name": "Do Good Chicken",
                "avatar_url": "https://scontent.fhkg3-1.fna.fbcdn.net/v/t39.30808-1/260707035_117860484038288_5540380162612794301_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=107&ccb=1-7&_nc_sid=418b77&_nc_ohc=Q_QPMVGVCSoQ7kNvwGbOOGc&_nc_oc=AdkZ9tktdMkJ24dSU3AZdGcdXVwkrzbUHH9YF8henKZosHRilNP12mXJAO0unXEG4FI&_nc_zt=24&_nc_ht=scontent.fhkg3-1.fna&_nc_gid=jMuB2riLwhxL3eWzuHvckQ&oh=00_AfSUhpPuXiOY5ulfHa11Hl0vflGHs6gr_ViYN_52QEQZbw&oe=6876A5B4",
                "category": "Food and drink",
                "country": null,
                "ad_total_count": 0,
                "ad_total_active_count": 0,
                "ad_today_count": 0,
                "ad_yesterday_count": 0,
                "ad_seven_day_count": 0,
                "landing_page_total_count": 0,
                "landing_page_today_count": 0,
                "landing_page_yesterday_count": 0,
                "landing_page_seven_day_count": 0,
                "product_total_count": 0,
                "product_today_count": 0,
                "product_yesterday_count": 0,
                "product_seven_day_count": 0,
                "videos_ad_total_count": 0,
                "images_ad_total_count": 0,
                "cards_ad_total_count": 0,
                "latest_ad_data": null,
                "started_at": 1752228269,
                "group": null,
                "status": 2,
                "stoped_at": 1755064501,
                "expected_stoped_at": 1755064320,
                "group_id": null
            },
            {
                "task_id": "d9134618f577976693d74d841f51b03d",
                "updated_at": 1752228264,
                "monitor_task_type": 1,
                "facebook_page_id": "100103418674041",
                "facebook_page_url": null,
                "facebook_shop_url": null,
                "facebook_shop_search_url": null,
                "name": "Hinge",
                "avatar_url": "https://scontent.fhkg3-2.fna.fbcdn.net/v/t39.30808-1/379398647_778952250906505_6213277376455737565_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=108&ccb=1-7&_nc_sid=418b77&_nc_ohc=E3okhVQCrigQ7kNvwG4DWXA&_nc_oc=AdlCjr0lqOLHnrWl3NifA61eRj-MTbstxY-omGn2G2pD5cP3rgM1ehiJcRrlWly4waY&_nc_zt=24&_nc_ht=scontent.fhkg3-2.fna&_nc_gid=yMl5fU2MU0YfPxar3UmjaA&oh=00_AfRhk_eWGz-kdY38mJlhYh0aohIILQYDI974FNLYSfK-Sg&oe=6876A547",
                "category": "Musician/band",
                "country": null,
                "ad_total_count": 0,
                "ad_total_active_count": 0,
                "ad_today_count": 0,
                "ad_yesterday_count": 0,
                "ad_seven_day_count": 0,
                "landing_page_total_count": 0,
                "landing_page_today_count": 0,
                "landing_page_yesterday_count": 0,
                "landing_page_seven_day_count": 0,
                "product_total_count": 0,
                "product_today_count": 0,
                "product_yesterday_count": 0,
                "product_seven_day_count": 0,
                "videos_ad_total_count": 0,
                "images_ad_total_count": 0,
                "cards_ad_total_count": 0,
                "latest_ad_data": null,
                "started_at": 1752228264,
                "group": null,
                "status": 2,
                "stoped_at": 1755064501,
                "expected_stoped_at": 1755064320,
                "group_id": null
            },
            {
                "task_id": "0395334efd41961c3b4bd9bd250d56ed",
                "updated_at": 1752228241,
                "monitor_task_type": 1,
                "facebook_page_id": "100102611580031",
                "facebook_page_url": null,
                "facebook_shop_url": null,
                "facebook_shop_search_url": null,
                "name": "Vavy",
                "avatar_url": "https://scontent.fhkg3-1.fna.fbcdn.net/v/t39.30808-1/294746387_424064979742195_6034614908095617282_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=107&ccb=1-7&_nc_sid=418b77&_nc_ohc=2uCaEtOOl70Q7kNvwEO_4rK&_nc_oc=AdndWPDQhznwIkG3Cu5vB-0Lm6pkMtXhroxVGZhT4Dqi5MNI9SN7tIm3o2XmfIAU58w&_nc_zt=24&_nc_ht=scontent.fhkg3-1.fna&_nc_gid=cLIbhpIF0ei7edUZcf_ffw&oh=00_AfRWA5flbQLlVNoII0J9c_tNEojctV_kW5axYBA1SlcAtg&oe=6876C7D7",
                "category": "Internet marketing service",
                "country": null,
                "ad_total_count": 0,
                "ad_total_active_count": 0,
                "ad_today_count": 0,
                "ad_yesterday_count": 0,
                "ad_seven_day_count": 0,
                "landing_page_total_count": 0,
                "landing_page_today_count": 0,
                "landing_page_yesterday_count": 0,
                "landing_page_seven_day_count": 0,
                "product_total_count": 0,
                "product_today_count": 0,
                "product_yesterday_count": 0,
                "product_seven_day_count": 0,
                "videos_ad_total_count": 0,
                "images_ad_total_count": 0,
                "cards_ad_total_count": 0,
                "latest_ad_data": null,
                "started_at": 1752228241,
                "group": null,
                "status": 2,
                "stoped_at": 1755064501,
                "expected_stoped_at": 1755064320,
                "group_id": null
            },
            {
                "task_id": "c0757d7f9b661b551205de2e58c6f5d2",
                "updated_at": 1752228222,
                "monitor_task_type": 1,
                "facebook_page_id": "100102326212825",
                "facebook_page_url": null,
                "facebook_shop_url": null,
                "facebook_shop_search_url": null,
                "name": "ELITE Jewels - Waterproof Luxury Jewelry",
                "avatar_url": "https://scontent.fhkg3-2.fna.fbcdn.net/v/t39.30808-1/307328550_100102452879479_5735057937022205435_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=106&ccb=1-7&_nc_sid=418b77&_nc_ohc=Gbw6lUB7VL0Q7kNvwEaBXus&_nc_oc=Adnau_Ru4r0D50674LVCSz9fK_tfUdXIPvxPdOABkQF6AkfBvTrjd5dgWQjUQ-yDiX4&_nc_zt=24&_nc_ht=scontent.fhkg3-2.fna&_nc_gid=Iw3qN2GwoBMTD_nq9A6UWw&oh=00_AfQJKDy20xv3GpqhFNkX_aFWNRRlSBJDqz9XRJJB0FtdjQ&oe=6876CBC4",
                "category": "Entrepreneur",
                "country": null,
                "ad_total_count": 0,
                "ad_total_active_count": 0,
                "ad_today_count": 0,
                "ad_yesterday_count": 0,
                "ad_seven_day_count": 0,
                "landing_page_total_count": 0,
                "landing_page_today_count": 0,
                "landing_page_yesterday_count": 0,
                "landing_page_seven_day_count": 0,
                "product_total_count": 0,
                "product_today_count": 0,
                "product_yesterday_count": 0,
                "product_seven_day_count": 0,
                "videos_ad_total_count": 0,
                "images_ad_total_count": 0,
                "cards_ad_total_count": 0,
                "latest_ad_data": null,
                "started_at": 1752228222,
                "group": null,
                "status": 2,
                "stoped_at": 1755064501,
                "expected_stoped_at": 1755064320,
                "group_id": null
            }
        ],
        "last_page": 2,
        "per_page": 10,
        "total": 15
    },
    "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	false	none	当前页码	none
»» data	[object]	false	none	数据列表	none
»»» facebook_page_id	string¦null	true	none	Facebook广告主ID	none
»»» facebook_shop_url	string¦null	true	none	店铺/网站的URL	none
»»» name	string¦null	true	none	监控对象名称	none
»»» avatar_url	string¦null	true	none	监控对象头像	none
»»» monitor_task_type	integer	true	none	监控任务类型	none
»»» category	string¦null	true	none	Facebook广告主的类别	none
»»» country	string¦null	true	none	国家	none
»»» ad_total_count	integer	true	none	总广告数	none
»»» ad_total_active_count	integer	true	none	总活跃	none
»»» ad_today_count	integer	true	none	今日新增广告数	none
»»» ad_yesterday_count	integer	true	none	昨日新增广告数	none
»»» landing_page_total_count	integer	true	none	落地页总数	none
»»» landing_page_today_count	integer	true	none	落地页今日新增	none
»»» landing_page_yesterday_count	integer	true	none	落地页昨日新增	none
»»» product_total_count	integer	true	none	总产品数	none
»»» product_today_count	integer	true	none	产品今日新增	none
»»» product_yesterday_count	integer	true	none	产品昨日新增	none
»»» latest_ad_data	[object]¦null	true	none	最新广告数据	none
»»»» id	string	true	none	广告ID	none
»»»» cover_url	string	true	none	封面	none
»»»» ad_started_at	integer	true	none	发布时间	时间戳：秒。
»»» task_id	string	true	none	监控任务ID	none
»»» started_at	integer	true	none	开始监控时间	时间戳：秒。
»»» group_id	string¦null	true	none	分组ID	none
»»» group	object¦null	true	none		none
»»»» id	string	true	none	分组ID	none
»»»» name	string	true	none	分组名称	none
»»» status	integer	true	none	任务状态	可选值：1-监控中，2-已停止。
»»» stoped_at	integer¦null	true	none	停止时间	时间戳：秒。
»»» expected_stoped_at	integer	true	none	计划停止时间	时间戳：秒。
»» last_page	integer	false	none	最后一页的页码	none
»» per_page	integer	false	none	分页大小	none
»» total	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

接口信息

接口名称: 监控任务列表
请求方法: POST
接口地址: /open-api/v1/ad-monitor-task/list
价格说明: 免费