更新情報新機能

検索結果とRedditが加わりました

Search results
Playground に並べた Google Search の結果と Reddit の投稿

Google、Bing、Naverの検索結果とRedditの議論を、AI回答と同じAPIでJSONとして受け取れます。

得られる結果

  • GOOGLE_SERP: 順位、タイトル、リンク、スニペット付きの自然検索結果と、関連する質問、関連検索、広告です。pageを1〜10で指定すると後続ページも取得できます。
  • BING_SEARCH: Bingの検索結果と、Bingが結果の上に書くAI要約を出典付きでaioverviewに受け取れます。
  • NAVER_SERP: NaverのWeb文書をページごとに15件取得し、pageは1〜10です。
  • REDDIT: 投稿の検索、コメント付きの投稿1件、サブレディットの最新投稿を取得できます。

仕組み

AIエンジンはWebから回答を組み立てるため、検索で上位に入るページや人々がRedditに書き込む投稿は、AIでの露出を左右する材料です。これらのエンジンは、そのデータをいつもと同じ流れで届けます。同じリクエスト、同じwebhook、同じJSON形式です。

順位はページをまたいで数えるため、Googleの2ページ目の最初の結果は11位です。タスクごとに、収集時点の実際の結果を読み取ります。

活用例

  • 同じクエリで、検索上位のサイトとAI回答に引用されるサイトを比較できます。
  • 自社カテゴリーで評判を形づくるRedditの投稿を追えます。

リクエストを送る

API キーを Authorization ヘッダーに入れてリクエストを送ります。

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GOOGLE_SERP",
    "payload": {
      "query": "best project management software for small teams",
      "country": "US"
    }
  }'

BING_SEARCH と NAVER_SERP も、payload に query を入れて同じ方法で送ります。

リクエストのフィールド

taskTypestring必須
実行するエンジン。CHATGPT や GOOGLE などを指定します。
payload.querystring必須
ユーザーが検索ボックスに入力するとおりに書いた検索クエリ。
payload.countrystring
質問する市場の2文字の国コード。US、KR、JP など。既定値は US。
payload.pageinteger
読む結果ページ。1〜10、既定値は1。position はページをまたいで続けて数えます。
webhook.urlstring
サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。
idempotencyKeystring
リクエストに付ける独自の ID。1つのキーはアカウント内で1つのタスクを作るため、再送してもタスクは1つのままです。

レスポンス

完了したタスクはこの形で届きます。長さを抑えて抜粋しています。

JSON
{
  "success": true,
  "task": {
    "id": "323287e6-d4ef-4797-a337-f6c3b574b7ab",
    "taskType": "GOOGLE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:45:07.237Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "page": 1,
    "organicResults": [
      {
        "position": 1,
        "title": "8 Easy-to-Use Project Management Software Platforms for ...",
        "link": "https://ones.com/blog/8-easy-to-use-project-management-software-platforms-for-small-teams/?primary_category=knowledge",
        "snippet": "1 day ago — ONES.com came out on top for teams that need Jira-like power without the complexity, while Trello and Asana hold their ground for basic, visual ...",
        "page": 1
      }
    ],
    "peopleAlsoAsk": [
      { "question": "Does Microsoft Teams have a project management tool?" },
      {
        "question": "What is the best project management software for a small construction company?"
      }
    ]
  }
}
task.statusstring
QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。
credits.creditsChargedinteger
完了したタスクに請求されたクレジット。失敗したタスクは0です。
response.organicResultsarray
ページの検索結果。position、title、link、snippet、page。
response.peopleAlsoAskarray
Google がページに表示した関連する質問。

Reddit を検索

REDDIT に query を送ると投稿を探し、subreddit を加えると1つのコミュニティの中で探します。投稿の url を送ると、その投稿とコメントの最初のページを読みます。

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "REDDIT",
    "payload": {
      "query": "best mechanical keyboard for programming",
      "country": "US"
    }
  }'

完了したタスクはこの形で届きます。長さを抑えて抜粋しています。

JSON
{
  "success": true,
  "task": {
    "id": "fe0a46a2-7bf1-4cd0-8183-d299dc421c70",
    "taskType": "REDDIT",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:47:44.384Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "results": [
      {
        "url": "https://www.reddit.com/r/MechanicalKeyboardsUK/comments/1qz6da6/best_silent_mechanical_keyboard_for_programming/",
        "title": "Best silent mechanical keyboard for programming?",
        "postId": "1qz6da6",
        "preview": "I currently have a mechanical keyboard but I often wake up in the middle of the night and it is quite loud so I can't use my computer because …",
        "subreddit": "MechanicalKeyboardsUK"
      }
    ]
  }
}
payload.subredditstring
1つのサブレディット内を検索します。r/ の後ろの名前を指定します。
payload.urlstring
投稿のアドレス https://www.reddit.com/r/{subreddit}/comments/{postId}/…。投稿本文とコメントの最初のページを読みます。
payload.commentSortstring
コメントの並び順。top（既定）、new、controversial、old、qa。
response.resultsarray
検索に一致した投稿。postId、title、url、subreddit、preview。
response.postobject
投稿の url を送った場合の、投稿のタイトル、本文、投稿者、スコア、コメント数。
response.commentsobject
コメントの最初のページ、約20〜25件。投稿者、本文、スコア、階層。

結果を受け取る

リクエストすると status が QUEUED のタスクがすぐに返ります。status が COMPLETED か FAILED になるまで GET /v1/async/task/{id} で取得するか、webhook.url を指定して同じ task、credits、response をサーバーで受け取ります。結果はタスクの完了から24時間取得できます。

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

料金

完了したタスク1件につき1クレジットを使用します。

ほかの更新

最新情報を受け取る

製品の更新をメールでお届けします。

RSS フィード