検索結果ページのすべてを構造化データで
4つのエンドポイントを持つ1つのREST API。認証方式、レスポンス形式、クレジット体系はすべて共通です。
GET /api/v1/search
タイトル、URL、表示リンク、スニペット、ソース、日付を含むオーガニック結果。1回の呼び出しで最大100件、関連検索も取得できます。
GET /api/v1/images
元画像URL、サムネイル、掲載元ページ、ピクセルサイズを1回の呼び出しで最大150件。
GET /api/v1/autocomplete
任意の入力に対するリアルタイムの検索候補を、指定した言語・市場で取得。
GET /api/v1/rank
キーワードとドメインを渡すと、上位100位以内の順位と、そのドメインでランクインしているすべてのURLを返します。
ターゲティングとページネーション
市場、言語、取得件数、鮮度をリクエストごとに指定できます。
| q | 検索クエリ（最大400文字）。引用符やsite:などの演算子も使えます。 |
| gl | 2文字の国コード。デフォルトはUS。 |
| hl | インターフェースと結果の言語。デフォルトはその国の主要言語。 |
| num | 1回あたりの結果数（10〜100）。10件ごとに1クレジット消費します。 |
| page | 結果をページ送りするためのページ番号。 |
| time | 期間フィルター: 過去1日、1週間、1か月、1年。 |
レスポンスフィールド
各オーガニック結果に含まれる項目:
organic_results[0]
{
"position": 1,
"title": "The 15 Best Running Shoes of 2026, Tested by Runner’s World",
"link": "https://www.runnersworld.com/gear/a19663621/best-running-shoes/",
"displayed_link": "https://www.runnersworld.com › gear › best-running-shoes",
"source": "runnersworld.com",
"snippet": "Find the best running shoes of 2026, including Runner’s World-tested picks from Adidas, Brooks, New Balance, Nike, …",
"date": "Aug 3, 2026"
}信頼性を標準装備
- 検索エンジンは自動化されたトラフィックに対し、エラーではなく無関係な結果を返すことがあります。serpfastはすべてのページの関連性をチェックし、お届けする前に再試行します。
- 上流で失敗したリクエストは自動で返還され、明確なエラーコードとともに記録されます。
- レート制限はAPIキー単位のため、1つの連携が混雑しても他の連携が遅くなることはありません。