Google SERP Search Light#

Use this focused Just Serp API skill for Google SERP Search Light. It targets GET /api/v1/google/search/light. Required inputs are query. OpenAPI describes it as: Get Google light Search SERP data, including essential result data, for high-volume monitoring and fast rank checks.

Endpoint Scope#

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

OperationVersionMethodPathOpenAPI summarysearchLight``v1``GET``/api/v1/google/search/lightLight Search

Inputs#

ParameterInRequired byOptional byTypeNotescountry``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 Domainsfilter``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 dataibp``queryn/aallstringParameter (ibp) used to control certain Google UI expansions or rendering modes (commonly in local/business result views). This is an advanced technical parameter — if you’re not familiar with it, you can leave it emptykgmid``queryn/aallstringKnowledge Graph entity/listing ID (KGMID) used to retrieve details for a specific entity. This is an advanced technical parameter — if you’re not familiar with it, you can leave it emptylanguage``queryn/aallstringSet the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See Google Languagelocation``queryn/aallstringThe textual location name (e.g., 'New York, NY') to localize the search resultslr``queryn/aallstringRestrict results to one or more languages using the 'lang_{language_code}' format (e.g., 'lang_en'). See Google LR Languagelsig``queryn/aallstringSignature parameter (lsig) sometimes required for certain Knowledge Graph / local map view features. This is an advanced technical parameter — if you’re not familiar with it, you can leave it emptyludocid``queryn/aallstringGoogle local business CID (place identifier). Used to target a specific Google Business Profile / local listing. Advanced parameter — if you don’t know it, you can omit itnfpr``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 onquery``queryalln/astringThe search query for Google Search (e.g., 'coffee shops', 'how to bake a cake')safe``queryn/aallstringSafeSearch filter setting. Set to 'active' to filter adult content, or 'off' to disable itsi``queryn/aallstringCached search context parameter (si) used to reproduce specific Google search result views/context (e.g. some Knowledge Graph tabs). This is an advanced technical parameter — if you’re not familiar with it, you can leave it emptytbs``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 emptyuds``queryn/aallstringAdvanced filter token (uds) used for specific Google search sub-filters. This is an advanced technical parameter, usually provided by Google in filter options/results — 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 searchLight for the documented v1 endpoint. There are no alternate versions grouped in this skill.

Run This Endpoint#

Supported operation IDs in this skill: searchLight.

bash

node {baseDir}/bin/run.mjs --operation "searchLight" --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 searchLight on /api/v1/google/search/light.
• Echo the required lookup scope ( query) before summarizing results.
• Prioritize fields that support this endpoint purpose: Get Google light Search SERP data, including essential result data, for high-volume monitoring and fast rank checks.
• Return raw JSON only after the short, endpoint-specific summary.
• If the backend errors, include the backend payload and the exact operation ID.