当社独自のアクセス統計は常に有効です。Google Analyticsは、公開ページ(ログイン後のワークスペースは対象外)の利用状況を把握するためのもので、許可をいただいた場合のみ有効になります。詳しくは プライバシーポリシーをご覧ください。

WeChat公式アカウント記事検索API

ピーク時は一時的に利用できない場合があります

この機能はピーク時に一時的に利用できない場合があります。時間をおいて再度お試しください。失敗した呼び出しには課金されません。

POST

APIの稼働状況

24時間の稼働状況
正常
24時間の平均応答時間
—
  • 良好/正常
  • 利用可能
  • 制限あり
  • ほぼ停止
正常

英語のドキュメントが用意されたAPIを通じて、キーワードからWeChat公式アカウントの記事を検索します。1回の呼び出しで最大400件まで取得でき、各記事にはタイトル、要約、カバー画像、アカウント名、公開日時が含まれます。WeChatアカウントは不要です。記事の全文は含まれません。個人のWeChatログイン情報は渡さないため、categoryのフォロー中および最近読んだ記事のセクションは保証されません。

WeChat公式アカウント記事検索は、keywordで公開されているWeChat公式アカウントの記事を検索し、各記事のタイトル、概要、リンク、カバー画像、アカウント名、公開日時を返します。あるテーマを扱っている記事とその書き手を把握するのに使えます。業界ニュースのモニタリング、世論の収集、提携先アカウントの発掘、トピックライブラリの構築などに適しています。

categoryでセクションを選択します(ALL、LATEST、HOT)。FOLLOWEDとRECENT_READは個人のサインインに依存しますが、ここではWeChatのサインイン情報を渡さないため動作は保証されず、ご自身のフォローや閲覧履歴を読み取ることもありません。posted_atは標準のタイムスタンプ、relative_timeはWeChatの表示どおりの相対表現なので、並べ替えには前者を使用してください。記事全文はurlを開いて確認できます。

料金は1,000リクエストあたり$8(1回あたり$0.008)です。失敗した呼び出しと空の結果には課金されません。 同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。

AIプロンプト

EveryInfraのWeChat公式アカウント 記事検索エンドポイント(wechat_oa/article_search)を使ったデータ収集スクリプトの作成を手伝ってください。

エンドポイントの仕組み:
- リクエスト:ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにwechat_oa、actionにarticle_searchを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ:
  - keyword: WeChat公式アカウントの各アクションで使う検索キーワードを指定します。記事検索(article_search)、アカウント検索(account_search)、ミニプログラム検索(mini_program_search)、検索候補(search_suggestions)、トレンド指数(wechat_index)で使用します。個人のWeChatチャットは検索しません。
- 任意パラメータ:
  - category: article_searchアクションで記事をカテゴリで絞り込みます。指定できる値はALL、LATEST、HOT、FOLLOWED、RECENT_READです。FOLLOWEDとRECENT_READはアカウントの状態に依存します。個人のWeChatログインセッションは渡されないため、これらのオプションが機能する保証はなく、個人の購読情報や閲覧履歴は読み取られません。
  - sub_type: article_searchにおけるcategoryの互換エイリアスで、同じ5つのカテゴリ値を受け付けます(自動的に大文字に変換されます)。categoryとsub_typeの両方を指定した場合は、categoryが優先されます。
  - limit: この呼び出しで返す最大行数で、1〜400の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。(デフォルト:20)
- レコードのリストを返します。各レコードの主なフィールド: id、title、summary(検索結果に表示される記事の要約です)、url、cover_image_url(記事のカバー画像URLです)、account_name(記事を公開した公式アカウント名です)、posted_at、relative_time(WeChatに表示されるとおりの相対時間(例:3日前)です)、kind(WeChatが表示する結果種別です).
- リクエストボディの例:
{
  "platform": "wechat_oa",
  "action": "article_search",
  "params": {
    "keyword": "城市更新"
  }
}
- 料金:1,000リクエストあたり$8。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。

コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。

リクエストパラメータ

名前場所型必須デフォルト説明
Authorizationheaderstringはい-Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
platformbodystringはいwechat_oaプラットフォームの識別子です。値は固定です。
actionbodystringはいarticle_search機能の識別子です。値は固定です。
keywordbody.paramsstringはい-WeChat公式アカウントの各アクションで使う検索キーワードを指定します。記事検索(article_search)、アカウント検索(account_search)、ミニプログラム検索(mini_program_search)、検索候補(search_suggestions)、トレンド指数(wechat_index)で使用します。個人のWeChatチャットは検索しません。
categorybody.paramsstringいいえ-article_searchアクションで記事をカテゴリで絞り込みます。指定できる値はALL、LATEST、HOT、FOLLOWED、RECENT_READです。FOLLOWEDとRECENT_READはアカウントの状態に依存します。個人のWeChatログインセッションは渡されないため、これらのオプションが機能する保証はなく、個人の購読情報や閲覧履歴は読み取られません。
sub_typebody.paramsstringいいえ-article_searchにおけるcategoryの互換エイリアスで、同じ5つのカテゴリ値を受け付けます(自動的に大文字に変換されます)。categoryとsub_typeの両方を指定した場合は、categoryが優先されます。
limitbody.paramsinteger (1–400)いいえ20この呼び出しで返す最大行数で、1〜400の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。

