社交媒体 API：概览

社交媒体 API 用于获取网页在社交媒体平台上的传播与互动数据。本平台通过分析社交媒体平台提供的网页嵌组件，汇总指定网页对应的社交互动数量。

调用接口时，可在 targets 数组中最多提交 10 个网页 URL，接口将返回每个网页对应的社交互动数据。

目前，社交媒体 API 支持 Pinterest 数据，后续将逐步扩展更多数据源。

支持的平台

Pinterest 接口用于获取网页通过 Pinterest Save Button 嵌组件产生的 Pin 数量。

接口地址：POST /v3/business_data/social_media/pinterest/live/
数据获取方式：Live
单个任务最多支持：10 个 URL

数据获取方式

社交媒体 API 的所有接口均支持 Live 实时获取方式。提交任务后，接口会立即返回结果，无需再分别调用 POST 和 GET 接口查询任务状态。

接口返回的数据对应当前请求中 targets 数组指定的 URL。

请求参数

请求体使用 JSON 数组格式，即使只提交一个任务，也需要使用数组裹任务对象。

参数	类型	填	说明
`targets`	`string[]`	是	要查询的网页 URL 列表，单个任务最多支持 10 个 URL。

请求示例

bash

curl --location --request POST 'https://api.seermartech.cn/v3/business_data/social_media/pinterest/live/' \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "targets": [
        "https://www.example.com/article-1",
        "https://www.example.com/article-2"
      ]
    }
  ]'

响应说明

接口会针对 targets 数组中的每个 URL 返回对应的 Pinterest 社交互动数据，主要用于了解网页被保存为 Pin 的数量。

响应中的字段以接口返回结果为准。由于查询结果与提交的 URL 直接，请确保 URL 可访问，并使用完整的网页地址。

调用限制

单个任务最多提交 10 个 URL。平台限流以认证说明中的 30/60/120 次/分钟规则为准。
Live 接口提交请求后直接返回查询结果，不需要额外轮询。

优级与计费

本接口调用计费。当前页面未提供固定单价，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

如需查看账户消费，可访问本平台账户控制台，或调用用户数据接口：

GET /v3/appendix/user_data/

实用场景

评估传播效果：统计文章在 Pinterest 上的 Pin 数量，识别较强社交传播力的。
比较页面社交表现：批量查询多个落地页或博客页面，筛选社交互动表现更好的页面。
选题决策：分析同类主题页面的 Pinterest 传播数据，为后续 SEO规划提供依据。
监测竞品热度：定期查询竞品页面的 Pin 数量，了解在社交渠道中的受欢迎程度。
验证推广素材效果：对活动页、产品页和专题页进行批量监测，评估页面素材对社交分享的促进作用。

社交媒体 API：概览 ​

支持的平台 ​

Pinterest ​

数据获取方式 ​

请求参数 ​

请求示例 ​

响应说明 ​

调用限制 ​

优级与计费 ​

实用场景 ​