투우차오 comments API
REST 호출 한 번으로 투우차오 comments 데이터를 조회 — 모든 플랫폼이 공유하는 안정적인 JSON 스키마로 정규화됩니다.
- 게시된 엔드포인트 1개
- GET /v1/toutiao/posts/{id}/comments
계약 요약(영어): List Toutiao article comments (capability toutiao.comments)
- 정규화된 응답 엔터티
- toutiao/comments
- capability
- toutiao.comments
모든 응답에는 신선도(cache / default / live)와 과금 메타데이터도 포함됩니다.
활용 사례
- 구조화된 {{platform}} 게시물(본문, 지표, 타임스탬프, 미디어 참조)로 콘텐츠 분석 파이프라인을 구동.
- 원본 콘텐츠와 참여 지표가 필요한 검수·리서치·모니터링 워크플로우를 지원합니다.
- 깨지기 쉬운 페이지 스크래핑 대신 안정적인 정규화 JSON으로 {{platform}} 콘텐츠를 아카이빙.
응답 필드
Toutiao toutiao.comments response (normalized envelope)
Response envelope of the /v1/toutiao toutiao.comments capability. Cursor is opaque and platform-independent; page size follows the request's `limit` parameter (1..100, default 20).
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| data | comment[] | 필수 | — |
| next_cursor | string | null | 필수 | Opaque pagination cursor; null when the list is exhausted. |
| meta.request_id | string | 필수 | — |
| meta.freshness.mode | cache | default | live | 필수 | — |
| meta.freshness.age_seconds | integer | null | 선택 | — |
| meta.freshness.source_layer | cache | db | upstream | 필수 | — |
| meta.freshness.stale | boolean | 선택 | — |
| meta.billing.cache_hit | boolean | 필수 | — |
| meta.billing.amount_credits | integer | 필수 | Credits actually charged for this request (the settlement unit; 1 credit = $0.0001, permanent). |
필드 비고는 계약 영문 원문으로 표시됩니다.
응답 메타데이터
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| mode | cache | default | live | 필수 | Effective mode after merging param > max_age > source policy (D-004). |
| age_seconds | integer | null | 선택 | Age of served data; null when unknown. |
| source_layer | cache | db | upstream | 필수 | Which layer served the response (PRD §10). |
| stale | boolean | 선택 | True when stale data was served under stale_if_error / SWR (D-004). |
| billing.amount_credits | integer | 필수 | Micro-USD (1e-6 USD) actually charged for this request. |
| billing.cache_hit | boolean | 필수 | — |
필드 비고는 계약 영문 원문으로 표시됩니다.
요청·응답 예시
/v1/toutiao/posts/{id}/commentscurl -H "Authorization: Bearer $MESHDATA_API_KEY" \
"https://api.fetchpi.com/v1/toutiao/posts/1842951234567890123/comments"{
"data": [
{
"id": "1821000000001001",
"platform": "toutiao",
"type": "comment",
"post_id": "1820000000001001",
"author": {
"id": "1567049500",
"username": "toutiaoreader",
"display_name": "头条读者",
"verified": false
},
"text": "文章数据口径讲得明白。",
"created_at": "2026-09-14T08:05:00Z",
"metrics": {
"likes": 18,
"replies": 1
},
"fetched_at": "2026-09-21T09:00:00Z"
}
],
"next_cursor": null,
"meta": {
"request_id": "req_01HTXQ8Z9HTQ",
"freshness": {
"mode": "default",
"age_seconds": 0,
"source_layer": "upstream",
"stale": false
},
"billing": {
"amount_credits": 200,
"cache_hit": false
}
}
}무료 데모
무료 계정을 만들고 API 키를 발급받으면 브라우저 Playground에서 바로 호출할 수 있습니다.
Playground에서 사용해 보기이 엔드포인트의 파라미터 표, 오류 코드, 응답 의미는 API 문서에 있습니다.
엔드포인트 레퍼런스 열기자주 묻는 질문
응답에는 어떤 콘텐츠 필드가 포함되나요?
정규화된 콘텐츠 엔터티(본문, 작성자, 타임스탬프, 참여 지표, 미디어 참조)를 아래 필드 표의 정의대로 반환하며, 신선도·과금 메타데이터가 함께 제공됩니다.
이 엔드포인트를 무료로 써볼 수 있나요?
네 — 계정을 등록하고 API 키를 발급받으면 콘솔의 Playground에서 호출할 수 있습니다.
comments 능력은 어떻게 과금되나요?
Data API는 요청 단위 크레딧 과금이며 cache/live 신선도에 따라 배율이 다릅니다. 현재 능력별 가격은 가격 페이지를 기준으로 합니다.
가격
요청 단위 크레딧 과금, cache/live 신선도 옵션 — 최신 가격은 가격 페이지 기준입니다.