API Manual

Polymer-spider 短视频数据聚合 API

这里先使用占位文档结构。正式版本会把 TikTok、YouTube、小红书、抖音的数据采集、指标查询、评论分析、达人检索和 Webhook 分发统一到同一套 API 里。

Base URL https://api.polymer-spider.ai/v1

Quick Start

Get Started Now

替换 base URL，添加 API Key，然后选择左侧任意接口类型开始调用。

Authentication

所有接口都通过 Bearer Token 认证。下面是占位认证示例。

Authorization: Bearer ps_live_placeholder_key
Content-Type: application/json

GET

Platform List API

/platforms

获取当前工作区已接入或可接入的平台列表。

调用说明

用于初始化平台筛选器、接入状态页面和数据源管理后台。

curl -X GET "https://api.polymer-spider.ai/v1/platforms" \
  -H "Authorization: Bearer ps_live_placeholder_key"

GET

Account Bindings API

/accounts

查询已绑定账号、监控对象和平台授权状态。

platformstringtiktok / youtube / xiaohongshu / douyin

statusstringconnected / pending / expired

POST

Video Search API

/videos/search

按平台、关键词、账号、时间范围搜索视频数据。

Request Body

以下字段均为占位，后续可替换为真实筛选条件。

{
  "platforms": ["tiktok", "youtube", "xiaohongshu", "douyin"],
  "keyword": "placeholder",
  "date_range": {
    "from": "2026-05-01",
    "to": "2026-05-18"
  },
  "limit": 20
}

GET

Video Metrics API

/videos/{video_id}/metrics

获取单条视频的播放量、互动率、涨粉、完播和趋势分等标准化指标。

Response

{
  "video_id": "vid_placeholder",
  "platform": "tiktok",
  "views": 128000,
  "engagement_rate": 0.083,
  "completion_rate": 0.41,
  "trend_score": 87
}

GET

Trend Score API

/trends/{topic_id}/score

返回话题、关键词或视频集合的趋势评分和增长窗口。

GET

Comment List API

/comments

按视频、账号、关键词拉取评论列表，保留平台原始评论 ID。

POST

Sentiment Analysis API

/comments/sentiment

提交评论文本或评论 ID，返回情绪、意图和高频主题标签。

POST

Creator Search API

/creators/search

按平台、领域、粉丝量、互动率和增长速度检索达人。

GET

Creator Profile API

/creators/{creator_id}

获取达人基础画像、内容表现、受众标签和合作参考指标。

POST

Webhook Events

/webhooks/events

配置事件推送，用于爆款预警、趋势变化、账号异常和评论情绪波动。

GET

Export Tasks API

/exports/{task_id}

查询 CSV、JSON、数据仓库同步等导出任务状态。

Error Codes

400 INVALID_REQUEST 401 UNAUTHORIZED 429 RATE_LIMITED 500 INTERNAL_ERROR