ソーシャルデータ（ベータ）

/

GET /v1/social/{platform}/{capability} は、Douyin、Xiaohongshu、TikTok、YouTube などのソーシャルプラットフォームの公開データを返します。API キーと残高はモデル呼び出しと共通です。料金はプラットフォームと機能ごとに、成功した呼び出し 1 回単位で決まります。data はプラットフォーム自身のレスポンスそのままで、フィールドはプラットフォーム間で統一されていません。

GET /v1/social/{platform}/{capability} 
curl --get "https://api.chinaapi.ai/v1/social/tiktok/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=TikTok'

# HTTP 200
# {"object": "social.result", "platform": "tiktok", "capability": "search", "data": {...}}
ベータ：有料アカウント限定 呼び出す前に初回チャージを完了してください。トライアルクレジットはこれらのエンドポイントには使えません。一度もチャージしていないアカウントには HTTP 403 model_requires_topup が返ります。ベータ版には SLA がなく、対応プラットフォーム、エンドポイント、料金は変更される場合があります。

認証と課金

モデル呼び出しと同じく、ChinaAPI キーを bearer トークンとして https://api.chinaapi.ai に送ります。課金は HTTP 200 でデータが返った場合に限り、エンドポイントに表示された料金で 1 回だけ行われます。結果が空の場合、パラメータが拒否された場合、上流が失敗した場合は課金されません。ページを 1 つ取得するごとに別の呼び出しになります。利用履歴には、各呼び出しがエンドポイントに表示された名前（social-douyin-search など）で記録されます。

レスポンスとエラー

成功したレスポンスは、プラットフォームのデータを小さなエンベロープで包んで返します。data の中身（フィールド名、ページネーションカーソル、ID）はすべてプラットフォーム自身のものです。カーソルは受け取ったとおりにそのまま渡し返してください。

{
  "object": "social.result",
  "platform": "douyin",
  "capability": "search",
  "data": { "...": "the platform's own fields" }
}
  • 400 — パラメータが不明、重複、長すぎる、型が違う、または欠けている場合です。「いずれか 1 つ以上」のグループから 1 つも指定されていない場合も含みます。どれに当たるかはエラーの code（unknown_parameter や missing_parameter など）でわかります。
  • 403 model_requires_topup — このアカウントは初回チャージを完了していません。
  • 404 — そのプラットフォームと機能の組み合わせが存在しないか、プラットフォームがこのパラメータで何も見つけられませんでした（social_data_no_result）。
  • 429 social_data_capacity_reached — ベータの当日分の容量を使い切ったか（00:00 UTC にリセット）、プラットフォームが混雑しています。後者なら数秒後の再試行で通ります。間隔を空けずに再試行を繰り返さないでください。
  • 502 — データソースが応答しなかったか、データなしで応答しました。
  • 503 social_data_unavailable — このエンドポイントは現在一時停止中で、ライブカタログでは paused と表示されます。

これらのレスポンスはいずれも課金されません。

利用上の注意

各プラットフォームの規約と、あなたに適用されるデータ保護規則に従ってください。この API を個人のプロファイリングに使わないでください。ログイン、連絡先情報の抽出、エンゲージメントの操作、非公開または有料コンテンツへのアクセスは、このベータの対象外です。

プラットフォームと料金

成功した呼び出し 1 回あたりの USD 料金です。各料金は下のエンドポイントにリンクしており、ダッシュはそのプラットフォームがその機能を提供していないことを示します。いま販売中のもの（一時停止中のエンドポイントを含む）は、ライブカタログ GET https://dash.chinaapi.ai/api/social/catalog（キー不要）が正となります。

エンドポイント

パラメータはプラットフォーム自身の名前でクエリ文字列に入れます。例はカタログから取ったものです。識別子は取得したいコンテンツのものに置き換えてください。