Pipispy APIEnglish

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

监控任务广告文案(最长运营)

接口信息

  • 接口名称: 监控任务广告文案(最长运营)
  • 请求方法: POST
  • 接口地址: open-api/v1/monitor/data
  • 接口路径: /v3/api/ad-monitor-task/ad-copy-longest-run
  • 接口描述:
    • 获取广告文案-最长运营列表,分析广告文案的持续投放时间
    • 价格说明: 免费

请求头:

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

请求参数

请求结构

参数名 类型 描述 示例 必填 默认值
key string 用户申请的外部 api 请求 key "your_api_key_here" 是
uri string 接口路径 "/v3/api/ad-monitor-task/ad-copy-longest-run" 是
params object 接口入参对象 见参数列表 是

请求体参数 (params 对象)

参数名 类型 必填 描述
task_id String true 任务id
order_by String false 排序字段
active_days
ad_started_at
direction String false 排序方式
desc(降序)
asc(升序)
page integer false 页码 (默认值1)
per_page integer false 分页大小 (默认值10)

请求示例

curl -X POST "https://www.pipispy.com/open-api/v1/monitor/data" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "key": "your_api_key_here",
    "uri": "/v3/api/ad-monitor-task/ad-copy-longest-run",
    "params": {
      "task_id": "68fa2e36789edb5700215e03",
      "order_by": "active_days",
      "direction": "desc",
      "per_page": 10,
      "page": 1
    }
  }'

响应参数

响应体结构

{
    "code": 200,
    "message": "success",
    "data": {},
    "version": "v1",
    "timestamp": null,
    "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
    "success": true,
    "fail": false
}

响应字段说明

字段名 类型 描述
code Integer 响应状态码,200 表示成功
message String 响应消息
data Object 响应数据
version String API 版本
timestamp String 响应时间戳
sign String 响应签名
remaining_credits Long 当前请求后的剩余可用积分
consumed_credits Long 本次请求消耗的积分
success Boolean 请求是否成功
fail Boolean 请求是否失败

响应结果信息字段

分页信息字段

字段名 类型 描述
per_page integer 每页显示数量
total integer 总记录数
last_page integer 最后一页页码
current_page integer 当前页码

广告文案数据字段(data数组中的对象)

字段名 类型 描述
ad_id string 广告唯一标识ID
ad_content string 广告文案内容
ad_started_at integer 广告开始投放时间戳(秒)
active_days integer 广告活跃天数
ad_status integer 广告状态(1:活跃,2:不活跃,3:下架)
media_format integer 媒体格式(1:视频,2:图片,3:轮播图)

轮播卡片信息字段(cards数组中的对象)

字段名 类型 描述
cover_url string 卡片封面图片URL
media_type integer 媒体类型(1:视频,2:图片)
url string 媒体文件URL(视频或图片)

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "per_page": 1,
    "total": 14383,
    "data": [
      {
        "ad_id": "533113862830147",
        "cards": [
          {
            "cover_url": "https://cdn.pipidata.com/images/9192627b9a36040a50fe2de4b498af66bd5dbd6eba3105319e6741143ef98ad3.png",
            "media_type": 1,
            "url": "https://cdn.pipidata.com/videos/5fa61671bec84b95fc8c89b2d6b1c1c2b32b645cdd52a5d518e6e2df13a6e5d8.mp4"
          },
          {
            "cover_url": "https://cdn.pipidata.com/images/b580a01a2b3c53582c0973c76435745b4bc98c1a9aa5d02a85c1ba1d8fff06eb.png",
            "media_type": 1,
            "url": "https://cdn.pipidata.com/videos/39716ecc4d74112db9bbb9cd39ebc574548a3c335afd3dffdf61adff689089cf.mp4"
          },
          {
            "cover_url": "https://cdn.pipidata.com/images/8a01532735407f02653e6bcf2614ede57378f2489993f524a4411187e0ce85af.png",
            "media_type": 1,
            "url": "https://cdn.pipidata.com/videos/c79d0d74990f35d70b3a454d393f69267fba3b51f62ccd78baaea086f22cb602.mp4"
          },
          {
            "cover_url": "https://cdn.pipidata.com/images/1aed919d9871dcfef51b68b063ca8ee901e59a869319a51e3a71f408d5928fe0.png",
            "media_type": 1,
            "url": "https://cdn.pipidata.com/videos/77448e042c5babe93bddbd63b09e147f87d89f48dced4f62545003768dfdc48b.mp4"
          },
          {
            "cover_url": "https://cdn.pipidata.com/images/46a27759af20e2be7870263f781eb8c0077440d62242eb798abc7b19eac271db.png",
            "media_type": 1,
            "url": "https://cdn.pipidata.com/videos/ee1162127729f52b9943234cbf23f8c67cec59a2956d183bb83d88e9d4e88716.mp4"
          }
        ],
        "media_format": 3,
        "ad_content": "Werken bij Coolblue",
        "ad_started_at": 1731916800,
        "active_days": 184,
        "ad_status": 1
      }
    ],
    "last_page": 14383,
    "current_page": 1
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "success": true,
  "fail": false
}

错误码说明

错误码 描述
200 成功
400 请求参数错误
500 服务器内部错误