社交媒体数据接口概览

本接口用于获取网页在社交媒体上的传播互动数据。

实现方式基于社交平台官方提供并维护的网页嵌组件（embed）。本平台通过在自身环境中镜像这些嵌能力，聚合与指定页面的社交互动数据。因此，向社交媒体数据接口提交目标网页 URL 后，即可返回每个页面对应的社交互动数量。

当前，社交媒体数据接口支持一个数据源：Pinterest。后续将逐步扩展更多社交平台数据源。

支持的数据源

Pinterest

通过以下接口可获取指定页面在 Pinterest 上的互动数据：

/v3/business_data/social_media/pinterest/live/

该接口返回网页通过 Pinterest Save Button 嵌所产生的 pin 数量。

请求方式说明

社交媒体数据接口的结果与创建任务时 targets 数组中的 URL 直接对应。

• 单次任务最多可提交 10 个 URL
• 所有社交媒体数据接口均支持 Live 实时获取方式
• 使用 Live 方法时，无需拆分为单独的 POST 与 GET 轮询流程
• 提交请求后，接口会直接返回结果

调用频率

你最多可发起：

• 2000 次 API 调用 / 分钟

计费说明

本接口按请求计费，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

如需估算成本，请结合端点的响应与调用量进行核算。

认证方式

请在请求头中使用 Bearer Token：

Authorization: Bearer smt_live_YOUR_KEY

通用请求体格式

POST 请求体使用 JSON 数组格式：

[
 {
 "targets": [
 "https://example.com/page-1",
 "https://example.com/page-2"
 ]
 }
]

说明：

• targets：目标网页 URL 数组
• 单个任务最多支持 10 个 URL
• 返回结果会与 targets 中的 URL 一一对应

接口示例

以下示例展示如何调用 Pinterest 实时接口：

cURL

curl -X POST "https://api.seermartech.cn/v3/business_data/social_media/pinterest/live/" \
 -H "Authorization: Bearer smt_live_YOUR_KEY" \
 -H "Content-Type: application/json" \
 -d '[
 {
 "targets": [
 "https://example.com/article-a",
 "https://example.com/article-b"
 ]
 }
 ]'

Python

import requests

url = "https://api.seermartech.cn/v3/business_data/social_media/pinterest/live/"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
payload = [
 {
 "targets": [
 "https://example.com/article-a",
 "https://example.com/article-b"
 ]
 }
]

response = requests.post(url, headers=headers, json=payload)
print(response.status_code)
print(response.text)

TypeScript

const url = "https://api.seermartech.cn/v3/business_data/social_media/pinterest/live/";

const payload = [
 {
 targets: [
 "https://example.com/article-a",
 "https://example.com/article-b"
 ]
 }
];

async function main {
 const response = await fetch(url, {
 method: "POST",
 headers: {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 body: JSON.stringify(payload)
 });

 const data = await response.json;
 console.log(data);
}

main;

返回结果说明

接口会针对 targets 中的每个 URL 返回对应的社交互动统计结果。由于当前支持 Pinterest，返回数据主要用于表示页面在 Pinterest 上的 pin 互动。

你应重点以下信息：

• targets：提交的目标 URL 列表
• 每个目标 URL 对应的 Pinterest 互动数量
• cost：本次请求的扣费金额
• status_code / status_message：请求处理状态

使用建议

• 对页、商品页、落地页分别批量查询 Pinterest 传播表现
• 将返回的互动数与页面流量、转化率结合，识别高传播潜力页面
• 由于单次最多支持 10 个 URL，建议在批量处理时按固定分片提交
• 如需控制吞吐量，请结合 2000 次/分钟 的频率限制进行并发调度

错误处理建议

如请求失败，建议优检查以下：

• Authorization 是否为有效的 Bearer Token
• 请求体是否为 JSON 数组 [{...}]
• targets 是否存在且为 URL 数组
• targets 中的 URL 数量是否 10 个
• 请求频率是否每分钟 2000 次

同时，请结合响应中的：

• status_code
• status_message

进行问题定位。

实用场景

• 监控传播表现：批量查询文章页在 Pinterest 上的 pin 数，快速识别更容易被收藏和扩散的主题。
• 评估落地页社交吸引力：对活动页、专题页进行社交互动对比，判断页面素材和标题是否备传播潜力。
• 筛选高价值商品页：分析商品页在 Pinterest 上的互动数据，发现更适合视觉化种草和社媒引流的商品。
• 追踪竞品热度：提交竞品文章或品类页 URL，了解在 Pinterest 上的页面互动规模，为选题和投放提供参考。
• 构建社交流量评分：将 Pinterest 互动数与自然流量、转化数据结合，建立页面综合价值评分模型，支持 SEO 与运营优级排序。