广告库详情接口

API 信息

• API 名称: 获取广告库详情
• 请求方法: POST
• API 地址: /open-api/v1/data
• 接口路径: /v3/api/open/lib-ads/detail
• 接口描述: 根据广告 ID 获取广告详细信息，包含广告历史变化数据
• 价格说明: 详情接口计费规则： 基础费用：1 credit/次。 免费访问条件（满足其一即可）： 该ID在3天内已获取过详情；该ID在3天内出现在您的榜单列表查询结果中。

请求头设置：

• Content-Type: application/json
• Accept: application/json

请求参数

请求结构

参数列表 (params 对象)

请求示例

curl -X POST "https://www.pipispy.com/open-api/v1/data" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "key": "your_api_key_here",
    "uri": "/v3/api/open/lib-ads/detail",
    "params": {
      "id": "06c7df340f26f2539c8dada9fa5afe27"
    }
  }'

响应

响应体结构

{
  "code": 200,
  "message": "success",
  "data": {
    "ads_history": {
      // 广告历史变化数据
    },
    "advertisement": {
      // 广告详细信息
    }
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}

响应字段说明

主要响应字段

广告历史字段 (ads_history)

历史数据时间线字段 (timeline)

广告详情字段 (advertisement)

AI 分析对象字段 (ai_analysis)

广告主信息对象字段 (advertiser)

产品信息对象字段 (products)

店铺信息对象字段 (store)

店铺分类对象字段 (categories)

视频信息对象字段 (videos)

图片信息对象字段 (images)

轮播图信息对象字段 (cards)

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "ads_history": {
      "ad_cost": {
        "timeline": [
          {
            "count": 0.0,
            "date": "2025-06-04"
          },
          {
            "count": 0.0,
            "date": "2025-06-05"
          }
        ]
      },
      "adset_count": {
        "timeline": [
          {
            "count": 1.0,
            "date": "2025-06-04"
          },
          {
            "count": 1.0,
            "date": "2025-06-05"
          }
        ]
      }
    },
    "advertisement": {
      "id": "9a4566becbe35c6f6c0f1beac8dd6e30",
      "active_days": 1,
      "ad_caption": "ladyluxve.com",
      "ad_content": "🚨 ALERTA TENDENCIA 🚨\nEl botín que está arrasando en redes sociales ya llegó a Venezuela 🇻🇪",
      "ad_forecast": 1,
      "ad_link": "https://www.facebook.com/ads/library/?id=1124613119690978",
      "ad_link_description": "⭐⭐⭐⭐⭐",
      "ad_platform": [
        "FACEBOOK",
        "INSTAGRAM",
        "AUDIENCE_NETWORK",
        "MESSENGER",
        "THREADS"
      ],
      "ad_started_at": 1749020400,
      "ad_status": 3,
      "ad_title": "35% OFF Hoy+ Envio GRATIS",
      "adset_count": 1,
      "advertiser": {
        "id": "7302fd79a2d742bb6c0f1beac8dd6e30",
        "name": "Lady Lux",
        "ad_count": 11,
        "ad_country": ["other"],
        "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=685400174653320",
        "adset_count": 11,
        "e_commerce_platform": "shopify",
        "like_count": 1201,
        "profile_picture_url": "https://fb-cdn.pipispy.com/images/38f38e24fa774ca1bf01da9aba9ac47e.png",
        "source_advertiser_id": "685400174653320",
        "source_advertiser_link": "https://facebook.com/61576957564176",
        "user_blocked": 2
      },
      "button_text": "Shop now",
      "button_type": "SHOP_NOW",
      "cards": [],
      "country": ["other"],
      "first_discovered_at": 1749024028,
      "images": [],
      "landing_page_type": 1,
      "landing_pages": [
        "https://ladyluxve.com/products/botin%E2%84%A2-starway"
      ],
      "language": "es",
      "last_discovered_at": 1749108995,
      "latest_actived_at": 1749106800,
      "media_format": 1,
      "products": [
        {
          "currency": "USD",
          "id": "dd66f501d1faa6adbe16801b708c35d5",
          "name": "Botin™ - Starway",
          "price": 49.99,
          "ad_count": 3,
          "creation_time": 1748732926,
          "image_url": "https://fb-cdn.pipispy.com/images/pimg_85d72df090674a0b56a4f.png",
          "price_usd": 49.99,
          "source_product_link": "https://ladyluxve.com/products/botin%E2%84%A2-starway"
        }
      ],
      "source_ad_id": "1124613119690978",
      "store": {
        "categories": [
          {
            "id": "62739ba938365b2f72048eca",
            "name_en": "Shoes",
            "name_zh": "鞋类"
          }
        ],
        "id": "389f77b24aefc6ffbe16801b708c35d5",
        "name": "Lady lux",
        "ad_count": 11,
        "e_commerce_platform": "shopify",
        "logo_url": "http://ladyluxve.com/cdn/shop/files/ladyancho.jpg?crop=center&height=32&v=1748537443&width=32",
        "source_store_link": "https://ladyluxve.com"
      },
      "user_collected": 2,
      "videos": [
        {
          "duration": 16,
          "height": 1280,
          "url": "https://fb-cdn.pipispy.com/videos/a98e21abd3b3b2340f9998d5a8f209ac.mp4",
          "width": 720,
          "cover_url": "https://fb-cdn.pipispy.com/images/40960e1f77f4077634bf463593b629ba.png"
        }
      ],
      "size": "9:16",
      "clarity": "FHD",
      "aspect_ratio": "720x1280"
    }
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}

错误码

注意事项

1. 广告 ID 必须是有效的系统内部 ID
2. 响应中的 URL 已转换为 CDN 地址
3. 所有时间戳均为 Unix 时间戳（秒）
4. AI 分析字段仅在视频广告中返回
5. 部分字段可能为空，取决于广告类型和数据完整性