SerpBase

API リファレンス · 検索エンジン

Google リンク解決

無料：Google 結果の google.com/goto・/url ラップリンクを実際のページ URL に変換します。1 回最大 50 件、リンクの一覧でも検索結果そのままでも送れます。

POSThttps://api.serpbase.dev/google/resolve
0 クレジットPlayground で実行

例

BASH
curl -X POST 'https://api.serpbase.dev/google/resolve' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  --max-time 60 \
  -d '{"links":["https://www.google.com/url?sa=t&url=https%3A%2F%2Fwww.example.com%2F"]}'

このエンドポイントの実際の応答例はまだ公開していません。Playground で例を実行すると実際の応答を確認できます。

パラメーター

links
string[]
Google の結果リンク（https://www.google.com/goto?...
詳細

または /url?...）を最大 50 件。それ以外は拒否されます。重複は 1 回だけ解決します。

response
object
links の代わりに、返ってきた検索結果をそのまま送れます。
詳細

含まれる Google のリンクを出現順にすべて解決します。links と response はどちらか一方。

country
string
locale.country: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

cursor
string
pagination.cursor: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

device
string
options.device: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

gl
string
locale.country: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

google_domain
string
locale.engine_domain: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

gooogle_domain
string
locale.engine_domain: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

hl
string
locale.language: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

html
boolean
include_html: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

language
string
locale.language: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

limit
integer
pagination.limit: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

markdown
boolean
include_markdown: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

mobile
boolean
options.device: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

num
integer
pagination.limit: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

page
integer
pagination.page: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

q
string
query: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

results
integer
pagination.limit: 別名は一度に一方だけを使います。
詳細

API は対応パラメーターと値を検証します。

無料（0 クレジット）。上限：1 回 50 リンク、アカウントごとに毎分 30 回。Google がこれらのリンクを制限するため、1 回の処理に最大約 25 秒かかることがあります。終わらなかったリンクは reason が paced_over_budget になります。約 2 分後に再送してください。早く送ると Google の待ち時間が長くなります。

返るフィールド

そのリクエストのページにない内容のフィールドは、空で返さず省略されます。

resolved_links
必須
ResolvedLink[]

必須

リンクごとに 1 件、リクエストの順番で返ります。

ResolvedLink 結果アイテム構造

link
必須
string

必須

送信した Google リンク。

url
任意
string

解決できた場合。

リンク先のページ。今回解決できなかった場合は含まれません。

reason
必須
string

必須

resolved、または失敗理由：paced_over_budget（Google の待ち時間が 1 回のリクエストの上限を超えたため、約 2 分後に再送してください。早すぎる再送は避けてください）、challenge、no_location、timeout、not_a_wrapper、error。

失敗したとき

失敗したリクエストは status が 0 以外で error が付き、課金されません。よくあるもの：

1000パラメーターが不足または誤りリクエストを修正
1020クレジット不足チャージ
1029毎秒リクエスト数の超過Retry-After 秒待つ
1502 · 1504今回は取得元を読み取れなかった再試行
すべてのステータスコード →