Google Images Light Search

curl --request POST \
  --url https://api.aisa.one/apis/v1/serpapi/search-google-images-light \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "q": "coffee"
}'

import requests

url = "https://api.aisa.one/apis/v1/serpapi/search-google-images-light"

payload = { "q": "coffee" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({q: 'coffee'})
};

fetch('https://api.aisa.one/apis/v1/serpapi/search-google-images-light', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/serpapi/search-google-images-light",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'q' => 'coffee'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/serpapi/search-google-images-light"

	payload := strings.NewReader("{\n  \"q\": \"coffee\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/serpapi/search-google-images-light")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"q\": \"coffee\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/serpapi/search-google-images-light")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"q\": \"coffee\"\n}"

response = http.request(request)
puts response.read_body

{
  "images_results": [
    {
      "link": "<string>",
      "title": "<string>",
      "source": "<string>",
      "in_stock": true,
      "original": "<string>",
      "position": 123,
      "raw_link": "<string>",
      "thumbnail": "<string>",
      "is_product": true,
      "source_logo": "<string>",
      "original_width": 123,
      "original_height": 123,
      "serpapi_thumbnail": "<string>",
      "related_content_id": "<string>",
      "license_details_url": "<string>",
      "serpapi_related_content_link": "<string>"
    }
  ],
  "search_metadata": {
    "id": "<string>",
    "error": "<string>",
    "status": "<string>",
    "created_at": "<string>",
    "processed_at": "<string>",
    "json_endpoint": "<string>",
    "raw_html_file": "<string>",
    "total_time_taken": 123,
    "google_images_light_url": "<string>"
  },
  "search_parameters": {
    "q": "<string>",
    "gl": "<string>",
    "hl": "<string>",
    "device": "<string>",
    "engine": "<string>",
    "google_domain": "<string>"
  },
  "search_information": {
    "image_results_state": "<string>"
  },
  "serpapi_pagination": {
    "next": "<string>",
    "current": 123,
    "previous": "<string>"
  }
}

POST

https://api.aisa.one

apis

serpapi

search-google-images-light

Google Images Light Search

curl --request POST \
  --url https://api.aisa.one/apis/v1/serpapi/search-google-images-light \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "q": "coffee"
}'

import requests

url = "https://api.aisa.one/apis/v1/serpapi/search-google-images-light"

payload = { "q": "coffee" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({q: 'coffee'})
};

fetch('https://api.aisa.one/apis/v1/serpapi/search-google-images-light', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/serpapi/search-google-images-light",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'q' => 'coffee'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/serpapi/search-google-images-light"

	payload := strings.NewReader("{\n  \"q\": \"coffee\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/serpapi/search-google-images-light")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"q\": \"coffee\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/serpapi/search-google-images-light")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"q\": \"coffee\"\n}"

response = http.request(request)
puts response.read_body

{
  "images_results": [
    {
      "link": "<string>",
      "title": "<string>",
      "source": "<string>",
      "in_stock": true,
      "original": "<string>",
      "position": 123,
      "raw_link": "<string>",
      "thumbnail": "<string>",
      "is_product": true,
      "source_logo": "<string>",
      "original_width": 123,
      "original_height": 123,
      "serpapi_thumbnail": "<string>",
      "related_content_id": "<string>",
      "license_details_url": "<string>",
      "serpapi_related_content_link": "<string>"
    }
  ],
  "search_metadata": {
    "id": "<string>",
    "error": "<string>",
    "status": "<string>",
    "created_at": "<string>",
    "processed_at": "<string>",
    "json_endpoint": "<string>",
    "raw_html_file": "<string>",
    "total_time_taken": 123,
    "google_images_light_url": "<string>"
  },
  "search_parameters": {
    "q": "<string>",
    "gl": "<string>",
    "hl": "<string>",
    "device": "<string>",
    "engine": "<string>",
    "google_domain": "<string>"
  },
  "search_information": {
    "image_results_state": "<string>"
  },
  "serpapi_pagination": {
    "next": "<string>",
    "current": 123,
    "previous": "<string>"
  }
}

请求规范

方法与路径: POST /apis/v1/serpapi/search-google-images-light
可用状态: enabled
请求 URL 模板: https://api.aisa.one/apis/v1/serpapi/search-google-images-light
Runtime 事实版本: 1d8d2010628130bd331b470b564dd1cd5784989899ccf3e384a8de02a69e0558

完整 OpenAPI 定义有效请求与价格声明（包括认证和引用的 schema）：

