接口参考

监控任务的广告列表 API

POST/open-api/v1/ad-monitor-task/ad-library-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/ad-library-list' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}' \
--data-raw '{
    "task_id": "902175d02614903e4944dfdfe85bbb4d",
    "order_by": "ad_started_at",
    "direction": "desc",
    "page": 1,
    "per_page": 8
}'

请求参数 33 项

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

参数	类型	说明
body body · 可选	object	\| none
» task_id body · 必填	string	监控任务ID \| none
» ad_content body · 可选	string	广告文案 \| none
» ad_audience_reach_start body · 可选	integer	覆盖人数（起） \| none
» ad_audience_reach_end body · 可选	integer	覆盖人数（止） \| none
» ad_cost_start body · 可选	number	广告花费（起） \| 货币单位：美元
» ad_cost_end body · 可选	number	广告花费（止） \| 货币单位：美元
» adset_count_start body · 可选	integer	广告组数（起） \| none
» adset_count_end body · 可选	integer	广告组数（止） \| none
» ad_forecast_list body · 可选	[integer]	广告预测 \| 可选值：1-测品阶段，2-上升阶段，3-盈利阶段。
» media_format_list body · 可选	[integer]	媒体格式 \| 可选值：1-视频， 2-图片， 3-轮播图。
» video_duration_start body · 可选	integer	视频时长（起） \| none
» video_duration_end body · 可选	integer	视频时长（止） \| none
» ad_started_at_start body · 可选	integer	广告创建时间（起） \| 时间戳：秒。
» ad_started_at_end body · 可选	integer	广告创建时间（止） \| 时间戳：秒。
» latest_actived_at_start body · 可选	integer	广告最后时间（起） \| 时间戳：秒。
» latest_actived_at_end body · 可选	integer	广告最后时间（止） \| 时间戳：秒。
» active_days_start body · 可选	integer	广告时长（起） \| none
» active_days_end body · 可选	integer	广告时长（止） \| none
» button_text_list body · 可选	[string]	广告按钮的文案 \| none
» ad_status_list body · 可选	[integer]	广告状态 \| 可选值：1-投放中，2-已停止，3-已下架。
» related_product_id_list body · 可选	[string]	产品 ID \| none
» product_price_usd_start body · 可选	number	产品价格（起） \| 货币单位：美元
» product_price_usd_end body · 可选	number	产品价格（止） \| 货币单位：美元
» product_creation_time_start body · 可选	integer	产品创建时间（起 \| 时间戳：秒。
» product_creation_time_end body · 可选	integer	产品创建时间（止） \| 时间戳：秒。
» order_by body · 可选	string	排序字段 \| 可选值：ad_started_at-广告开始时间，ad_ended_at-广告结束时间，active_days-投放天数，ad_cost-广告花费，ad_audience_reach-覆盖人数。
» direction body · 可选	string	排序方式 \| 可选值：desc-降序，asc-升序。
» page body · 可选	integer	页码 \| none
» per_page body · 可选	integer	分页大小 \| none
» keyword body · 可选	string	搜索关键词 \| none
» landing_page body · 可选	string	落地页URL \| none
» ad_platform_list body · 必填	[string]	广告平台 \| 可选值：FACEBOOK，INSTAGRAM，AUDIENCE_NETWORK，MESSENGER，THREADS。

返回示例

返回示例 · JSON

