WEBSEO TOOLS API MCP READY

Google Short Videos API - YouTube Shorts

Scrape Google Short Videos search results: title, link, preview clip, source (YouTube, Facebook, TikTok), channel, and duration, plus related "people also search for" suggestions. Country/language targeting and pagination.

MEDIAN LAGon demand
PARAMETERS13
TOTAL USERS10
MONTHLY ACTIVE5
TOTAL RUNS104
RUNS SUCCEEDED97.5%
RATING5.0 (1)

Input parameters

PARAMETERTYPEREQDEFAULTDESCRIPTION
q string yes — Enter the search query to find short videos for (e.g., 'workout tips', 'cat videos', 'electric cars').
device enum no mobile Choose the device profile.
location string no — Set a geographic location to localize results (e.g., 'Austin, TX, Texas, United States', 'New York, NY').
uule string no — Provide a Google-encoded UULE location string instead of a plain location.
google_domain string no — Google domain to use for the search (e.g., 'google.com', 'google.co.uk', 'google.fr').
gl enum no — Pick a two-letter country code to localize results (ISO 3166-1 alpha-2, lowercase).
hl enum no — Pick a two-letter interface language code (ISO 639-1, lowercase).
lr string no — Restrict results to one or more languages (e.g., 'lang_en' or 'lang_en|lang_es').
tbs string no — Apply advanced Google search filters via a raw tbs string.
safe enum no off Safe search setting to filter explicit content.
nfpr enum no 0 Exclude results from auto-corrected queries when the original query is misspelled.
filter enum no 0 Enable or disable duplicate content filtering.
max_pages integer no 1 Set the maximum number of result pages to fetch. — drives your bill

Worked examples

Basic — the required input, with the schema's own example values
{
  "q": "workout tips"
}

Coverage

244
country code — ad ae af ag ai +239
200
language code — en es fr de it +195

Tasks

Saved runs with the inputs already filled in — each one a standalone page and a working configuration example.

Request a task →

Code

curl

curl -X POST "https://api.apify.com/v2/acts/johnvc~google-short-videos-api/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"q": "workout tips"}'

Python

from apify_client import ApifyClient

client = ApifyClient("APIFY_TOKEN")
run = client.actor("johnvc/google-short-videos-api").call(
    run_input={'q': 'workout tips'}
)
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)