Google

Google Images

Retrieve Google Images using its native source data.

post/v1/google/images

Request

  • Base URL: https://api.prismcrawl.com
  • URL: https://api.prismcrawl.com/v1/google/images
  • Auth: API key in header x-api-key

Request body

querystring required

Text to search for on the selected service. At most 8,192 UTF-8 bytes.

countrystring

Two-letter country or storefront code, such as us or gb.

languagestring

Provider-supported language code, such as en.

pageinteger

One-based page number.

safe'active' | 'off'

Provider safe-search filtering.

time_rangestring

Provider-supported time filter.

device'desktop' | 'mobile' | 'tablet'

Device presentation for the source request.

htmlboolean

Return the encoded original response rather than parsed JSON.

zero_traceboolean

Do not archive source or parsed response artifacts.

locationstring

Location to search around, such as Austin, TX.

uulestring

Encoded Google location; cannot be combined with location or coordinates.

google_domainstring

Google country domain, such as google.com or google.co.uk.

crstring

Restrict results to country codes joined with |.

nfpr0 | 1

Control automatic spelling correction (1 excludes corrected results).

filter0 | 1

Control omitted/similar results filtering (1 enables it).

ijninteger

Zero-based image results page.

tbsstring

Native Google comma-separated key:value filters.

period_unit's' | 'n' | 'h' | 'd' | 'w' | 'm' | 'y'

Unit for a recent-results time range.

period_valueinteger

Number of units in the recent-results time range; defaults to 1.

start_datestring

Inclusive start date in YYYYMMDD format.

end_datestring

Inclusive end date in YYYYMMDD format.

imgar's' | 't' | 'w' | 'xw'

Image imgar filter.

imgsz'l' | 'm' | 'i' | 'qsvga' | 'vga' | 'svga' | 'xga' | '2mp' | '4mp' | '6mp' | '8mp' | '10mp' | '12mp' | '15mp' | '20mp' | '40mp' | '70mp'

Image imgsz filter.

image_color'bw' | 'trans' | 'red' | 'orange' | 'yellow' | 'green' | 'teal' | 'blue' | 'purple' | 'pink' | 'white' | 'gray' | 'black' | 'brown'

Image image color filter.

image_type'face' | 'photo' | 'clipart' | 'lineart' | 'animated'

Image image type filter.

licenses'f' | 'fc' | 'fm' | 'fmc' | 'cl' | 'ol'

Image licenses filter.

chipsstring

Source chips filter token copied from Google results.

output'json' | 'html' | 'md' | 'null' nullable

Response content format. md returns Markdown in data.content with data.format=md; the JSON success/request envelope remains. Accept: text/markdown also selects Markdown unless output or html=true is explicit. html is an alias for html=true and retains the existing Brotli/Base64 source format.

json_restrictorstring nullable

Select fields within data.content for JSON or Markdown. Supports comma-separated paths, non-negative array indices, half-open slices [0:3] (either bound may be omitted), [] and .{nested,subqueries}. Up to128 selections and16 levels. Missing fields are omitted; selected declared fields retain their zero defaults. The request envelope and credit headers remain. Include next_page_token when pagination is needed. Incompatible with HTML output. This changes response presentation only; tracing-enabled history retains the complete JSON result.

no_cacheboolean nullable

Accepted for compatibility. Searches are always fetched without a result cache for either value; normal successful-request billing applies.

Example request

{
  "json_restrictor": "results[].{title,url},has_next_page,next_page_token"
}

Response

Request completed. One credit is charged, including recognized empty or unavailable source results and source inventory changes discovered after a valid continuation is fetched. These completed responses may preserve verified partial results; operational failures remain errors.

successtrue required
request_idstring uuid required

Changes

No recorded changes to this operation across all 2 revisions of this API.