{
    "code": 200,
    "message": "success",
    "data": {
        "current_page": 1,
        "data": [
            {
                "id": "881591547735275",
                "active_days": 1,
                "ad_audience": null,
                "ad_audience_reach": null,
                "ad_link": "https:\/\/www.facebook.com\/ads\/library\/?id=881591547735275",
                "ad_content": "Workwear just got a whole lot cuter, and EASIER 👏🏻 \n\nComment WANT for the link! \n\n#MidsizeStyle #MidsizeFashion #MidsizeOutfit #MidsizeWorkwear #WorkwearStyle #WorkwearFashion #OfficeOOTD #ChicAndComfy #OOTDInspo #StyleForAll #EverydayStyle #WorkwearLooks #MidsizeConfidence #RealisticStyle #BodyPositiveFashion #OfficeChic #MidsizeBabe #WearToWork #AffordableStyle #WorkwearWardrobe #bloomchic #bloomchicfashion",
                "ad_cost": null,
                "impression": null,
                "ad_cost_min": null,
                "ad_cost_max": null,
                "estimated_conversion_min": null,
                "estimated_conversion_max": null,
                "ad_forecast": 1,
                "ad_platform": [
                    "FACEBOOK",
                    "INSTAGRAM",
                    "AUDIENCE_NETWORK",
                    "MESSENGER",
                    "THREADS"
                ],
                "ad_started_at": 1761289200,
                "ad_ended_at": 1761289200,
                "ad_status": 1,
                "adset_count": 1,
                "advertiser": {
                    "id": "100842618611379",
                    "ad_count": 42579,
                    "ad_country": [],
                    "ads_library_link": "https:\/\/www.facebook.com\/ads\/library\/?active_status=active&ad_type=all&country=ALL&is_targeted_country=false&media_type=all&search_type=page&view_all_page_id=100842618611379",
                    "adset_count": null,
                    "like_count": 579749,
                    "name": "BloomChic",
                    "profile_picture_url": "https:\/\/cdn.pipidata.com\/images\/5b7079c262046251bde8e30f7e22f504.png",
                    "source_advertiser_id": "100842618611379",
                    "source_advertiser_link": null,
                    "e_commerce_platform": null
                },
                "button_type": "SHOP_NOW",
                "cards": null,
                "country": null,
                "first_discovered_at": 1761314043,
                "images": null,
                "landing_page_type": 2,
                "landing_pages": [
                    "https:\/\/bloomchic.com\/collections\/bloom-dress?sort_by=geometric-print-waist-cinched-tiered-midi-dress"
                ],
                "language": null,
                "last_discovered_at": 1761314043,
                "latest_actived_at": 1761289200,
                "media_format": 1,
                "ad_caption": "bloomchic.com",
                "ad_title": null,
                "ad_link_description": null,
                "button_text": "Shop now",
                "products": null,
                "source_ad_id": null,
                "store": {
                    "id": "f65b3d7c58eb2b3fe1a54854ccfbadc9",
                    "ad_count": 51299,
                    "logo_url": "http:\/\/bloomchic.com\/cdn\/shop\/files\/20240102-144940_32x32.png?v=1704178240",
                    "name": "BloomChic",
                    "source_store_link": "https:\/\/bloomchic.com",
                    "e_commerce_platform": "shopify",
                    "e_commerce_types": null
                },
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/e330a7b0eb5c67ea9f7eb6645f31b758.png",
                        "duration": 45,
                        "height": 1280,
                        "url": "https:\/\/cdn.pipidata.com\/videos\/9bd5c12419cf03228dca988c0bf75822.mp4",
                        "width": 720
                    }
                ]
            },
            {
                "id": "870690415474321",
                "active_days": 1,
                "ad_audience": null,
                "ad_audience_reach": null,
                "ad_link": "https:\/\/www.facebook.com\/ads\/library\/?id=870690415474321",
                "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!",
                "ad_cost": null,
                "impression": null,
                "ad_cost_min": null,
                "ad_cost_max": null,
                "estimated_conversion_min": null,
                "estimated_conversion_max": null,
                "ad_forecast": 1,
                "ad_platform": [
                    "FACEBOOK",
                    "INSTAGRAM",
                    "AUDIENCE_NETWORK",
                    "MESSENGER",
                    "THREADS"
                ],
                "ad_started_at": 1761289200,
                "ad_ended_at": 1761289200,
                "ad_status": 1,
                "adset_count": 2,
                "advertiser": {
                    "id": "100842618611379",
                    "ad_count": 42579,
                    "ad_country": [],
                    "ads_library_link": "https:\/\/www.facebook.com\/ads\/library\/?active_status=active&ad_type=all&country=ALL&is_targeted_country=false&media_type=all&search_type=page&view_all_page_id=100842618611379",
                    "adset_count": null,
                    "like_count": 579749,
                    "name": "BloomChic",
                    "profile_picture_url": "https:\/\/cdn.pipidata.com\/images\/5b7079c262046251bde8e30f7e22f504.png",
                    "source_advertiser_id": "100842618611379",
                    "source_advertiser_link": null,
                    "e_commerce_platform": null
                },
                "button_type": "SHOP_NOW",
                "cards": null,
                "country": null,
                "first_discovered_at": 1761289938,
                "images": null,
                "landing_page_type": 2,
                "landing_pages": [
                    "https:\/\/bloomchic.com\/collections\/swim?sort_by=twist-front-patchwork-adjustable-straps-swim-dress"
                ],
                "language": null,
                "last_discovered_at": 1761289938,
                "latest_actived_at": 1761289200,
                "media_format": 1,
                "ad_caption": "bloomchic.com",
                "ad_title": "SIZES 10 TO 30",
                "ad_link_description": null,
                "button_text": "Shop now",
                "products": null,
                "source_ad_id": null,
                "store": {
                    "id": "f65b3d7c58eb2b3fe1a54854ccfbadc9",
                    "ad_count": 51299,
                    "logo_url": "http:\/\/bloomchic.com\/cdn\/shop\/files\/20240102-144940_32x32.png?v=1704178240",
                    "name": "BloomChic",
                    "source_store_link": "https:\/\/bloomchic.com",
                    "e_commerce_platform": "shopify",
                    "e_commerce_types": null
                },
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/c0b004574dc93c1da021351539de0767.png",
                        "duration": 19,
                        "height": 1280,
                        "url": "https:\/\/cdn.pipidata.com\/videos\/e16c991da80133054111c00eea8e3882.mp4",
                        "width": 720
                    }
                ]
            },
            {
                "id": "870647241954791",
                "active_days": 1,
                "ad_audience": null,
                "ad_audience_reach": null,
                "ad_link": "https:\/\/www.facebook.com\/ads\/library\/?id=870647241954791",
                "ad_content": "Sun, sand, and the perfect suit—this one’s got it all. With an adjustable back, wider shoulder straps for all-day ease, and tummy control that flatters in all the right places.",
                "ad_cost": null,
                "impression": null,
                "ad_cost_min": null,
                "ad_cost_max": null,
                "estimated_conversion_min": null,
                "estimated_conversion_max": null,
                "ad_forecast": 1,
                "ad_platform": [
                    "FACEBOOK",
                    "INSTAGRAM",
                    "AUDIENCE_NETWORK",
                    "MESSENGER",
                    "THREADS"
                ],
                "ad_started_at": 1761289200,
                "ad_ended_at": 1761289200,
                "ad_status": 1,
                "adset_count": 12,
                "advertiser": {
                    "id": "100842618611379",
                    "ad_count": 42579,
                    "ad_country": [],
                    "ads_library_link": "https:\/\/www.facebook.com\/ads\/library\/?active_status=active&ad_type=all&country=ALL&is_targeted_country=false&media_type=all&search_type=page&view_all_page_id=100842618611379",
                    "adset_count": null,
                    "like_count": 579749,
                    "name": "BloomChic",
                    "profile_picture_url": "https:\/\/cdn.pipidata.com\/images\/5b7079c262046251bde8e30f7e22f504.png",
                    "source_advertiser_id": "100842618611379",
                    "source_advertiser_link": null,
                    "e_commerce_platform": null
                },
                "button_type": "SHOP_NOW",
                "cards": null,
                "country": null,
                "first_discovered_at": 1761298420,
                "images": null,
                "landing_page_type": 2,
                "landing_pages": [
                    "https:\/\/bloomchic.com\/collections\/swim?sort_by=tropical-flower-print-pockets-one-piece-swimsuit"
                ],
                "language": null,
                "last_discovered_at": 1761298420,
                "latest_actived_at": 1761289200,
                "media_format": 1,
                "ad_caption": "bloomchic.com",
                "ad_title": "Perfect Suit for You",
                "ad_link_description": null,
                "button_text": "Shop now",
                "products": null,
                "source_ad_id": null,
                "store": {
                    "id": "f65b3d7c58eb2b3fe1a54854ccfbadc9",
                    "ad_count": 51299,
                    "logo_url": "http:\/\/bloomchic.com\/cdn\/shop\/files\/20240102-144940_32x32.png?v=1704178240",
                    "name": "BloomChic",
                    "source_store_link": "https:\/\/bloomchic.com",
                    "e_commerce_platform": "shopify",
                    "e_commerce_types": null
                },
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/7d98498297a2bb5ccf8dff665311362a.png",
                        "duration": 16,
                        "height": 1280,
                        "url": "https:\/\/cdn.pipidata.com\/videos\/056020ab79a41dc8028ace666039c154.mp4",
                        "width": 720
                    }
                ]
            },
            {
                "id": "870121528780695",
                "active_days": 1,
                "ad_audience": null,
                "ad_audience_reach": null,
                "ad_link": "https:\/\/www.facebook.com\/ads\/library\/?id=870121528780695",
                "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!",
                "ad_cost": null,
                "impression": null,
                "ad_cost_min": null,
                "ad_cost_max": null,
                "estimated_conversion_min": null,
                "estimated_conversion_max": null,
                "ad_forecast": 1,
                "ad_platform": [
                    "FACEBOOK",
                    "INSTAGRAM",
                    "AUDIENCE_NETWORK",
                    "MESSENGER",
                    "THREADS"
                ],
                "ad_started_at": 1761289200,
                "ad_ended_at": 1761289200,
                "ad_status": 1,
                "adset_count": 18,
                "advertiser": {
                    "id": "100842618611379",
                    "ad_count": 42579,
                    "ad_country": [],
                    "ads_library_link": "https:\/\/www.facebook.com\/ads\/library\/?active_status=active&ad_type=all&country=ALL&is_targeted_country=false&media_type=all&search_type=page&view_all_page_id=100842618611379",
                    "adset_count": null,
                    "like_count": 579749,
                    "name": "BloomChic",
                    "profile_picture_url": "https:\/\/cdn.pipidata.com\/images\/5b7079c262046251bde8e30f7e22f504.png",
                    "source_advertiser_id": "100842618611379",
                    "source_advertiser_link": null,
                    "e_commerce_platform": null
                },
                "button_type": "SHOP_NOW",
                "cards": null,
                "country": null,
                "first_discovered_at": 1761310633,
                "images": null,
                "landing_page_type": 2,
                "landing_pages": [
                    "https:\/\/bloomchic.com\/collections\/swim?sort_by=solid-keyhole-elastic-waist-gathered-one-piece-swimsuit"
                ],
                "language": null,
                "last_discovered_at": 1761310633,
                "latest_actived_at": 1761289200,
                "media_format": 1,
                "ad_caption": "bloomchic.com",
                "ad_title": "✨SIZES 10 TO 30✨",
                "ad_link_description": null,
                "button_text": "Shop now",
                "products": null,
                "source_ad_id": null,
                "store": {
                    "id": "f65b3d7c58eb2b3fe1a54854ccfbadc9",
                    "ad_count": 51299,
                    "logo_url": "http:\/\/bloomchic.com\/cdn\/shop\/files\/20240102-144940_32x32.png?v=1704178240",
                    "name": "BloomChic",
                    "source_store_link": "https:\/\/bloomchic.com",
                    "e_commerce_platform": "shopify",
                    "e_commerce_types": null
                },
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/7c729064e26018c00bf8a0541640c81a.png",
                        "duration": 23,
                        "height": 1280,
                        "url": "https:\/\/cdn.pipidata.com\/videos\/b3f34ac3a0c7506fc178844c0c4b82c3.mp4",
                        "width": 720
                    }
                ]
            },
            {
                "id": "863124409614895",
                "active_days": 1,
                "ad_audience": null,
                "ad_audience_reach": null,
                "ad_link": "https:\/\/www.facebook.com\/ads\/library\/?id=863124409614895",
                "ad_content": "✨BloomChic | A Re-Imagining\nClothing for women sizes 10-30. We empower you with access to style, comfort, and choice.",
                "ad_cost": null,
                "impression": null,
                "ad_cost_min": null,
                "ad_cost_max": null,
                "estimated_conversion_min": null,
                "estimated_conversion_max": null,
                "ad_forecast": 1,
                "ad_platform": [
                    "FACEBOOK",
                    "INSTAGRAM",
                    "AUDIENCE_NETWORK",
                    "MESSENGER",
                    "THREADS"
                ],
                "ad_started_at": 1761289200,
                "ad_ended_at": 1761289200,
                "ad_status": 1,
                "adset_count": 1,
                "advertiser": {
                    "id": "100842618611379",
                    "ad_count": 42579,
                    "ad_country": [],
                    "ads_library_link": "https:\/\/www.facebook.com\/ads\/library\/?active_status=active&ad_type=all&country=ALL&is_targeted_country=false&media_type=all&search_type=page&view_all_page_id=100842618611379",
                    "adset_count": null,
                    "like_count": 579749,
                    "name": "BloomChic",
                    "profile_picture_url": "https:\/\/cdn.pipidata.com\/images\/5b7079c262046251bde8e30f7e22f504.png",
                    "source_advertiser_id": "100842618611379",
                    "source_advertiser_link": null,
                    "e_commerce_platform": null
                },
                "button_type": "SHOP_NOW",
                "cards": [
                    {
                        "cover_url": null,
                        "duration": null,
                        "height": 1200,
                        "media_type": 2,
                        "url": "https:\/\/cdn.pipidata.com\/images\/c4bc8b7b4d7d42396761328a519eef39.png",
                        "width": 1200
                    },
                    {
                        "cover_url": null,
                        "duration": null,
                        "height": 1200,
                        "media_type": 2,
                        "url": "https:\/\/cdn.pipidata.com\/images\/b5ffe55ff28c64e33a8348e1600cf356.png",
                        "width": 1200
                    },
                    {
                        "cover_url": null,
                        "duration": null,
                        "height": 1200,
                        "media_type": 2,
                        "url": "https:\/\/cdn.pipidata.com\/images\/b5ffe55ff28c64e33a8348e1600cf356.png",
                        "width": 1200
                    },
                    {
                        "cover_url": null,
                        "duration": null,
                        "height": 1200,
                        "media_type": 2,
                        "url": "https:\/\/cdn.pipidata.com\/images\/b5ffe55ff28c64e33a8348e1600cf356.png",
                        "width": 1200
                    },
                    {
                        "cover_url": null,
                        "duration": null,
                        "height": 1200,
                        "media_type": 2,
                        "url": "https:\/\/cdn.pipidata.com\/images\/b5ffe55ff28c64e33a8348e1600cf356.png",
                        "width": 1200
                    },
                    {
                        "cover_url": null,
                        "duration": null,
                        "height": 1200,
                        "media_type": 2,
                        "url": "https:\/\/cdn.pipidata.com\/images\/b5ffe55ff28c64e33a8348e1600cf356.png",
                        "width": 1200
                    }
                ],
                "country": null,
                "first_discovered_at": 1761303751,
                "images": null,
                "landing_page_type": 2,
                "landing_pages": [
                    "https:\/\/bloomchic.com\/products\/geometric-print-drawstring-skinny-waistline-inside-dress?variant=42774716711082&feed_id=fb4454701",
                    "https:\/\/bloomchic.com\/products\/geometric-print-drawstring-skinny-waistline-inside-dress?variant=42774716842154&feed_id=fb4454401",
                    "https:\/\/bloomchic.com\/products\/plunging-neck-button-detail-pocket-maxi-dress?variant=42759663648938&feed_id=fb9739801",
                    "https:\/\/bloomchic.com\/collections\/bloomchic-fit-label",
                    "https:\/\/bloomchic.com\/products\/geometric-print-drawstring-skinny-waistline-inside-dress?variant=42774716809386&feed_id=fb4454001",
                    "https:\/\/bloomchic.com\/products\/geometric-print-drawstring-skinny-waistline-inside-dress?variant=42774716743850&feed_id=fb4454601",
                    "https:\/\/bloomchic.com\/products\/geometric-print-drawstring-skinny-waistline-inside-dress?variant=42774716678314&feed_id=fb4454201"
                ],
                "language": null,
                "last_discovered_at": 1761303799,
                "latest_actived_at": 1761289200,
                "media_format": 3,
                "ad_caption": "bloomchic.com",
                "ad_title": "{{product.current_price strip_zeros}}|{{product.name}}",
                "ad_link_description": "",
                "button_text": "Shop now",
                "products": [
                    {
                        "id": "06f4503b3d07810ad2aec20b3eab46f2",
                        "ad_cost": null,
                        "ad_cost_ratio": null,
                        "ad_count": 653,
                        "ad_ended_at": 1761289200,
                        "ad_started_at": 1748502000,
                        "category_id": null,
                        "category_name": null,
                        "creation_time": 1648896600,
                        "currency": "USD",
                        "image_url": "https:\/\/fb-cdn.pipiads.com\/images\/pimg_71d287434cac842df6f45.png",
                        "name": "Geometric Print Drawstring Skinny Short Dress",
                        "source_product_link": "https:\/\/bloomchic.com\/products\/geometric-print-drawstring-skinny-waistline-inside-dress?variant=42774716743850&feed_id=fb4454601",
                        "price": 21.8,
                        "price_usd": 21.8,
                        "total_revenue": null
                    }
                ],
                "source_ad_id": null,
                "store": {
                    "id": "f65b3d7c58eb2b3fe1a54854ccfbadc9",
                    "ad_count": 51299,
                    "logo_url": "http:\/\/bloomchic.com\/cdn\/shop\/files\/20240102-144940_32x32.png?v=1704178240",
                    "name": "BloomChic",
                    "source_store_link": "https:\/\/bloomchic.com",
                    "e_commerce_platform": "shopify",
                    "e_commerce_types": null
                },
                "videos": null
            },
            {
                "id": "852992863852962",
                "active_days": 1,
                "ad_audience": null,
                "ad_audience_reach": null,
                "ad_link": "https:\/\/www.facebook.com\/ads\/library\/?id=852992863852962",
                "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!",
                "ad_cost": null,
                "impression": null,
                "ad_cost_min": null,
                "ad_cost_max": null,
                "estimated_conversion_min": null,
                "estimated_conversion_max": null,
                "ad_forecast": 1,
                "ad_platform": [
                    "FACEBOOK",
                    "INSTAGRAM",
                    "AUDIENCE_NETWORK",
                    "MESSENGER",
                    "THREADS"
                ],
                "ad_started_at": 1761289200,
                "ad_ended_at": 1761289200,
                "ad_status": 1,
                "adset_count": 16,
                "advertiser": {
                    "id": "100842618611379",
                    "ad_count": 42579,
                    "ad_country": [],
                    "ads_library_link": "https:\/\/www.facebook.com\/ads\/library\/?active_status=active&ad_type=all&country=ALL&is_targeted_country=false&media_type=all&search_type=page&view_all_page_id=100842618611379",
                    "adset_count": null,
                    "like_count": 579749,
                    "name": "BloomChic",
                    "profile_picture_url": "https:\/\/cdn.pipidata.com\/images\/5b7079c262046251bde8e30f7e22f504.png",
                    "source_advertiser_id": "100842618611379",
                    "source_advertiser_link": null,
                    "e_commerce_platform": null
                },
                "button_type": "SHOP_NOW",
                "cards": null,
                "country": null,
                "first_discovered_at": 1761298420,
                "images": null,
                "landing_page_type": 2,
                "landing_pages": [
                    "https:\/\/bloomchic.com\/collections\/swim?sort_by=solid-keyhole-elastic-waist-gathered-one-piece-swimsuit"
                ],
                "language": null,
                "last_discovered_at": 1761298420,
                "latest_actived_at": 1761289200,
                "media_format": 1,
                "ad_caption": "bloomchic.com",
                "ad_title": "✨SIZES 10 TO 30✨",
                "ad_link_description": null,
                "button_text": "Shop now",
                "products": null,
                "source_ad_id": null,
                "store": {
                    "id": "f65b3d7c58eb2b3fe1a54854ccfbadc9",
                    "ad_count": 51299,
                    "logo_url": "http:\/\/bloomchic.com\/cdn\/shop\/files\/20240102-144940_32x32.png?v=1704178240",
                    "name": "BloomChic",
                    "source_store_link": "https:\/\/bloomchic.com",
                    "e_commerce_platform": "shopify",
                    "e_commerce_types": null
                },
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/7c729064e26018c00bf8a0541640c81a.png",
                        "duration": 23,
                        "height": 1280,
                        "url": "https:\/\/cdn.pipidata.com\/videos\/b3f34ac3a0c7506fc178844c0c4b82c3.mp4",
                        "width": 720
                    }
                ]
            },
            {
                "id": "852791487259438",
                "active_days": 1,
                "ad_audience": null,
                "ad_audience_reach": null,
                "ad_link": "https:\/\/www.facebook.com\/ads\/library\/?id=852791487259438",
                "ad_content": "💃Discover your fashion style and show off your elegance!✨\nCreate the ultimate comfort for you and show your unique style.🌟 \nWhether it is daily wear or special occasions, it can perfectly match your personality and needs.\nCome on now and discover your ultimate fashion choice!\n#plus size clothing #fashionable and comfortable #confident and elegant",
                "ad_cost": null,
                "impression": null,
                "ad_cost_min": null,
                "ad_cost_max": null,
                "estimated_conversion_min": null,
                "estimated_conversion_max": null,
                "ad_forecast": 1,
                "ad_platform": [
                    "FACEBOOK",
                    "INSTAGRAM",
                    "AUDIENCE_NETWORK",
                    "MESSENGER",
                    "THREADS"
                ],
                "ad_started_at": 1761289200,
                "ad_ended_at": 1761289200,
                "ad_status": 1,
                "adset_count": 1,
                "advertiser": {
                    "id": "101668105367203",
                    "ad_count": 1044,
                    "ad_country": [],
                    "ads_library_link": "https:\/\/www.facebook.com\/ads\/library\/?active_status=active&ad_type=all&country=ALL&is_targeted_country=false&media_type=all&search_type=page&view_all_page_id=101668105367203",
                    "adset_count": null,
                    "like_count": 61516,
                    "name": "BloomChic Fashion",
                    "profile_picture_url": "https:\/\/cdn.pipidata.com\/images\/5b7079c262046251bde8e30f7e22f504.png",
                    "source_advertiser_id": "101668105367203",
                    "source_advertiser_link": null,
                    "e_commerce_platform": null
                },
                "button_type": "SHOP_NOW",
                "cards": [
                    {
                        "cover_url": null,
                        "duration": null,
                        "height": 1200,
                        "media_type": 2,
                        "url": "https:\/\/cdn.pipidata.com\/images\/b5ffe55ff28c64e33a8348e1600cf356.png",
                        "width": 1200
                    },
                    {
                        "cover_url": null,
                        "duration": null,
                        "height": 1200,
                        "media_type": 2,
                        "url": "https:\/\/cdn.pipidata.com\/images\/b5ffe55ff28c64e33a8348e1600cf356.png",
                        "width": 1200
                    },
                    {
                        "cover_url": null,
                        "duration": null,
                        "height": 1200,
                        "media_type": 2,
                        "url": "https:\/\/cdn.pipidata.com\/images\/c4bc8b7b4d7d42396761328a519eef39.png",
                        "width": 1200
                    },
                    {
                        "cover_url": null,
                        "duration": null,
                        "height": 1200,
                        "media_type": 2,
                        "url": "https:\/\/cdn.pipidata.com\/images\/b5ffe55ff28c64e33a8348e1600cf356.png",
                        "width": 1200
                    },
                    {
                        "cover_url": null,
                        "duration": null,
                        "height": 1200,
                        "media_type": 2,
                        "url": "https:\/\/cdn.pipidata.com\/images\/b5ffe55ff28c64e33a8348e1600cf356.png",
                        "width": 1200
                    },
                    {
                        "cover_url": null,
                        "duration": null,
                        "height": 1200,
                        "media_type": 2,
                        "url": "https:\/\/cdn.pipidata.com\/images\/b5ffe55ff28c64e33a8348e1600cf356.png",
                        "width": 1200
                    }
                ],
                "country": null,
                "first_discovered_at": 1761310641,
                "images": null,
                "landing_page_type": 3,
                "landing_pages": [
                    "https:\/\/bloomchic.com\/products\/geometric-print-drawstring-skinny-waistline-inside-dress?variant=42774716842154&feed_id=fb4454401",
                    "https:\/\/bloomchic.com\/products\/geometric-print-drawstring-skinny-waistline-inside-dress?variant=42774716711082&feed_id=fb4454701",
                    "https:\/\/bloomchic.com\/products\/plunging-neck-button-detail-pocket-maxi-dress?variant=42759663648938&feed_id=fb9739801",
                    "https:\/\/bloomchic.com\/",
                    "https:\/\/bloomchic.com\/products\/geometric-print-drawstring-skinny-waistline-inside-dress?variant=42774716743850&feed_id=fb4454601",
                    "https:\/\/bloomchic.com\/products\/geometric-print-drawstring-skinny-waistline-inside-dress?variant=42774716809386&feed_id=fb4454001",
                    "https:\/\/bloomchic.com\/products\/geometric-print-drawstring-skinny-waistline-inside-dress?variant=42774716678314&feed_id=fb4454201"
                ],
                "language": null,
                "last_discovered_at": 1761312868,
                "latest_actived_at": 1761289200,
                "media_format": 3,
                "ad_caption": "bloomchic.com",
                "ad_title": "{{product.current_price strip_zeros}}  | {{product.name}}",
                "ad_link_description": "",
                "button_text": "Shop now",
                "products": [
                    {
                        "id": "06f4503b3d07810ad2aec20b3eab46f2",
                        "ad_cost": null,
                        "ad_cost_ratio": null,
                        "ad_count": 653,
                        "ad_ended_at": 1761289200,
                        "ad_started_at": 1748502000,
                        "category_id": null,
                        "category_name": null,
                        "creation_time": 1648896600,
                        "currency": "USD",
                        "image_url": "https:\/\/fb-cdn.pipiads.com\/images\/pimg_71d287434cac842df6f45.png",
                        "name": "Geometric Print Drawstring Skinny Short Dress",
                        "source_product_link": "https:\/\/bloomchic.com\/products\/geometric-print-drawstring-skinny-waistline-inside-dress?variant=42774716743850&feed_id=fb4454601",
                        "price": 21.8,
                        "price_usd": 21.8,
                        "total_revenue": null
                    }
                ],
                "source_ad_id": null,
                "store": {
                    "id": "f65b3d7c58eb2b3fe1a54854ccfbadc9",
                    "ad_count": 51299,
                    "logo_url": "http:\/\/bloomchic.com\/cdn\/shop\/files\/20240102-144940_32x32.png?v=1704178240",
                    "name": "BloomChic",
                    "source_store_link": "https:\/\/bloomchic.com",
                    "e_commerce_platform": "shopify",
                    "e_commerce_types": null
                },
                "videos": null
            },
            {
                "id": "850127270910111",
                "active_days": 1,
                "ad_audience": null,
                "ad_audience_reach": null,
                "ad_link": "https:\/\/www.facebook.com\/ads\/library\/?id=850127270910111",
                "ad_content": "🏖️ Dive in and redefine your beach days with a fashion-forward splash! Time to shop, strut, and shine! 👙🌈🌞",
                "ad_cost": null,
                "impression": null,
                "ad_cost_min": null,
                "ad_cost_max": null,
                "estimated_conversion_min": null,
                "estimated_conversion_max": null,
                "ad_forecast": 1,
                "ad_platform": [
                    "FACEBOOK",
                    "INSTAGRAM",
                    "AUDIENCE_NETWORK",
                    "MESSENGER",
                    "THREADS"
                ],
                "ad_started_at": 1761289200,
                "ad_ended_at": 1761289200,
                "ad_status": 1,
                "adset_count": 1,
                "advertiser": {
                    "id": "100296078875911",
                    "ad_count": 7221,
                    "ad_country": [],
                    "ads_library_link": "https:\/\/www.facebook.com\/ads\/library\/?active_status=active&ad_type=all&country=ALL&is_targeted_country=false&media_type=all&search_type=page&view_all_page_id=100296078875911",
                    "adset_count": null,
                    "like_count": 239249,
                    "name": "BloomChic US",
                    "profile_picture_url": "https:\/\/cdn.pipidata.com\/images\/5b7079c262046251bde8e30f7e22f504.png",
                    "source_advertiser_id": "100296078875911",
                    "source_advertiser_link": null,
                    "e_commerce_platform": null
                },
                "button_type": "SHOP_NOW",
                "cards": null,
                "country": null,
                "first_discovered_at": 1761310633,
                "images": null,
                "landing_page_type": 2,
                "landing_pages": [
                    "https:\/\/bloomchic.com\/collections\/swim?sort_by=tropical-flower-print-pockets-one-piece-swimsuit"
                ],
                "language": null,
                "last_discovered_at": 1761310633,
                "latest_actived_at": 1761289200,
                "media_format": 1,
                "ad_caption": "bloomchic.com",
                "ad_title": "✨ SIZE 10 TO 30",
                "ad_link_description": null,
                "button_text": "Shop now",
                "products": null,
                "source_ad_id": null,
                "store": {
                    "id": "f65b3d7c58eb2b3fe1a54854ccfbadc9",
                    "ad_count": 51299,
                    "logo_url": "http:\/\/bloomchic.com\/cdn\/shop\/files\/20240102-144940_32x32.png?v=1704178240",
                    "name": "BloomChic",
                    "source_store_link": "https:\/\/bloomchic.com",
                    "e_commerce_platform": "shopify",
                    "e_commerce_types": null
                },
                "videos": [
                    {
                        "cover_url": "https:\/\/cdn.pipidata.com\/images\/73ae3fdcd9259c79a6a9877ef8971f13.png",
                        "duration": 25,
                        "height": 1278,
                        "url": "https:\/\/cdn.pipidata.com\/videos\/3e866f6b77394e24468f9573b815d05f.mp4",
                        "width": 720
                    }
                ]
            }
        ],
        "last_page": 6413,
        "per_page": 8,
        "total": 51299
    },
    "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
