店铺 Meta 广告资料库 Facebook广告主页列表接口

接口信息

• 接口名称: 获取店铺Facebook广告主页列表

• 请求方法: POST

• 接口地址: /open-api/v1/data

• 接口路径: /v3/api/open/ppspy/pp-stores/fb-page

• 接口描述: 获取指定店铺关联的Facebook广告主页（Page）列表，包括主页基本信息、粉丝数、广告数量、广告投放平台等，帮助分析店铺的广告主账号布局和投放策略

• 价格说明: 免费 请求头:

• 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/ppspy/pp-stores/fb-page",
    "params": {
        "id": "c2d5b2547218a",
        "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
}

响应字段说明

分页数据字段 (data.data)

Facebook广告主页字段 (Datum)

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": "page_001",
        "name": "Fashion Store Official",
        "profile_picture_url": "https://example.com/images/page_avatar_001.jpg",
        "category_name": "购物与零售",
        "like_count": 125000,
        "creation_time": 1520000000,
        "ad_platform": [
          "FACEBOOK",
          "INSTAGRAM"
        ],
        "ad_count": 350,
        "ad_source": 3,
        "source_advertiser_id": "100123456789012",
        "store_ad_count": 280,
        "ads_library_link": "https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=ALL&view_all_page_id=100123456789012"
      },
      {
        "id": "page_002",
        "name": "Fashion Store - US",
        "profile_picture_url": "https://example.com/images/page_avatar_002.jpg",
        "category_name": "电子商务网站",
        "like_count": 45000,
        "creation_time": 1580000000,
        "ad_platform": [
          "FACEBOOK",
          "INSTAGRAM",
          "MESSENGER"
        ],
        "ad_count": 180,
        "ad_source": 3,
        "source_advertiser_id": "100987654321098",
        "store_ad_count": 150,
        "ads_library_link": "https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=ALL&view_all_page_id=100987654321098"
      },
      {
        "id": "page_003",
        "name": "Fashion Deals & Offers",
        "profile_picture_url": "https://example.com/images/page_avatar_003.jpg",
        "category_name": "品牌",
        "like_count": 8500,
        "creation_time": 1650000000,
        "ad_platform": [
          "FACEBOOK"
        ],
        "ad_count": 45,
        "ad_source": 3,
        "source_advertiser_id": "100111222333444",
        "store_ad_count": 45,
        "ads_library_link": "https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=ALL&view_all_page_id=100111222333444"
      }
    ],
    "first_page_url": "https://api.example.com/pages?page=1",
    "from": 1,
    "is_logged_in": false,
    "last_page": 2,
    "last_page_url": "https://api.example.com/pages?page=2",
    "next_page_url": "https://api.example.com/pages?page=2",
    "path": "https://api.example.com/pages",
    "per_page": 20,
    "prev_page_url": null,
    "to": 3,
    "total": 25
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "success": true,
  "fail": false
}

错误码说明