Cross-platform · 投稿検索

ベータ

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

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

リクエストパラメータ

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

名前	タイプ	必須	サンプル	説明
`query`	string	はい	`"人工智能"`	Search terms; separate terms with spaces to require all of them. Put excluded words in exclude_words.
`platforms`	array	いいえ	`["weibo","douyin","toutiao","xiaohongshu","short_video","wechat","news","forum","long_video","app"]`	Only these platforms, all by default: weibo, douyin, toutiao, xiaohongshu, short_video (Kuaishou and other short-video apps), wechat (official accounts), news (news sites and newspapers), forum (forum Pass a JSON array in this query parameter.
`since`	string	いいえ	`—`	First day, YYYY-MM-DD (Beijing time, included); defaults to 6 days before until
`until`	string	いいえ	`—`	Last day, YYYY-MM-DD (Beijing time, included); defaults to today and cannot be later. since to until spans at most 90 days
`types`	array	いいえ	`["original","repost","comment"]`	Content types, all by default: original, repost, comment Pass a JSON array in this query parameter.
`sentiment`	array	いいえ	`["negative","neutral","positive"]`	Sentiment, all by default: negative, neutral, positive Pass a JSON array in this query parameter.
`match`	array	いいえ	`["title","content","author"]`	Where the search terms must match, title, content and author by default: title, content, author (author name), media_text (images and video frames), audio Pass a JSON array in this query parameter.
`exclude_words`	string	いいえ	`—`	Filter words; results that contain them are left out
`author`	string	いいえ	`—`	Only content published by this author (account name)
`page`	integer	いいえ	`1`	Page number, from 1, at most 50
`limit`	integer	いいえ	`20`	Results per page: 10 or 20

リクエスト例

curl --get "https://api.chinaapi.ai/v1/social/cross-platform/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'query=人工智能'

レスポンスの形

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

{
  "object": "social.result",
  "platform": "cross-platform",
  "capability": "search",
  "data": { … }
}

ページング

ページング用パラメータ：page。1 ページ取得するごとに別の課金対象の呼び出しになります。カーソル値は前回のレスポンスからそのまま渡してください。

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

ステータスコード	エラーコード	意味
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 を個人のプロファイリングに使わないでください。ログイン、連絡先情報の抽出、エンゲージメントの操作、非公開または有料コンテンツへのアクセスは、このベータの対象外です。

データ API のレート特典

有料アカウントは毎秒 10 リクエストから開始し、累計純利用額に応じて毎秒 100 リクエストまで自動的に増加します。

累計純利用額	毎秒のリクエスト数
有料アカウントの初期値	10/s
50 米ドル超	20/s
500 米ドル超	50/s
1500 米ドル超	100/s

集計対象はデータ API の精算済み料金から呼び出しの返金を差し引いた額です。チャージ額とモデル API の利用額は含みません。

同じアカウントのすべての API キーでこのレートを共有します。同時実行数ではなく、毎秒のリクエスト数です。

供給元の各エンドポイントには別の容量制限があり、実際に利用できるスループットにも影響します。

より高いレートが必要な場合は、[email protected] までメールでお問い合わせください。