Google SERP Shorts Search API

Data & APIs

Call GET /api/v1/google/shorts/search for Google SERP Shorts Search through Just Serp API with query.

Install

openclaw skills install justserpapi-google-shorts-search

Google SERP Shorts Search

Use this focused Just Serp API skill for Google SERP Shorts Search. It targets GET /api/v1/google/shorts/search. Required inputs are query. OpenAPI describes it as: Get Google shorts Search data, including video metadata and rankings, for short-form content tracking and trend analysis.

Endpoint Scope

  • Group key: google
  • Endpoint key: shorts/search
  • Group family: Google SERP
  • Skill slug: justserpapi-google-shorts-search
OperationVersionMethodPathOpenAPI summary
shortsSearchv1GET/api/v1/google/shorts/searchSearch

Inputs

ParameterInRequired byOptional byTypeNotes
countryqueryn/aallstringSet the target country code (e.g., 'us', 'uk') to localize results. See <a href="/reference/google-countries">Google Countries</a>
domainqueryn/aallstringThe Google domain to use for the search (e.g., 'google.com', 'google.co.uk'). See <a href="/reference/google-domains">Google Domains</a>
htmlqueryn/aallbooleanSet to true to return the raw HTML of the Google search results page alongside the structured data
languagequeryn/aallstringSet the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See <a href="/reference/google-language">Google Language</a>
lrqueryn/aallstringRestrict results to one or more languages using the 'lang_{language_code}' format (e.g., 'lang_en'). See <a href="/reference/google-lr-language">Google LR Language</a>
nfprqueryn/aallstringControls Google's auto-correction. Set to '1' to exclude corrected results, '0' to include them
queryqueryalln/astringThe search query for Google Shorts (e.g., 'cooking tips', 'travel hacks')
safequeryn/aallstringSafeSearch filter setting. Set to 'active' to filter adult content, or 'off' to disable it
startqueryn/aallintegerThe result offset to skip a specific number of entries (e.g., set to 12 to skip the first 12 results)
tbsqueryn/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 empty
uulequeryn/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 shortsSearch for the documented v1 endpoint. There are no alternate versions grouped in this skill.

Run This Endpoint

Supported operation IDs in this skill: shortsSearch.

node {baseDir}/bin/run.mjs --operation "shortsSearch" --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 shortsSearch on /api/v1/google/shorts/search.
  • Echo the required lookup scope (query) before summarizing results.
  • Prioritize fields that support this endpoint purpose: Get Google shorts Search data, including video metadata and rankings, for short-form content tracking and trend analysis.
  • Return raw JSON only after the short, endpoint-specific summary.
  • If the backend errors, include the backend payload and the exact operation ID.