Google Images Search — API リファレンス

POST

利用可能

/google/image/search

画像検索

Google 画像と参照リンクを検索します。リンクの取得は画像の利用権を付与しません。

type

images

result

images

課金

1 credits

Google 画像と参照リンクを検索します。リンクの取得は画像の利用権を付与しません。

パラメータ

フィールド型出現条件説明

q

必須

string

必須

検索クエリ文字列。

hl

任意

string

任意

言語コード。デフォルトは en。

gl

任意

string

任意

国コード。デフォルトは us。

page

任意

number

任意

1 始まりのページ番号。デフォルトは 1。

query

例

string

カタログの例。必須項目は API が検証します。

例: "red pandas"

json

{
  "query": "red pandas"
}

Playground で実行

レスポンスフィールド

フィールド型出現条件説明

query

必須

string

必須

リクエストから正規化されたクエリ。

page

必須

number

必須

現在の 1 始まりのページ番号。

images

任意

ImageResult[]

画像結果が解析された場合。

Google 画像検索結果。

ImageResult 結果アイテム構造

フィールド型出現条件説明

rank

必須

number

必須

このレスポンス内の 1 始まりの順位。

position

任意

number

利用可能な場合は rank のエイリアス。

position を期待するクライアント向けの正規化順位。

title

任意

string

画像タイトルまたは alt テキストを解析できる場合。

結果タイトル。

link

必須

string

必須

parser が返す主リンク。

url

任意

string

結果リンクを正規化できる場合に返ります。

正規化されたターゲット URL。通常は link と同じです。

source_url

任意

string

Google のリダイレクト元 URL がある場合のみ返ります。

デバッグと出所確認のために保持される元の Google URL。

display_url

任意

string

Google の表示テキストまたはドメインを取得できる場合。

表示 URL またはソースドメイン。

image_url

必須

string

必須

元画像の URL。

thumbnail_url

任意

string

Google がサムネイルを公開している場合。

サムネイル URL。

thumbnail

任意

string

利用可能な場合は thumbnail_url のエイリアス。

正規化されたサムネイルエイリアス。

source

任意

string

出典テキストが解析された場合。

画像の出典ラベル。

domain

任意

string

出典ページのドメインを導出できる場合。

出典ページのドメイン。

コードとレスポンスの例

bash

curl -X POST 'https://api.serpbase.dev/google/image/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"red pandas"}'

既存の Google リクエスト例

bash

curl -X POST https://api.serpbase.dev/google/image/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "iphone 15 pro blue",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'

注記

ビジュアル検索、商品監視、画像ソース発見。

Google 画像の一部形式には rank/link だけがあり、すべての別名はありません。url、display_url、source_url、position、thumbnail は任意項目として扱ってください。