コードサンプル

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "wechat_oa",
  "action": "article_search",
  "params": {
    "keyword": "城市更新"
  }
}'

OpenAPI定義(JSON)サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。

レスポンス例

実際のレスポンス

October 24, 2026 at 18:28(UTC)に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報(名前、ハンドル、アバター、プロフィールリンク、連絡先)を削除したものです。リストは先頭の2件のみ掲載しています。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。

json
{
  "id": "req_…",
  "platform": "wechat_oa",
  "action": "article_search",
  "results": [
    {
      "title": "城市更新的八大类型及典型案例分析(含城市更新专题)",
      "summary": "城市更新涉及范围广、主体多、建设任务纷繁复杂.中共中央办公厅、国务院办公厅《关于持续推进城市更新行动的意见》,将城市更...",
      "url": "https://mp.weixin.qq.com/s?src=11&timestamp=1792868283&ver=7046&signature=*kBvA0oukPYHXfmpZWB8cGEugO6pKS0z0G92kHumYr3SO2wiEAGXPgRFIhHBwGjs86NVY6sKC3E-0*IaVBC8XRM3Qb3zBoeF2nH4x6l0S8JKbSmgSBy6PlE2GXzT9uOi&new=1",
      "cover_image_url": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/C4sz9kVVx1mva20LCAFC8cTARSIAFo3sBiaEuRhDD1d5n5YCHbZiajFd7eRR5DNE00zpn4f1fWB7IVsrO3WRbM9V7IEHweQautrnpxprcnIvE/0?wx_fmt=jpeg",
      "platform": "wechat_oa"
    },
    {
      "title": "李迎伟主持研究城市更新工作",
      "summary": "李迎伟主持研究城市更新工作提标提速推动城市更新试点任务努力打造具有江汉平原特色的现代化人民城市10月24日,市委书记李迎伟...",
      "url": "https://mp.weixin.qq.com/s?src=11&timestamp=1792868283&ver=7046&signature=gzDMFycW6XM4lIXPZ4-qV6LZtQ9JRqDobvYNMGB*W72r5GzoRJTTcH4Y6VZ80RU45fRbEl*bLgZQ548peOPI59SvamTDpdthJzT4BoTP2ueI5lt1ZdS788YtogIxWaYc&new=1",
      "cover_image_url": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/6UUD1kjmksibLZqt2kgvS0BGYyGIeqzTBOnCiceTicp8BL2OM0SUCwIWcs0fWnPB30CpBeCngicRejeK6T3o0tb8pjOKrO3xkYKl1dMKOcNTUs8/0?wx_fmt=jpeg",
      "platform": "wechat_oa"
    }
  ],
  "count": 18,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

レスポンスフィールド

業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。

フィールド意味
idプラットフォーム上でのレコードの一意なIDです。一意性は1つのプラットフォーム内に限られ、プラットフォームが異なるとIDが重複する場合があります。
titleタイトルです。プラットフォームにタイトルがない場合(テキストのみの投稿など)はnullになります。
summary検索結果に表示される記事の要約です。
urlプラットフォーム上のレコードへのリンクです。
cover_image_url記事のカバー画像URLです。
account_name記事を公開した公式アカウント名です。
posted_at投稿日時です。ISO 8601形式のUTCで返されます(例:2026-08-07T12:34:56+00:00)。プラットフォームから非標準の文字列が返された場合はそのまま渡されるため、パース処理は堅牢に実装してください。nullはプラットフォームが公開していないことを示します。
relative_timeWeChatに表示されるとおりの相対時間(例:3日前)です。並べ替えにはposted_atを使用してください。
kindWeChatが表示する結果種別です。
platform取得元プラットフォームの識別子で、リクエストのplatformと同じです(例:xiaohongshu、tiktok)。

FAQ

どのcategoryを使えばよいですか?

ほとんどの用途はALL、LATEST、HOTで対応できます。FOLLOWEDとRECENT_READは個人のWeChatサインインに依存しますが、ここではサインイン情報を渡さないため、動作は保証されません。sub_typeは同じ設定の旧名称で、両方を送信した場合はcategoryが優先されます。

WeChat内での検索と同じですか?

検索対象は公式アカウントの記事で、個人のチャットやモーメンツは含まれません。また、ご自身のフォローや閲覧履歴を読み取ることもありません。結果の順序は選択したセクションによって決まり、ご自身のスマートフォンで検索した場合と異なることがあります。

結果のurlをコメント取得や指標取得の機能に渡せますか?

必ずしも渡せるとは限りません。検索結果の多くは署名とタイムスタンプのパラメータを含む一時リンクで、記事のコメント、返信、指標を取得する機能はこれを読み取れない場合、課金前に422を返します。ブラウザで記事を開き、記事自体のリンク、/s/形式の短縮リンク、または__biz、mid、idx、snを含むリンクをコピーして渡してください。

エラーと課金

401
キーが未指定か無効です。
402
残高が不足しています。先にチャージしてください。
422
パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
429
1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
503
処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
200(空)
データがありません。課金はされません。

エラー