Google SERP Images Search#

Use this focused Just Serp API skill for Google SERP Images Search. It targets GET /api/v1/google/images/search. Required inputs are query. OpenAPI describes it as: Get Google images Search data, including image URLs and metadata, for filtered image discovery for research and monitoring workflows.

Endpoint Scope#

• Group key: google
• Endpoint key: images/search
• Group family: Google SERP
• Skill slug: justserpapi-google-images-search

OperationVersionMethodPathOpenAPI summaryimagesSearch``v1``GET``/api/v1/google/images/searchSearch

Inputs#

ParameterInRequired byOptional byTypeNoteschips``queryn/aallstringAdditional suggested search terms (chips) to filter images. Values are obtained from previous responsescountry``queryn/aallstringSet the target country code (e.g., 'us', 'uk') to localize results. See Google Countriescr``queryn/aallstringLimits results to search results from specific countries. Format: 'countryXX'. See Google CR Countriesdomain``queryn/aallstringThe Google domain to use for the search (e.g., 'google.com', 'google.co.uk'). See Google Domainsend_date``queryn/aallstringEnd date for restricting images to a time range. Format: 'YYYYMMDD' (e.g., '20241231')filter``queryn/aallstringToggle 'Similar Results' and 'Omitted Results' filters. Set to '1' (default) to enable, '0' to disablehtml``queryn/aallbooleanSet to true to return the raw HTML of the Google search results page alongside the structured dataimage_color``queryn/aallstringFilter images by a dominant color (e.g., 'red', 'blue', 'bw' for black and white, 'trans' for transparent)image_type``queryn/aallstringFilter by image type. Supported values: 'face', 'photo', 'clipart', 'lineart', 'animated'imgar``queryn/aallstringFilter by image aspect ratio. Supported values: 's' (Square), 't' (Tall), 'w' (Wide), 'xw' (Panoramic)imgsz``queryn/aallstringFilter by image size. Supported values: 'l' (Large), 'm' (Medium), 'i' (Icon), and specific resolutions like '4mp', '10mp'language``queryn/aallstringSet the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See Google Languagelicenses``queryn/aallstringFilter by usage rights and licenses. Supported values: 'f' (Free to use), 'fc' (Commercial use), 'cl' (Creative Commons)lr``queryn/aallstringRestrict results to one or more languages using the 'lang_{language_code}' format (e.g., 'lang_en'). See Google LR Languagenfpr``queryn/aallstringControls Google's auto-correction. Set to '1' to exclude corrected results, '0' to include thempage``queryn/aallintegerThe results page number. Use 0 for the first page, 1 for the second, and so onperiod_unit``queryn/aallstringTime unit for 'recent' image results. Supported values: 's' (Second), 'n' (Minute), 'h' (Hour), 'd' (Day), 'w' (Week), 'm' (Month), 'y' (Year)period_value``queryn/aallstringTime duration value used with 'period_unit' (e.g., 15 for 15 days). Default: 1query``queryalln/astringThe search query for images (e.g., 'mountain landscape', 'luxury cars')safe``queryn/aallstringSafeSearch filter setting. Set to 'active' to filter adult content, or 'off' to disable itstart_date``queryn/aallstringStart date for restricting images to a time range. Format: 'YYYYMMDD' (e.g., '20241201')tbs``queryn/aallstringAdvanced search filter parameter (tbs) used to apply Google result filters (e.g. time range). This is an advanced parameter — if you’re not familiar with it, you can leave it emptyuule``queryn/aallstringEncoded location string (UULE) used to precisely localize Google search results. This is an advanced/technical parameter — if you’re not familiar with it, you can leave it empty and omit it

Request body: none documented; send parameters through path or query arguments.

Version Choice#

Use imagesSearch for the documented v1 endpoint. There are no alternate versions grouped in this skill.

Run This Endpoint#

Supported operation IDs in this skill: imagesSearch.

bash

node {baseDir}/bin/run.mjs --operation "imagesSearch" --api-key "$JUST_SERP_API_KEY" --params-json '{"query":"<query>"}'

Ask for any missing required parameter before calling the helper. Keep user-provided IDs, URLs, keywords, and filters unchanged.

Environment#

• Required: JUST_SERP_API_KEY
• Pass the API key with --api-key "$JUST_SERP_API_KEY"; do not paste key values into chat messages, screenshots, or logs.
• Project site: Just Serp API.
• Authentication details: Just Serp API Docs.

Output Focus#

• State the operation ID and endpoint path used, for example imagesSearch on /api/v1/google/images/search.
• Echo the required lookup scope ( query) before summarizing results.
• Prioritize fields that support this endpoint purpose: Get Google images Search data, including image URLs and metadata, for filtered image discovery for research and monitoring workflows.
• Return raw JSON only after the short, endpoint-specific summary.
• If the backend errors, include the backend payload and the exact operation ID.