← Back to Skills Marketplace
justserpapi

Google SERP Images Search API

by justserpapi · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
36
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install justserpapi-google-images-search
Description
Call GET /api/v1/google/images/search for Google SERP Images Search through Just Serp API with query.
README (SKILL.md)

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
Operation Version Method Path OpenAPI summary
imagesSearch v1 GET /api/v1/google/images/search Search

Inputs

Parameter In Required by Optional by Type Notes
chips query n/a all string Additional suggested search terms (chips) to filter images. Values are obtained from previous responses
country query n/a all string Set the target country code (e.g., 'us', 'uk') to localize results. See \x3Ca href="/reference/google-countries">Google Countries\x3C/a>
cr query n/a all string Limits results to search results from specific countries. Format: 'countryXX'. See \x3Ca href="/reference/google-cr-countries">Google CR Countries\x3C/a>
domain query n/a all string The Google domain to use for the search (e.g., 'google.com', 'google.co.uk'). See \x3Ca href="/reference/google-domains">Google Domains\x3C/a>
end_date query n/a all string End date for restricting images to a time range. Format: 'YYYYMMDD' (e.g., '20241231')
filter query n/a all string Toggle 'Similar Results' and 'Omitted Results' filters. Set to '1' (default) to enable, '0' to disable
html query n/a all boolean Set to true to return the raw HTML of the Google search results page alongside the structured data
image_color query n/a all string Filter images by a dominant color (e.g., 'red', 'blue', 'bw' for black and white, 'trans' for transparent)
image_type query n/a all string Filter by image type. Supported values: 'face', 'photo', 'clipart', 'lineart', 'animated'
imgar query n/a all string Filter by image aspect ratio. Supported values: 's' (Square), 't' (Tall), 'w' (Wide), 'xw' (Panoramic)
imgsz query n/a all string Filter by image size. Supported values: 'l' (Large), 'm' (Medium), 'i' (Icon), and specific resolutions like '4mp', '10mp'
language query n/a all string Set the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See \x3Ca href="/reference/google-language">Google Language\x3C/a>
licenses query n/a all string Filter by usage rights and licenses. Supported values: 'f' (Free to use), 'fc' (Commercial use), 'cl' (Creative Commons)
lr query n/a all string Restrict results to one or more languages using the 'lang_{language_code}' format (e.g., 'lang_en'). See \x3Ca href="/reference/google-lr-language">Google LR Language\x3C/a>
nfpr query n/a all string Controls Google's auto-correction. Set to '1' to exclude corrected results, '0' to include them
page query n/a all integer The results page number. Use 0 for the first page, 1 for the second, and so on
period_unit query n/a all string Time unit for 'recent' image results. Supported values: 's' (Second), 'n' (Minute), 'h' (Hour), 'd' (Day), 'w' (Week), 'm' (Month), 'y' (Year)
period_value query n/a all string Time duration value used with 'period_unit' (e.g., 15 for 15 days). Default: 1
query query all n/a string The search query for images (e.g., 'mountain landscape', 'luxury cars')
safe query n/a all string SafeSearch filter setting. Set to 'active' to filter adult content, or 'off' to disable it
start_date query n/a all string Start date for restricting images to a time range. Format: 'YYYYMMDD' (e.g., '20241201')
tbs query n/a all string Advanced 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 empty
uule query n/a all string Encoded 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.

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

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.
Usage Guidance
Install only if you are comfortable sending image search queries, filters, localization parameters, and your Just Serp API key to Just Serp API. Avoid secrets, personal data, regulated data, or precise location details in queries unless you have reviewed the provider's privacy and retention terms.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
The skill purpose, documentation, and helper code all align around one GET endpoint for Just Serp API Google image search.
Instruction Scope
Instructions ask the agent to pass user-provided query terms and filters unchanged; this is expected for search but can transmit sensitive terms, localization fields, or raw HTML requests to the API provider.
Install Mechanism
The artifact contains documentation, generated operation metadata, and a single Node helper; no install script, package dependency execution, or hidden setup behavior was found.
Credentials
The required Node runtime and JUST_SERP_API_KEY are proportionate for calling the documented external API endpoint.
Persistence & Privilege
No persistence, background execution, local file indexing, privilege escalation, destructive actions, or credential-store access was found; the API key is only sent as the documented request header.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install justserpapi-google-images-search
  3. After installation, invoke the skill by name or use /justserpapi-google-images-search
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Operation summary for imagesSearch updated from "Images Search" to "Search". - skill-card.md file removed. - Minor documentation and formatting updates in SKILL.md and generated files.
v1.0.0
Initial publish
Metadata
Slug justserpapi-google-images-search
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Google SERP Images Search API?

Call GET /api/v1/google/images/search for Google SERP Images Search through Just Serp API with query. It is an AI Agent Skill for Claude Code / OpenClaw, with 36 downloads so far.

How do I install Google SERP Images Search API?

Run "/install justserpapi-google-images-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Google SERP Images Search API free?

Yes, Google SERP Images Search API is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Google SERP Images Search API support?

Google SERP Images Search API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Google SERP Images Search API?

It is built and maintained by justserpapi (@justserpapi); the current version is v1.0.1.

💬 Comments