Pipixia · トレンド

ベータ

ソーシャルプラットフォームの公開データを呼び出しごとの課金で取得できます。API キーと残高はモデル呼び出しと共通です。

初回チャージ済みのアカウント限定。無料トライアルはありません · HTTP 200 で data が空でない場合にのみ 1 回分を課金します。結果が空の場合、パラメータが拒否された場合、上流が失敗した場合は課金されません。

リクエストパラメータ

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

このエンドポイントにはパラメータがありません。

リクエスト例

curl --get "https://api.chinaapi.ai/v1/social/pipixia/trending" \
  -H "Authorization: Bearer $CHINAAPI_KEY"

レスポンスの形

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

{
  "object": "social.result",
  "platform": "pipixia",
  "capability": "trending",
  "data": { … }
}

ページング

このエンドポイントにはページング用パラメータがありません。

エラーと課金されないケース

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

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

すべてのレスポンスに X-Oneapi-Request-Id ヘッダーが付きます。サポートへの問い合わせ時に添えていただければ、その呼び出しを特定できます。

ベータ版の条件

呼び出す前に初回チャージを完了してください。トライアルクレジットはこれらのエンドポイントには使えません。一度もチャージしていないアカウントには HTTP 403 model_requires_topup が返ります。ベータ版には SLA がなく、対応プラットフォーム、エンドポイント、料金は変更される場合があります。

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