시과 비디오 post API

REST 호출 한 번으로 시과 비디오 post 데이터를 조회 — 모든 플랫폼이 공유하는 안정적인 JSON 스키마로 정규화됩니다.

게시된 엔드포인트 1개
GET /v1/xigua/posts/{id}

계약 요약(영어): Get a normalized Xigua video (capability xigua.post)

정규화된 응답 엔터티: xigua/post
capability: xigua.post

모든 응답에는 신선도(cache / default / live)와 과금 메타데이터도 포함됩니다.

활용 사례

구조화된 {{platform}} 게시물(본문, 지표, 타임스탬프, 미디어 참조)로 콘텐츠 분석 파이프라인을 구동.
원본 콘텐츠와 참여 지표가 필요한 검수·리서치·모니터링 워크플로우를 지원합니다.
깨지기 쉬운 페이지 스크래핑 대신 안정적인 정규화 JSON으로 {{platform}} 콘텐츠를 아카이빙.

응답 필드

Xigua Video Post (normalized)

Normalized Xigua Video post — the ONLY upper-layer format; provider-private fields are dropped. Serves xigua.post and the post lists of /v1/xigua.

필드	타입	필수	설명
id	string	필수	Platform-native post id (aweme_id/photo_id/item_id/group_id per platform).
platform	"xigua"	필수	—
type	"post"	필수	—
author.id	string	필수	Author platform id.
author.username	string	필수	Author addressing key without leading @.
author.display_name	string \| null	필수	Author display name.
author.verified	boolean	필수	—
title	string \| null	선택	Post title (the platform carries titles beside the text).
text	string \| null	필수	Post text (desc/caption/content; null for media-only posts).
created_at	string	필수	Post publish time, UTC RFC3339.
metrics.likes	integer	필수	Like count.
metrics.comments	integer	필수	Comment count.
metrics.shares	integer	필수	Share count.
metrics.views	integer	필수	Play/view count.
attachments	object[]	선택	Media attachments (max 8): photo urls and/or the video block.
fetched_at	string	필수	Normalization time of the stored snapshot (UTC).

필드 비고는 계약 영문 원문으로 표시됩니다.

응답 메타데이터

필드	타입	필수	설명
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	필수	—

필드 비고는 계약 영문 원문으로 표시됩니다.

요청·응답 예시

GET/v1/xigua/posts/{id}

curl -H "Authorization: Bearer $MESHDATA_API_KEY" \
  "https://api.fetchpi.com/v1/xigua/posts/1842951234567890123"

{
  "data": {
    "id": "7413050000000001001",
    "platform": "xigua",
    "type": "post",
    "author": {
      "id": "7004994945115",
      "username": "meshdata_xigua",
      "display_name": "MeshData 西瓜号",
      "verified": false
    },
    "title": "西瓜视频：一条中视频",
    "text": "中视频格式的数据 API 演示。",
    "created_at": "2026-09-15T08:30:00Z",
    "metrics": {
      "likes": 5120,
      "comments": 320,
      "shares": 140,
      "views": 880000
    },
    "attachments": [
      {
        "type": "video",
        "preview_image_url": "https://cdn.example.com/cover/xigua-7413050000000001001.jpeg",
        "duration_ms": 732000
      }
    ],
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

무료 데모

무료 계정을 만들고 API 키를 발급받으면 브라우저 Playground에서 바로 호출할 수 있습니다.

Playground에서 사용해 보기

이 엔드포인트의 파라미터 표, 오류 코드, 응답 의미는 API 문서에 있습니다.

엔드포인트 레퍼런스 열기

자주 묻는 질문

응답에는 어떤 콘텐츠 필드가 포함되나요?

정규화된 콘텐츠 엔터티(본문, 작성자, 타임스탬프, 참여 지표, 미디어 참조)를 아래 필드 표의 정의대로 반환하며, 신선도·과금 메타데이터가 함께 제공됩니다.

이 엔드포인트를 무료로 써볼 수 있나요?

네 — 계정을 등록하고 API 키를 발급받으면 콘솔의 Playground에서 호출할 수 있습니다.

post 능력은 어떻게 과금되나요?

Data API는 요청 단위 크레딧 과금이며 cache/live 신선도에 따라 배율이 다릅니다. 현재 능력별 가격은 가격 페이지를 기준으로 합니다.

가격

요청 단위 크레딧 과금, cache/live 신선도 옵션 — 최신 가격은 가격 페이지 기준입니다.

가격 보기 모든 API 둘러보기