Pipispy APIEnglish

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

店铺 Meta 广告资料库最常用广告文案列表接口

接口信息

  • 接口名称: 获取店铺最常用广告文案列表
  • 请求方法: POST
  • 接口地址: /open-api/v1/data
  • 接口路径: /v3/api/open/ppspy/pp-stores/ad-content/most-used
  • 接口描述: 获取指定店铺在Meta广告资料库中使用频率最高的广告文案列表,包括文案内容、使用该文案的广告数量、活跃广告数、投放时间等信息,帮助分析店铺的核心广告文案策略
  • 价格说明: 免费

请求头:

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

请求参数

请求结构

参数名 类型 描述 示例 必填 默认值
key string 用户申请的外部 api 请求 key "your_api_key_here" 是
uri string 接口路径 "/v3/api/open/ppspy/pp-stores/ad-content/most-used" 是
params object 接口入参对象 见参数列表 是

请求体参数 (params 对象)

参数名 类型 必填 描述
id String 是 店铺唯一标识ID,为13位字符串(例如:c2d5b2547218a),对应店铺榜单列表接口返回结果中的 store_id 字段
order_by String 否 排序字段。可选值:ad_count-按广告数量排序,active_ad_count-按活跃广告数排序,latest_ad_started_at-按最近广告日期排序。默认值:ad_count
direction String 否 排序方式。可选值:desc-降序(从大到小/从新到旧),asc-升序(从小到大/从旧到新)。默认值:desc
page_size Long 否 每页记录数,指定单页返回的文案数量。默认值:20
current_page Long 否 当前页码,页码从1开始。默认值:1

请求示例

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/ppspy/pp-stores/ad-content/most-used",
    "params": {
        "id": "c2d5b2547218a",
        "order_by": "ad_count",
        "direction": "desc",
        "page_size": 20,
        "current_page": 1
    }
  }'

响应参数

响应体结构

{
  "code": 200,
  "message": "success",
  "data": {
    "current_page": 1,
    "data": [],
    "first_page_url": "",
    "from": 1,
    "is_logged_in": false,
    "last_page": 1,
    "last_page_url": "",
    "next_page_url": null,
    "path": "",
    "per_page": 20,
    "prev_page_url": null,
    "to": 20,
    "total": 100
  },
  "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 请求是否失败

分页数据字段 (data.data)

字段名 类型 描述
current_page Long 当前页码
data Array 广告文案列表
first_page_url String 第一页的URL地址
from Long 起始记录位置(当前页第一条记录在总结果集中的位置)
is_logged_in Boolean 用户是否已登录,用于标识数据权限状态
last_page Long 最后一页的页码(总页数)
last_page_url String 最后一页的URL地址
next_page_url String 下一页的URL地址,如果没有下一页则为null
path String API请求路径
per_page Long 每页记录数
prev_page_url String 上一页的URL地址,如果没有上一页则为null
to Long 结束记录位置(当前页最后一条记录在总结果集中的位置)
total Long 总记录数

广告文案字段 (Datum)

字段名 类型 描述
id String 文案记录唯一标识ID
ad_content_md5 String 广告文案内容的MD5哈希值,用于标识相同内容的文案
ad_content String 广告文案内容
ad_count Long 使用该文案的广告总数量,表示该文案被复用的次数
active_ad_count Long 使用该文案的活跃广告数量(当前正在投放的广告数)
ad_started_at Long 该文案首次投放时间,Unix时间戳(秒级)
ad_ended_at Long 该文案最后一次投放结束时间,Unix时间戳(秒级)
active_days Long 该文案的累计投放天数
latest_ad_started_at Long 使用该文案的最近一条广告的开始时间,Unix时间戳(秒级)
percentage Double 该文案占店铺所有文案的使用比例(0.0-1.0)

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": "content_001",
        "ad_content_md5": "a1b2c3d4e5f6g7h8i9j0",
        "ad_content": "Shop now and get 50% off! Limited time offer. Free shipping on orders over $50. Don't miss out on this amazing deal!",
        "ad_count": 85,
        "active_ad_count": 23,
        "ad_started_at": 1680000000,
        "ad_ended_at": 1700000000,
        "active_days": 230,
        "latest_ad_started_at": 1699500000,
        "percentage": 0.125
      },
      {
        "id": "content_002",
        "ad_content_md5": "b2c3d4e5f6g7h8i9j0k1",
        "ad_content": "New arrivals! Check out our latest collection. Premium quality at affordable prices.",
        "ad_count": 62,
        "active_ad_count": 18,
        "ad_started_at": 1685000000,
        "ad_ended_at": 1699800000,
        "active_days": 170,
        "latest_ad_started_at": 1699200000,
        "percentage": 0.091
      },
      {
        "id": "content_003",
        "ad_content_md5": "c3d4e5f6g7h8i9j0k1l2",
        "ad_content": "Best seller! Thousands of 5-star reviews. Order yours today!",
        "ad_count": 48,
        "active_ad_count": 0,
        "ad_started_at": 1670000000,
        "ad_ended_at": 1695000000,
        "active_days": 290,
        "latest_ad_started_at": 1694500000,
        "percentage": 0.071
      }
    ],
    "first_page_url": "https://api.example.com/contents?page=1",
    "from": 1,
    "is_logged_in": false,
    "last_page": 10,
    "last_page_url": "https://api.example.com/contents?page=10",
    "next_page_url": "https://api.example.com/contents?page=2",
    "path": "https://api.example.com/contents",
    "per_page": 20,
    "prev_page_url": null,
    "to": 20,
    "total": 200
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "success": true,
  "fail": false
}

错误码说明

错误码 描述
200 成功
400 请求参数错误
401 未授权
403 权限不足
500 服务器内部错误