Core APIs
...
Google
Core Requests
Images
3min
google image parameters get get /search?search type=images the google image parameters are applicable when making a request with search type=images to retrieve image results for a given search term the search term is specified in the q parameter and the optional location parameter can be used to geo locate the image request (locations can be retrieved via the locations api https //docs trajectdata com/scaleserp/locations api/overview ) for example, to request image results for the keyword pizza in the location united states , the request would be http https //api scaleserp com/search?api key=demo\&search type=images\&q=pizza\&location=united+statescurl l get https //api scaleserp com/search \\ d api key="demo" \\ d q="pizza" \\ d search type="images" \\ d location="united+states"const axios = require('axios'); // set up the request parameters const params = { api key "demo", q "pizza", search type "images", location "united+states" } // make the http get request axios get('https //api scaleserp com"/search', { params }) then(response => { // print the json response console log(json stringify(response data, 0, 2)); }) catch(error => { // catch and print the error console log(error); })import requests import json \# set up the request parameters params = { 'api key' 'demo', 'q' 'pizza', 'search type' 'images', 'location' 'united+states' } \# make the http get request api result = requests get('https //api scaleserp com/search', params) \# print the json response print(json dumps(api result json()))\<?php \# set up the request parameters $querystring = http build query(\[ 'api key' => 'demo', 'q' => 'pizza', 'search type' => 'images', 'location' => 'united+states' ]); \# make the http get request $ch = curl init(sprintf('%s?%s', 'https //api scaleserp com/search', $querystring)); curl setopt($ch, curlopt returntransfer, true); curl setopt($ch, curlopt followlocation, true); \# the following options are required if you're using an outdated openssl version \# more details https //www openssl org/blog/blog/2021/09/13/letsencryptrootcertexpire/ curl setopt($ch, curlopt ssl verifyhost, false); curl setopt($ch, curlopt ssl verifypeer, false); curl setopt($ch, curlopt timeout, 180); $api result = curl exec($ch); curl close($ch); \# print the json response echo $api result; ?> google image parameters the following parameters are available for all requests made when search type=images parameter required description search type required should be set to search type=images q required the keyword you want to use to perform the images search location optional determines the geographic location in which the query is executed you can enter any location as free text, but if you choose one of the scale serp built in locations https //docs trajectdata com/scaleserp/locations api/overview then the google domain , gl and hl parameters are automatically updated to the domain, country and language that match the built in location (note that this behaviour can be disabled via the location auto parameter) location auto optional if the location field is set to a scale serp built in location https //docs trajectdata com/scaleserp/locations api/overview from the locations api https //docs trajectdata com/scaleserp/locations api/overview , and location auto is set to true (default) then the google domain , gl and hl parameters are automatically updated to the domain, country and language that match the built in location valid values are true (default) to enable this behaviour or false to disable uule optional the google uule parameter use to pass through a custom uule parameter to google scale serp automatically generates the uule when you use the location parameter but we allow you to overwrite it directly by specifying a uule directly google domain optional the google domain to use to run the search query view the full list of supported google domain values here https //docs trajectdata com/scaleserp/search api/reference/google domains defaults to google com gl optional the gl parameter determines the google country to use for the query view the full list of supported gl values here https //docs trajectdata com/scaleserp/search api/reference/google countries defaults to us hl optional the hl parameter determines the google ui language to return results view the full list of supported hl values here https //docs trajectdata com/scaleserp/search api/reference/google languages defaults to en lr optional the lr parameter limits the results to websites containing the specified language view the full list of supported lr values here https //docs trajectdata com/scaleserp/search api/reference/google lr languages cr optional the cr parameter instructs google to limit the results to websites in the specified country view the full list of supported cr values here https //docs trajectdata com/scaleserp/search api/reference/google cr countries images page optional determines the page of results to get when search type=images for images google will return 100 results per page (a google imposed limit) use images page to specify the page of results to retrieve, for example is images page=2 the api will return images 100 199 images color optional allows you to set the color of the images returned when search type=images valid values are any , black and white , transparent , red , orange , yellow , green , teal , blue , purple , pink , white , gray , black or brown images size optional allows you to set the size of the images returned when search type=images valid values are large , medium , or icon images type optional allows you to set the size of the images returned when search type=images allows you to set the type of the images returned when search type=images valid values are clipart , line drawing , or gif images usage optional allows you to specify the usage rights of the images returned when search type=images valid values are non commercial reuse with modification or non commercial reuse time period optional determines the time period of the results shown it can be set to last hour , last day (for the last 24 hours), last week (for the last 7 days), last month , last year or custom when using custom you must also specifiy one or both of the time period min or time period max parameters to define the custom time period time period min optional determines the minimum (i e 'from') time to use when time period is set to custom should be in the form mm/dd/yyyy , i e for 31st december 2018 time period min would be 12/31/2018 time period max optional determines the maximum (i e 'to') time to use when time period is set to custom should be in the form mm/dd/yyyy , i e for 31st december 2018 time period max would be 12/31/2018 safe optional determines whether safe search is enabled for the results can be set to active to enable safe search, or off to disable safe search tbs optional sets a specific string to be added to the google tbs parameter in the underlying google query the tbs parameter is normally generated automatically by the api, but it can be set explicitly also next steps google image results https //docs trajectdata com/scaleserp/search api/results/google/images