# Google Short Videos API - YouTube Shorts, Reels & TikTok (`johnvc/google-short-videos-api`) Actor

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.

- **URL**: https://apify.com/johnvc/google-short-videos-api.md
- **Developed by:** [John](https://apify.com/johnvc) (community)
- **Categories:** Videos, Social media, SEO tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 5 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $0.01 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Google Short Videos API - YouTube Shorts, Reels & TikTok

Scrape Google Short Videos search results as a clean API. Run a query and get back short-form videos from across the web (YouTube Shorts, Facebook and Instagram Reels, TikTok, and more), plus the related "people also search for" suggestions Google shows on mobile.

Unlike channel scrapers that target a single platform, this Actor returns the cross-platform short-video results Google itself surfaces for a search term, so you see what is ranking right now across sources.

### What this Actor returns

Each result is a flat row tagged with a `result_type`, so the output drops straight into a table, CSV, or an AI agent:

- `short_video` rows: `position`, `title`, `link`, `clip` (preview image URL when available), `source` (YouTube, Facebook, TikTok, etc.), `channel`, and `duration`.
- `people_also_search_for` rows: related search `title` and `link` (returned on mobile and tablet devices).
- `error` rows: a clear `error_message` and `error_type` if something goes wrong, so a run never fails silently.

Every row also carries the `query` and `page_number` it came from.

### Use cases

- Track which short videos rank for a topic across YouTube, TikTok, and Reels in one call.
- Monitor trends and discover viral formats by source and duration.
- Build keyword research from the "people also search for" suggestions.
- Feed fresh short-video results into an AI agent or content pipeline.
- Compare results by country, language, or location.

### Input parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `q` | string | Yes | The search query (e.g. `workout tips`). |
| `device` | string | No | `mobile` (default), `tablet`, or `desktop`. Mobile and tablet also return related searches. |
| `location` | string | No | Localize results to a place (e.g. `Austin, TX, Texas, United States`). |
| `uule` | string | No | Encoded location string. Takes precedence over `location`. |
| `google_domain` | string | No | Google domain to use (e.g. `google.com`). |
| `gl` | string | No | Two-letter country code. |
| `hl` | string | No | Two-letter interface language code. |
| `lr` | string | No | Language restriction (e.g. `lang_en`). |
| `tbs` | string | No | Advanced filter string for power users. |
| `safe` | string | No | `active` or `off` to filter explicit content. |
| `nfpr` | 0 or 1 | No | Set `1` to exclude auto-corrected query results. |
| `filter` | 0 or 1 | No | Set `1` to filter duplicate results. |
| `max_pages` | integer | No | Pages to fetch. `0` means all available. Default `1`. |

### Example output

```json
[
  {
    "result_type": "short_video",
    "position": 1,
    "title": "10 Minute Full Body Workout",
    "link": "https://www.youtube.com/shorts/abc123",
    "clip": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:...",
    "source": "YouTube",
    "channel": "FitChannel",
    "duration": "0:47",
    "query": "workout tips",
    "page_number": 1
  },
  {
    "result_type": "people_also_search_for",
    "title": "home workout no equipment",
    "link": "https://www.google.com/search?q=home+workout+no+equipment",
    "query": "workout tips",
    "page_number": 1
  }
]
````

### Pricing

This Actor uses pay-per-event pricing:

- Setup fee: $0.02 once per run.
- Page processed: $0.01 per page of results. Each page returns about 10 short videos plus any related searches.

A typical single-page run costs about $0.03. Related searches do not add a separate charge.

### How to get started

1. Open the Actor on the Apify Store: [View on Apify Store](https://apify.com/johnvc/google-short-videos-api?fpr=9n7kx3)
2. Enter a search query in `q` and click Start.
3. Read results from the dataset (table, JSON, CSV, or Excel), or pull them via the Apify API.
4. Prefer code? Clone the [Python + MCP example repo on GitHub](https://github.com/johnisanerd/Apify-Google-Short-Videos-API) for a copy-paste quick start.

### 🔌 Use this API from Claude (MCP)

Add this Actor as a tool in Claude and other MCP clients through the hosted Apify MCP server. Use this Actor-specific URL:

https://mcp.apify.com/?tools=actors,docs,johnvc/google-short-videos-api

New to Claude Code or Claude Cowork? Start a free trial with this link: https://claude.ai/referral/uIlpa7nPLg

Setup walkthrough:

https://www.youtube.com/watch?v=jREWahDGhJM

Apify MCP integration docs: https://docs.apify.com/platform/integrations/mcp

### FAQ

**Why are there no "people also search for" rows?**
Those only appear on mobile and tablet. Set `device` to `mobile` (the default) or `tablet`.

**The search returned no videos.**
Try a broader query, remove restrictive filters, or change `gl` and `hl`. The Actor still completes and reports zero results rather than failing.

**Can I get more results?**
Increase `max_pages`. Set it to `0` to fetch all available pages.

Last Updated: 2026.06.01

# Actor input Schema

## `q` (type: `string`):

Enter the search query to find short videos for (e.g., 'workout tips', 'cat videos', 'electric cars'). Required.

## `device` (type: `string`):

Choose the device profile. Mobile or tablet also return the 'people also search for' related-queries block; desktop does not. Defaults to mobile.

## `location` (type: `string`):

Set a geographic location to localize results (e.g., 'Austin, TX, Texas, United States', 'New York, NY'). Optional. Cannot be combined with UULE.

## `uule` (type: `string`):

Provide a Google-encoded UULE location string instead of a plain location. Optional. Mutually exclusive with location; if both are set, UULE takes precedence.

## `google_domain` (type: `string`):

Google domain to use for the search (e.g., 'google.com', 'google.co.uk', 'google.fr'). Optional. Defaults to 'google.com' if not specified.

## `gl` (type: `string`):

Pick a two-letter country code to localize results (ISO 3166-1 alpha-2, lowercase). Optional.

## `hl` (type: `string`):

Pick a two-letter interface language code (ISO 639-1, lowercase). Optional.

## `lr` (type: `string`):

Restrict results to one or more languages (e.g., 'lang\_en' or 'lang\_en|lang\_es'). Optional.

## `tbs` (type: `string`):

Apply advanced Google search filters via a raw tbs string. Optional. For power users who already know the tbs syntax.

## `safe` (type: `string`):

Safe search setting to filter explicit content. Optional.

## `nfpr` (type: `string`):

Exclude results from auto-corrected queries when the original query is misspelled. Optional.

## `filter` (type: `string`):

Enable or disable duplicate content filtering. Optional.

## `max_pages` (type: `integer`):

Set the maximum number of result pages to fetch. Use 0 for no limit (fetch all available pages). Default: 1. Each page is charged separately and returns about 10 short videos.

## `output_file` (type: `string`):

Name a JSON file to also save results to locally. Optional. Auto-generated from the query and timestamp if omitted.

## Actor input object example

```json
{
  "q": "workout tips",
  "device": "mobile",
  "location": "Austin, TX, Texas, United States",
  "google_domain": "google.com",
  "lr": "lang_en",
  "safe": "off",
  "nfpr": "0",
  "filter": "0",
  "max_pages": 1
}
```

# Actor output Schema

## `results` (type: `string`):

Short video search results. Each dataset item is a flat row tagged with result\_type (short\_video or people\_also\_search\_for), carrying fields such as position, title, link, clip, source, channel, and duration.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "q": "workout tips",
    "location": "Austin, TX, Texas, United States",
    "google_domain": "google.com",
    "lr": "lang_en"
};

// Run the Actor and wait for it to finish
const run = await client.actor("johnvc/google-short-videos-api").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "q": "workout tips",
    "location": "Austin, TX, Texas, United States",
    "google_domain": "google.com",
    "lr": "lang_en",
}

# Run the Actor and wait for it to finish
run = client.actor("johnvc/google-short-videos-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "q": "workout tips",
  "location": "Austin, TX, Texas, United States",
  "google_domain": "google.com",
  "lr": "lang_en"
}' |
apify call johnvc/google-short-videos-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=johnvc/google-short-videos-api",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Short Videos API - YouTube Shorts, Reels & TikTok",
        "description": "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.",
        "version": "0.0",
        "x-build-id": "UAinaC7DjSBhO1Aap"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/johnvc~google-short-videos-api/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-johnvc-google-short-videos-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/johnvc~google-short-videos-api/runs": {
            "post": {
                "operationId": "runs-sync-johnvc-google-short-videos-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/johnvc~google-short-videos-api/run-sync": {
            "post": {
                "operationId": "run-sync-johnvc-google-short-videos-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "q"
                ],
                "properties": {
                    "q": {
                        "title": "Search Query",
                        "minLength": 1,
                        "type": "string",
                        "description": "Enter the search query to find short videos for (e.g., 'workout tips', 'cat videos', 'electric cars'). Required."
                    },
                    "device": {
                        "title": "Device",
                        "enum": [
                            "mobile",
                            "tablet",
                            "desktop"
                        ],
                        "type": "string",
                        "description": "Choose the device profile. Mobile or tablet also return the 'people also search for' related-queries block; desktop does not. Defaults to mobile.",
                        "default": "mobile"
                    },
                    "location": {
                        "title": "Location",
                        "type": "string",
                        "description": "Set a geographic location to localize results (e.g., 'Austin, TX, Texas, United States', 'New York, NY'). Optional. Cannot be combined with UULE."
                    },
                    "uule": {
                        "title": "UULE (Encoded Location)",
                        "type": "string",
                        "description": "Provide a Google-encoded UULE location string instead of a plain location. Optional. Mutually exclusive with location; if both are set, UULE takes precedence."
                    },
                    "google_domain": {
                        "title": "Google Domain",
                        "type": "string",
                        "description": "Google domain to use for the search (e.g., 'google.com', 'google.co.uk', 'google.fr'). Optional. Defaults to 'google.com' if not specified."
                    },
                    "gl": {
                        "title": "Country Code",
                        "enum": [
                            "ad",
                            "ae",
                            "af",
                            "ag",
                            "ai",
                            "al",
                            "am",
                            "an",
                            "ao",
                            "aq",
                            "ar",
                            "as",
                            "at",
                            "au",
                            "aw",
                            "az",
                            "ba",
                            "bb",
                            "bd",
                            "be",
                            "bf",
                            "bg",
                            "bh",
                            "bi",
                            "bj",
                            "bm",
                            "bn",
                            "bo",
                            "br",
                            "bs",
                            "bt",
                            "bv",
                            "bw",
                            "by",
                            "bz",
                            "ca",
                            "cc",
                            "cd",
                            "cf",
                            "cg",
                            "ch",
                            "ci",
                            "ck",
                            "cl",
                            "cm",
                            "cn",
                            "co",
                            "cr",
                            "cu",
                            "cv",
                            "cx",
                            "cy",
                            "cz",
                            "de",
                            "dj",
                            "dk",
                            "dm",
                            "do",
                            "dz",
                            "ec",
                            "ee",
                            "eg",
                            "eh",
                            "er",
                            "es",
                            "et",
                            "fi",
                            "fj",
                            "fk",
                            "fm",
                            "fo",
                            "fr",
                            "ga",
                            "gb",
                            "gd",
                            "ge",
                            "gf",
                            "gg",
                            "gh",
                            "gi",
                            "gl",
                            "gm",
                            "gn",
                            "gp",
                            "gq",
                            "gr",
                            "gs",
                            "gt",
                            "gu",
                            "gw",
                            "gy",
                            "hk",
                            "hm",
                            "hn",
                            "hr",
                            "ht",
                            "hu",
                            "id",
                            "ie",
                            "il",
                            "im",
                            "in",
                            "io",
                            "iq",
                            "ir",
                            "is",
                            "it",
                            "je",
                            "jm",
                            "jo",
                            "jp",
                            "ke",
                            "kg",
                            "kh",
                            "ki",
                            "km",
                            "kn",
                            "kp",
                            "kr",
                            "kw",
                            "ky",
                            "kz",
                            "la",
                            "lb",
                            "lc",
                            "li",
                            "lk",
                            "lr",
                            "ls",
                            "lt",
                            "lu",
                            "lv",
                            "ly",
                            "ma",
                            "mc",
                            "md",
                            "me",
                            "mg",
                            "mh",
                            "mk",
                            "ml",
                            "mm",
                            "mn",
                            "mo",
                            "mp",
                            "mq",
                            "mr",
                            "ms",
                            "mt",
                            "mu",
                            "mv",
                            "mw",
                            "mx",
                            "my",
                            "mz",
                            "na",
                            "nc",
                            "ne",
                            "nf",
                            "ng",
                            "ni",
                            "nl",
                            "no",
                            "np",
                            "nr",
                            "nu",
                            "nz",
                            "om",
                            "pa",
                            "pe",
                            "pf",
                            "pg",
                            "ph",
                            "pk",
                            "pl",
                            "pm",
                            "pn",
                            "pr",
                            "ps",
                            "pt",
                            "pw",
                            "py",
                            "qa",
                            "re",
                            "ro",
                            "rs",
                            "ru",
                            "rw",
                            "sa",
                            "sb",
                            "sc",
                            "sd",
                            "se",
                            "sg",
                            "sh",
                            "si",
                            "sj",
                            "sk",
                            "sl",
                            "sm",
                            "sn",
                            "so",
                            "sr",
                            "st",
                            "sv",
                            "sy",
                            "sz",
                            "tc",
                            "td",
                            "tf",
                            "tg",
                            "th",
                            "tj",
                            "tk",
                            "tl",
                            "tm",
                            "tn",
                            "to",
                            "tr",
                            "tt",
                            "tv",
                            "tw",
                            "tz",
                            "ua",
                            "ug",
                            "uk",
                            "um",
                            "us",
                            "uy",
                            "uz",
                            "va",
                            "vc",
                            "ve",
                            "vg",
                            "vi",
                            "vn",
                            "vu",
                            "wf",
                            "ws",
                            "ye",
                            "yt",
                            "za",
                            "zm",
                            "zw"
                        ],
                        "type": "string",
                        "description": "Pick a two-letter country code to localize results (ISO 3166-1 alpha-2, lowercase). Optional."
                    },
                    "hl": {
                        "title": "Language Code",
                        "enum": [
                            "en",
                            "es",
                            "fr",
                            "de",
                            "it",
                            "pt",
                            "ru",
                            "ja",
                            "ko",
                            "zh",
                            "zh-cn",
                            "zh-tw",
                            "ar",
                            "hi",
                            "th",
                            "vi",
                            "id",
                            "ms",
                            "tl",
                            "nl",
                            "pl",
                            "tr",
                            "cs",
                            "sv",
                            "da",
                            "fi",
                            "no",
                            "hu",
                            "ro",
                            "bg",
                            "hr",
                            "sk",
                            "sl",
                            "et",
                            "lv",
                            "lt",
                            "el",
                            "he",
                            "fa",
                            "ur",
                            "bn",
                            "ta",
                            "te",
                            "ml",
                            "kn",
                            "gu",
                            "pa",
                            "mr",
                            "ne",
                            "si",
                            "my",
                            "km",
                            "lo",
                            "ka",
                            "hy",
                            "az",
                            "kk",
                            "ky",
                            "uz",
                            "mn",
                            "be",
                            "uk",
                            "mk",
                            "sq",
                            "sr",
                            "bs",
                            "is",
                            "ga",
                            "cy",
                            "mt",
                            "eu",
                            "ca",
                            "gl",
                            "pt-br",
                            "es-mx",
                            "es-ar",
                            "es-cl",
                            "es-co",
                            "es-pe",
                            "es-ve",
                            "es-ec",
                            "es-bo",
                            "es-py",
                            "es-uy",
                            "es-cr",
                            "es-pa",
                            "es-ni",
                            "es-hn",
                            "es-sv",
                            "es-gt",
                            "es-do",
                            "es-cu",
                            "es-pr",
                            "en-us",
                            "en-gb",
                            "en-ca",
                            "en-au",
                            "en-nz",
                            "en-ie",
                            "en-za",
                            "en-in",
                            "en-sg",
                            "en-my",
                            "en-ph",
                            "fr-fr",
                            "fr-ca",
                            "fr-be",
                            "fr-ch",
                            "fr-lu",
                            "de-de",
                            "de-at",
                            "de-ch",
                            "it-it",
                            "it-ch",
                            "pt-pt",
                            "nl-nl",
                            "nl-be",
                            "ru-ru",
                            "ru-ua",
                            "ru-by",
                            "ru-kz",
                            "ja-jp",
                            "ko-kr",
                            "zh-hk",
                            "ar-sa",
                            "ar-ae",
                            "ar-eg",
                            "ar-ma",
                            "ar-dz",
                            "ar-tn",
                            "ar-ly",
                            "ar-sd",
                            "ar-ye",
                            "ar-jo",
                            "ar-lb",
                            "ar-sy",
                            "ar-iq",
                            "ar-kw",
                            "ar-qa",
                            "ar-bh",
                            "ar-om",
                            "hi-in",
                            "th-th",
                            "vi-vn",
                            "id-id",
                            "ms-my",
                            "tl-ph",
                            "pl-pl",
                            "tr-tr",
                            "cs-cz",
                            "sv-se",
                            "da-dk",
                            "fi-fi",
                            "no-no",
                            "hu-hu",
                            "ro-ro",
                            "bg-bg",
                            "hr-hr",
                            "sk-sk",
                            "sl-si",
                            "et-ee",
                            "lv-lv",
                            "lt-lt",
                            "el-gr",
                            "he-il",
                            "fa-ir",
                            "ur-pk",
                            "bn-bd",
                            "ta-in",
                            "te-in",
                            "ml-in",
                            "kn-in",
                            "gu-in",
                            "pa-in",
                            "mr-in",
                            "ne-np",
                            "si-lk",
                            "my-mm",
                            "km-kh",
                            "lo-la",
                            "ka-ge",
                            "hy-am",
                            "az-az",
                            "kk-kz",
                            "ky-kg",
                            "uz-uz",
                            "mn-mn",
                            "be-by",
                            "uk-ua",
                            "mk-mk",
                            "sq-al",
                            "sr-rs",
                            "bs-ba",
                            "is-is",
                            "ga-ie",
                            "cy-gb",
                            "mt-mt",
                            "eu-es",
                            "ca-es",
                            "gl-es"
                        ],
                        "type": "string",
                        "description": "Pick a two-letter interface language code (ISO 639-1, lowercase). Optional."
                    },
                    "lr": {
                        "title": "Language Restriction",
                        "type": "string",
                        "description": "Restrict results to one or more languages (e.g., 'lang_en' or 'lang_en|lang_es'). Optional."
                    },
                    "tbs": {
                        "title": "Advanced Filters (tbs)",
                        "type": "string",
                        "description": "Apply advanced Google search filters via a raw tbs string. Optional. For power users who already know the tbs syntax."
                    },
                    "safe": {
                        "title": "Safe Search",
                        "enum": [
                            "active",
                            "off"
                        ],
                        "type": "string",
                        "description": "Safe search setting to filter explicit content. Optional.",
                        "default": "off"
                    },
                    "nfpr": {
                        "title": "Exclude Auto-corrected Results",
                        "enum": [
                            "0",
                            "1"
                        ],
                        "type": "string",
                        "description": "Exclude results from auto-corrected queries when the original query is misspelled. Optional.",
                        "default": "0"
                    },
                    "filter": {
                        "title": "Filter Duplicates",
                        "enum": [
                            "0",
                            "1"
                        ],
                        "type": "string",
                        "description": "Enable or disable duplicate content filtering. Optional.",
                        "default": "0"
                    },
                    "max_pages": {
                        "title": "Maximum Pages",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Set the maximum number of result pages to fetch. Use 0 for no limit (fetch all available pages). Default: 1. Each page is charged separately and returns about 10 short videos.",
                        "default": 1
                    },
                    "output_file": {
                        "title": "Output File",
                        "type": "string",
                        "description": "Name a JSON file to also save results to locally. Optional. Auto-generated from the query and timestamp if omitted."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