»»» id	string	true	广告ID		none
»»» country	[string]¦null	true	none	国家/地区	none
»»» adset_count	integer	true	none	广告组数	none
»»» ad_audience_reach	integer¦null	true	none	覆盖人数	none
»»» ad_cost	number¦null	true	none	广告花费	货币单位：美元
»»» ad_ended_at	integer¦null	true	none	广告的结束时间	时间戳：秒。
»»» ad_started_at	integer¦null	true	none	广告的创建时间	时间戳：秒。
»»» latest_actived_at	integer¦null	true	none	广告最后时间	时间戳：秒。
»»» first_discovered_at	integer¦null	true	none	广告入库时间	时间戳：秒。
»»» last_discovered_at	integer	true	none	广告最后更新时间	时间戳：秒。
»»» ad_content	string¦null	true	none	广告文案	none
»»» active_days	integer¦null	true	none	广告天数	none
»»» landing_pages	[string]¦null	true	none	落地页URL	none
»»» ad_status	integer¦null	true	none	活跃状态	可选值：1-投放中，2-已停止，3-已下架。
»»» ad_forecast	integer¦null	true	none	广告预测	可选值：1-测品阶段，2-上升阶段，3-盈利阶段。
»»» ad_platform	[string]¦null	true	none	广告平台	none
»»» ad_audience	object¦null	true	none	受众	none
»»»» total_reach	integer	true	none	受众的总人数	none
»»»» gender_audience	string¦null	true	none	受众的群体	none
»»»» age_audience	object	true	none	受众的年龄段	none
»»»»» min	integer¦null	true	none		none
»»»»» max	integer¦null	true	none		none
»»»» details	[object]	true	none	受众国家明细	none
»»»»» country	string	true	none	国家	none
»»»»» total_reach	integer	true	none	受众的人数	none
»»»»» age_gender_breakdowns	[object]	true	none	受众明细	none
»»»»»» age_range	string¦null	true	none	年龄段	none
»»»»»» male	integer¦null	true	none	男性的数量	none
»»»»»» female	integer¦null	true	none	女性的数量	none
»»»»»» unknown	integer¦null	true	none	其它的数量	none
»»» language	string¦null	true	none	语言	none
»»» media_format	integer¦null	true	none	媒体格式	可选值：1-视频， 2-图片， 3-轮播图。
»»» button_type	string¦null	true	none	按钮类型	none
»»» landing_page_type	integer¦null	true	none	落地页面属性	可选值：1-产品落地页，2-Collection落地页，3-其他。
»»» products	[object]¦null	true	none	广告产品	none
»»»» id	string	true	none		none
»»»» name	string	true	none	产品名字	none
»»»» price	number	true	none	产品价格	none
»»»» price_usd	number	true	none	产品价格（美元）	none
»»»» ad_count	integer	true	none	产品广告素材数	none
»»»» category_id	string¦null	true	none	分类ID	none
»»»» category_name	string¦null	true	none	分类名称	none
»»»» creation_time	integer¦null	true	none	创建时间	none
»»»» image_url	string¦null	true	none	产品图片	none
»»»» ad_started_at	integer	true	none	广告开始时间	none
»»»» ad_ended_at	integer	true	none	广告结束时间	none
»»»» ad_cost	number¦null	true	none	广告花费	none
»»»» total_revenue	number¦null	true	none	产品的收入	none
»»»» ad_cost_ratio	number¦null	true	none	产品在这个广告的花费的比例	none
»»»» currency	string¦null	true	none	货币	none
»»» advertiser	object¦null	true	none	广告主	none
»»»» id	string	true	none		none
»»»» source_advertiser_id	string	true	none	主页id	none
»»»» name	string	true	none	广告主page的名字	none
»»»» ad_count	integer	true	none	广告主page 素材数	none
»»»» like_count	integer¦null	true	none	广告主page点赞数	none
»»»» profile_picture_url	string¦null	true	none	广告主头像链接	none
»»»» source_advertiser_link	string¦null	true	none	广告主的源链接	none
»»»» adset_count	integer¦null	true	none	广告组数	none
»»»» e_commerce_platform	string¦null	true	none	电商平台	none
»»»» ad_country	[string]	true	none	投放国家	none
»»»» ads_library_link	string	true	none	library链接	none
»»» images	[object]	true	none	图片	none
»»»» url	string	true	none	图片的链接	none
»»»» width	integer¦null	true	none	图片的宽度	none
»»»» height	integer¦null	true	none	图片的高度	none
»»» videos	[object]	true	none	视频	none
»»»» url	string	true	none	视频的链接	none
»»»» cover_url	string¦null	true	none	视频的封面图链接	none
»»»» width	integer¦null	true	none	视频的宽度	none
»»»» height	integer¦null	true	none	视频的高度	none
»»»» duration	integer¦null	true	none	视频的时长	none
»»» cards	[object]	true	none	轮播图	none
»»»» media_type	integer	true	none	媒体类型	可选值：1-视频， 2-图片。
»»»» url	string	true	none	视频/图片的链接	none
»»»» cover_url	string¦null	true	none	视频的封面图链接	none
»»»» width	integer¦null	true	none	视频/图片的宽度	none
»»»» height	integer¦null	true	none	视频/图片的高度	none
»»»» duration	integer¦null	true	none	视频的时长	none
»»» store	object¦null	true	none	广告店铺	none
»»»» id	string	true	none	店铺ID	none
»»»» name	string	true	none	店铺名称	none
»»»» ad_count	integer	true	none	店铺素材数	none
»»»» e_commerce_platform	string¦null	true	none	电商平台	none
»»»» e_commerce_types	[integer]¦null	true	none	电商类型	none
»»»» logo_url	string¦null	true	none	店铺logo图片	none
»»»» source_store_link	string¦null	true	none	店铺链接	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-library-list
价格说明: 免费