店铺广告文案分析接口

本文档包含两个接口：TikTok 平台广告文案分析接口和 Facebook 平台广告文案分析接口。

一、TikTok 平台广告文案分析接口

接口信息

• 接口名称: TikTok 平台广告文案分析接口
• 请求方法: POST
• 接口地址: /open-api/v1/data
• 接口路径: /v3/api/open/store/tiktok/ad-copy-analysis
• 接口描述:
  • 查询指定店铺在 TikTok 平台的广告文案统计分析数据
  • 按广告名和文案内容聚合，统计每个文案组合的使用次数和播放量
  • 支持按播放次数、广告数量排序
  • 帮助分析店铺在 TikTok 平台使用的高效文案组合
  • 价格说明: 免费

请求头:

• 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/store/tiktok/ad-copy-analysis",
    "params": {
      "id": "c2d5b2547218a",
      "current_page": 1,
      "page_size": 10,
      "sort_key": "play_count",
      "sort_type": "desc"
    }
  }'

响应参数

响应体结构

{
  "code": 200,
  "message": "success",
  "data": {
    "tikTok_copy_analysis": [
      {
        "ad_name": "Summer Fashion Collection",
        "copywriter": "Get 50% OFF on all summer items! Limited time offer 🔥",
        "ad_count": 25,
        "play_count": 5280000
      },
      {
        "ad_name": "Fitness Tracker Pro",
        "copywriter": "Track your health goals with our smart fitness tracker ⭐",
        "ad_count": 18,
        "play_count": 3850000
      }
    ],
    "current_page": 1,
    "page_size": 10,
    "total": 156,
    "page_count": 16
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "fail": false,
  "success": true
}

响应字段说明

响应结果信息字段

tikTok_copy_analysis 数组元素结构

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "tikTok_copy_analysis": [
      {
        "ad_name": "Summer Fashion Collection",
        "copywriter": "🔥 Get 50% OFF on all summer items! Limited time offer. Shop now and save big on trendy outfits!",
        "ad_count": 25,
        "play_count": 5280000
      },
      {
        "ad_name": "Fitness Tracker Pro",
        "copywriter": "⭐ Track your health goals with our smart fitness tracker. Monitor steps, calories, heart rate & more!",
        "ad_count": 18,
        "play_count": 3850000
      },
      {
        "ad_name": "Smart Home Camera",
        "copywriter": "🏠 Protect your home 24/7 with HD camera. Motion detection, night vision, easy setup!",
        "ad_count": 15,
        "play_count": 2920000
      },
      {
        "ad_name": "Wireless Earbuds",
        "copywriter": "🎵 Premium sound quality meets comfort. Noise cancellation, 30hr battery life. Order today!",
        "ad_count": 12,
        "play_count": 2450000
      }
    ],
    "current_page": 1,
    "page_size": 10,
    "total": 156,
    "page_count": 16
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "fail": false,
  "success": true
}

错误码说明

使用说明

1. 数据聚合维度：

   • 按照"广告名 + 文案内容"的组合进行聚合统计
   • 相同广告名和文案内容的广告会被合并统计

2. 排序字段：

   • play_count：按总播放次数排序，适合找出高曝光的文案组合
   • ad_count：按广告数量排序，适合找出复用率高的文案组合

3. 应用场景：

   • 分析哪些广告名和文案组合获得更多播放量
   • 识别店铺在 TikTok 平台的常用文案策略
   • 优化广告文案，提升投放效果

二、Facebook 平台广告文案分析接口

接口信息

• 接口名称: Facebook 平台广告文案分析接口
• 请求方法: POST
• 接口地址: open-api/v1/data
• 接口路径: /v3/api/open/store/facebook/ad-copy-analysis
• 接口描述:
  • 查询指定店铺在 Facebook 平台的广告文案统计分析数据
  • 按广告名和文案内容聚合，统计每个文案组合的使用次数和点赞数
  • 支持按点赞数、广告数量排序
  • 帮助分析店铺在 Facebook 平台使用的高互动文案组合
  • 价格说明: 免费

请求头:

• 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/store/facebook/ad-copy-analysis",
    "params": {
      "id": "12345",
      "current_page": 1,
      "page_size": 10,
      "sort_key": "digg_count",
      "sort_type": "desc"
    }
  }'

响应参数

响应体结构

{
  "code": 200,
  "message": "success",
  "data": {
    "facebook_copy_analysis": [
      {
        "ad_name": "Summer Fashion Collection",
        "copywriter": "Get 50% OFF on all summer items! Limited time offer 🔥",
        "ad_count": 20,
        "digg_count": 125000
      },
      {
        "ad_name": "Fitness Tracker Pro",
        "copywriter": "Track your health goals with our smart fitness tracker ⭐",
        "ad_count": 16,
        "digg_count": 98000
      }
    ],
    "current_page": 1,
    "page_size": 10,
    "total": 89,
    "page_count": 9
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "fail": false,
  "success": true
}

响应字段说明

响应结果信息字段

facebook_copy_analysis 数组元素结构

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "facebook_copy_analysis": [
      {
        "ad_name": "Summer Fashion Collection",
        "copywriter": "🎁 Special Promotion! Get 50% OFF on all summer fashion items. Limited time only. Shop before it's gone!",
        "ad_count": 20,
        "digg_count": 125000
      },
      {
        "ad_name": "Fitness Tracker Pro",
        "copywriter": "🌟 Track your health goals with our smart fitness tracker. Monitor steps, calories, heart rate and sleep quality!",
        "ad_count": 16,
        "digg_count": 98000
      },
      {
        "ad_name": "Smart Home Camera",
        "copywriter": "💯 Protect your home 24/7 with HD security camera. Motion detection, night vision, two-way audio. Easy setup!",
        "ad_count": 14,
        "digg_count": 87500
      },
      {
        "ad_name": "Wireless Earbuds",
        "copywriter": "🚀 Premium sound quality with active noise cancellation. 30-hour battery life. Free shipping worldwide!",
        "ad_count": 11,
        "digg_count": 76000
      }
    ],
    "current_page": 1,
    "page_size": 10,
    "total": 89,
    "page_count": 9
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "fail": false,
  "success": true
}

错误码说明

使用说明

1. 数据聚合维度：

   • 按照"广告名 + 文案内容"的组合进行聚合统计
   • 相同广告名和文案内容的广告会被合并统计

2. 排序字段：

   • digg_count：按总点赞数排序，适合找出高互动的文案组合
   • ad_count：按广告数量排序，适合找出复用率高的文案组合

3. 应用场景：

   • 分析哪些广告名和文案组合获得更多用户互动
   • 识别店铺在 Facebook 平台的常用文案策略
   • 优化广告文案，提升用户参与度