WeChat Search · 投稿検索

ベータ

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

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

リクエストパラメータ

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

名前	タイプ	必須	サンプル	説明
`keyword`	string	はい	`"人民日报"`	Search keyword (1-100 chars)
`business_type`	string	いいえ	`"account"`	Search category. Tested categories with results: all, account, article, video, sticker. Other categories may return no data.
`sort`	integer	いいえ	`"hot"`	Sort (result page 'sort' dropdown, common to all verticals): default/0 (relevance) / latest/1 (newest) / hot/2
`publish_time`	integer	いいえ	`"week"`	Publish time (result page 'time' dropdown, common): all/0 / day/1 / week/2 / half_year/3; string key or integer
`offset`	integer	いいえ	`0`	Pass 0 for the first page; use cursor to paginate (offset alone does not work — it returns the first page every time)
`cursor`	string	いいえ	`—`	Pagination cursor: leave empty for the first page; for the next page pass back the cursor returned in the previous response
`raw`	boolean	いいえ	`true`	True=raw search response; False=simplified parsed structure

リクエスト例

curl --get "https://api.chinaapi.ai/v1/social/wechat-search/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=人民日报'

レスポンスの形

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

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

ページング

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