A high-performance Openclaw Skills integration to query and extract Google SERP Shorts search data, including video metadata and rankings.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install justserpapi-google-shorts-search
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install justserpapi-google-shorts-search using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Google SERP Shorts Search API?
The Google SERP Shorts Search API is a specialized capability designed to empower automated systems and developers to monitor short-form video performance directly on Google search results. By leveraging this tool within the Openclaw Skills ecosystem, developers can programmatically retrieve rich metadata, search rankings, and engagement signals for YouTube Shorts and similar content.
This integration simplifies workflow automation for marketing platforms, content research suites, and AI-driven SEO applications. Rather than building and maintaining complex, brittle scrapers, developers can access precise, structured SERP data through a standardized interface to drive insights and content strategies.
Google SERP Shorts Search API Use Cases
- Search Visibility Tracking: Programmatically audit how short-form videos rank for specific target search queries.
- Trend & Competitor Analysis: Analyze popular video formats, duration patterns, and metadata across your niche.
- Localized Content Strategy: Research regional variations in short-form content listings by modifying country and domain variables.
- AI Content Automation: Provide real-time data feeds directly into LLM agents powered by Openclaw Skills to automate competitive reporting.
How Google SERP Shorts Search API Works
- Initiation: The system calls the
shortsSearchoperation with a target search query (e.g., 'travel hacks'). - Parameter Customization: Optional filters like
country,language, anduulelocalize and filter the search scope. - Just Serp API Call: A GET request is executed against the
/api/v1/google/shorts/searchendpoint. - Response Delivery: The skill retrieves the response, maps key video metadata (titles, channel links, rankings), and returns structured JSON output.
Google SERP Shorts Search API Setup
Credentials Configuration
Ensure that you have your Just Serp API key available as an environment variable. Do not hardcode this key directly in scripts or logs.
export JUST_SERP_API_KEY="your_just_serp_api_key_here"
Running the Search Operation
Run the execution script targeting the shortsSearch operation, replacing <query> with your search term:
node {baseDir}/bin/run.mjs --operation "shortsSearch" --api-key "$JUST_SERP_API_KEY" --params-json '{"query":"cooking tips"}'
Google SERP Shorts Search API Data Schema & Taxonomy
Request Parameters
| Parameter | Location | Required | Type | Description |
|---|---|---|---|---|
query |
Query | Yes | string |
The target search phrase (e.g., 'cooking tips', 'travel hacks'). |
country |
Query | No | string |
The country code (e.g., 'us', 'uk') to localize results. |
domain |
Query | No | string |
The target Google domain (e.g., 'google.com', 'google.co.uk'). |
language |
Query | No | string |
Language code for results (e.g., 'en', 'fr'). |
html |
Query | No | boolean |
Set to true to include raw HTML alongside structured data. |
lr |
Query | No | string |
Restricts results to specific languages (e.g., 'lang_en'). |
nfpr |
Query | No | string |
Exclude auto-corrected search results ('1' or '0'). |
safe |
Query | No | string |
Set SafeSearch preferences ('active' or 'off'). |
start |
Query | No | integer |
Starting offset for paginated search listings. |
tbs |
Query | No | string |
Advanced parameters (such as timeframe filtering). |
uule |
Query | No | string |
Encoded location string for high-precision local tracking. |
Output Format
The output contains clean, structured JSON representing:
- Execution Summary: Contains the operation ID (
shortsSearch) and endpoint path. - Metadata Payload: Details on retrieved video items including titles, durations, video URLs, and channels.
- Rankings: Position of each short-form video in the Google Shorts SERP block.
Google SERP Shorts Search API Advanced Features
- Precision Geolocation: Utilize
uuleand localizeddomainvariables to capture search rankings for highly specific physical regions. - Direct HTML Access: Retrieve raw search engine markup alongside clean JSON structures for alternative parsing.
- Flexible Automation: Integrated natively to support automated workflows and multi-agent setups running on Openclaw Skills.
- Time-bound Querying: Use advanced
tbsstrings to pull trend data scoped to specific historical windows.
SKILL.md
Loading
Related Openclaw Skills
Google SERP Search Mobile API
A specialized Openclaw Skills integration designed to programmatically fetch Google mobile SERP layouts and rankings via the Just Serp API.
Google SERP Shopping Search API
A highly specialized API skill to search Google Shopping for product listings, local pricing, and merchant offers.
Google SERP Trends Autocomplete API
An AI agent skill to programmatically fetch Google trends autocomplete and topic ID data for trend discovery and topic expansion.
Cyber-Jianghu Guide
An interactive AI agent skill that lets you guide, track, and influence autonomous martial arts heroes in a Rust-powered sandbox world.
Time Stamper
A minimal utility skill designed to quickly generate formatted timestamps for logging, filenames, and debugging tasks.
Google SERP Scholar Search API
An academic search integration powered by Openclaw Skills that enables AI agents to query Google Scholar, extract literature, patents, legal documents, and track citations.
METADATA
Featured*
