> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Social Data 카탈로그

카탈로그에는 **호출 가능한 액션 1021개**가 있습니다. 플랫폼별로 고른 다음 `POST /v1/social-data/call`에 액션 ID를 사용하세요.

[기계 판독용 카탈로그 내려받기](https://beatapi.io/social-data-catalog.json) · [MCP 도구 매니페스트](https://beatapi.io/capabilities-mcp-tools.json)

## 플랫폼

| 플랫폼               |  액션 |
| ----------------- | --: |
| `douyin`          | 317 |
| `tiktok`          | 164 |
| `instagram`       |  93 |
| `bilibili`        |  87 |
| `weibo`           |  56 |
| `xiaohongshu`     |  44 |
| `zhihu`           |  41 |
| `kuaishou`        |  38 |
| `youtube`         |  33 |
| `twitter`         |  25 |
| `reddit`          |  24 |
| `pipixia`         |  17 |
| `lemon8`          |  16 |
| `wechat_channels` |  12 |
| `wechat_mp`       |  11 |
| `threads`         |   9 |
| `linkedin`        |   8 |
| `xigua`           |   7 |
| `toutiao`         |   7 |
| `telegram`        |   7 |
| `wechat_search`   |   2 |
| `hybrid`          |   1 |
| `creator`         |   2 |

## 예시

```bash
curl https://api.beatapi.io/v1/social-data/call \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"douyin.web.fetch_one_video","params":{"aweme_id":"7364837462110"}}'
```

각 카탈로그 항목에는 `id`, `platform`, `method`, `input_schema`가 있습니다. POST 액션의 `params`는 JSON 객체이고, GET 액션의 값은 스칼라여야 합니다.

카탈로그의 `method`는 선택한 액션을 설명하며 공개 REST 엔드포인트가 아닙니다. 위의 직접 호출은 모두 `POST /v1/social-data/call`을 사용합니다. 새 요청에는 `model` 필드를 보내지 마세요.

이 정적 카탈로그는 입력을 문서화하며, 액션별 출력 형식이나 가격은 공개하지 않습니다. Search가 반환한 `data:<action-id>` 레퍼런스로 [Capabilities Inspect](/capabilities)를 호출해 현재 `output_schema`, 준비 상태, 가격을 확인하세요. `runnable` 액션은 공개된 출력 형식이 없으므로, 고정된 구조를 가정하지 말고 응답에서 필드를 읽으세요.