{
  "operationId": "serpapi.search-google-images-light",
  "method": "POST",
  "path": "/apis/v1/serpapi/search-google-images-light",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "q"
          ],
          "properties": {
            "q": {
              "type": "string",
              "examples": [
                "coffee",
                "landscape photography"
              ],
              "description": "Search query for Google Images. Supports Google search operators like inurl:, site:, intitle:."
            },
            "gl": {
              "type": "string",
              "examples": [
                "us",
                "uk",
                "fr"
              ],
              "description": "Two-letter country code to define the country for the search."
            },
            "hl": {
              "type": "string",
              "examples": [
                "en",
                "es",
                "fr"
              ],
              "description": "Two-letter language code to define the language for the search interface."
            },
            "imgar": {
              "type": "string",
              "examples": [
                "s",
                "t",
                "w",
                "xw"
              ],
              "description": "Aspect ratio filter. Options: s (square), t (tall), w (wide), xw (extra wide)."
            },
            "imgsz": {
              "type": "string",
              "examples": [
                "l",
                "m",
                "i"
              ],
              "description": "Image size filter. Options: l (large), m (medium), i (icon), etc."
            },
            "start": {
              "type": "integer",
              "maximum": 999,
              "minimum": 0,
              "examples": [
                0,
                10,
                20
              ],
              "description": "Result offset for pagination. Must be between 0 and 999."
            },
            "device": {
              "type": "string",
              "examples": [
                "desktop",
                "tablet",
                "mobile"
              ],
              "description": "Device type for the search. Options: desktop (default), tablet, mobile."
            },
            "engine": {
              "type": "string",
              "default": "google_images_light",
              "description": "Set parameter to google_images_light to use the Google Images Light API engine."
            },
            "end_date": {
              "type": "string",
              "examples": [
                "20231231"
              ],
              "description": "End date for filtering images by upload date. Format: YYYYMMDD."
            },
            "location": {
              "type": "string",
              "examples": [
                "Austin, Texas, United States",
                "New York,United States"
              ],
              "description": "Geographic location for the search origin. Specify at city level for best results."
            },
            "start_date": {
              "type": "string",
              "examples": [
                "20231201"
              ],
              "description": "Start date for filtering images by upload date. Format: YYYYMMDD."
            },
            "image_color": {
              "type": "string",
              "examples": [
                "bw",
                "red",
                "blue"
              ],
              "description": "Color filter for images. Options: bw (black and white), red, blue, green, yellow, orange, pink, white, gray, black, teal, brown."
            },
            "period_unit": {
              "type": "string",
              "examples": [
                "d",
                "w",
                "m"
              ],
              "description": "Time period unit for filtering by upload date. Options: s (second), n (minute), h (hour), d (day), w (week), m (month), y (year). Must be used with period_value."
            },
            "period_value": {
              "type": "integer",
              "examples": [
                1,
                7,
                30
              ],
              "description": "Time period value to use with period_unit. Specifies how many units back to search."
            },
            "google_domain": {
              "type": "string",
              "examples": [
                "google.com",
                "google.co.uk"
              ],
              "description": "Google domain to use for the search. Defaults to google.com."
            }
          }
        }
      }
    }
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "response_units",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.0253,
    "estimate_source": "profile_seed",
    "evidence_source": "response_body",
    "maximum_units": 10000000,
    "unit": "provider_credit",
    "unit_rate_usd": 1e-06
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

费用与请求规则

按用量计费；默认请求预估费用：$0.0253 USD（不是固定价格）。声明的单位费率：每 provider_credit $0.000001 USD。最终费用以账户适用价格及实际结算为准。公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。

默认请求参考估价（USD）: 0.0253
声明的单位费率（USD）: 1e-06
计费单位: provider_credit
计费依据: response_units
公开参考倍率: 1.0
声明的最大计数或单位数: 10000000
结算证据来源: response_body

授权

Authorization

string

header

必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

string

必填

Search query for Google Images. Supports Google search operators like inurl:, site:, intitle:.

示例:

"coffee"

"landscape photography"

string

Two-letter country code to define the country for the search.

示例:

"us"

"uk"

"fr"

string

Two-letter language code to define the language for the search interface.

示例:

"en"

"es"

"fr"

imgar

string

Aspect ratio filter. Options: s (square), t (tall), w (wide), xw (extra wide).

示例:

"s"

"t"

"w"

"xw"

imgsz

string

Image size filter. Options: l (large), m (medium), i (icon), etc.

示例:

"l"

"m"

"i"

start

integer

Result offset for pagination. Must be between 0 and 999.

必填范围: 0 <= x <= 999

示例:

0

10

20

device

string

Device type for the search. Options: desktop (default), tablet, mobile.

示例:

"desktop"

"tablet"

"mobile"

engine

string

默认值:google_images_light

Set parameter to google_images_light to use the Google Images Light API engine.

end_date

string

End date for filtering images by upload date. Format: YYYYMMDD.

示例:

"20231231"

location

string

Geographic location for the search origin. Specify at city level for best results.

示例:

"Austin, Texas, United States"

"New York,United States"

start_date

string

Start date for filtering images by upload date. Format: YYYYMMDD.

示例:

"20231201"

image_color

string

Color filter for images. Options: bw (black and white), red, blue, green, yellow, orange, pink, white, gray, black, teal, brown.

示例:

"bw"

"red"

"blue"

period_unit

string

Time period unit for filtering by upload date. Options: s (second), n (minute), h (hour), d (day), w (week), m (month), y (year). Must be used with period_value.

示例:

"d"

"w"

"m"

period_value

integer

Time period value to use with period_unit. Specifies how many units back to search.

示例:

1

7

30

google_domain

string

Google domain to use for the search. Defaults to google.com.

示例:

"google.com"

"google.co.uk"

响应

Tool result data

images_results

object[]

Show child attributes

search_metadata

object

Show child attributes

search_parameters

object

Show child attributes

search_information

object

Show child attributes

serpapi_pagination

object

Show child attributes