# Google Video Search (Real-Time)

> Google Video Search (Real-Time) is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Searches Google Videos in real-time for any query and returns paginated video results with title, link, source, thumbnail, duration, published dates, and related searches.

## Facts

- Endpoint: GET https://agents.openwebninja.com/real-time-video-search/search?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-google-video-search-real-time-bcc32efa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_prdrMpeu-ta4fwAG-lj7X

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-google-video-search-real-time-bcc32efa
```

Example prompt: Search Google Videos for 'machine learning for beginners' tutorials published in the last month, sorted by relevance, and show me the first page of results in English for the US.

## When to prefer this

Use this endpoint when you need real-time Google Video search results with rich metadata including duration, thumbnail, and precise publish timestamps. Prefer this over general web search endpoints when the user specifically wants video content, or over static datasets when freshness and recency are important. Its date-range, duration, and country/language filters make it ideal for targeted media discovery tasks.

## Known failure modes

- Missing required 'query' parameter returns a validation error
- Using both 'time_period' (non-'any') and 'date_from'/'date_to' simultaneously returns an error
- Invalid country code or language code may return no results or an error
- Page number beyond available results returns an empty video array
- Network or upstream Google rate-limiting may cause transient failures

## How this service works

Search Google Videos for any query and get real-time video results. Returns video results with title, link, source info, thumbnail URL, duration (both human-readable string and seconds), and published dates (both localized relative text and ISO 8601 UTC), plus a list of related searches when available for the query. Supports pagination, filtering by time period or custom date range, video duration, country, language, sort order, and safe search.

## Output

Returns a JSON object containing an array of up to 10 video results per page, each with title, URL, source name, source URL, source favicon URL, thumbnail URL, human-readable duration, duration in seconds, localized published date text, and ISO 8601 UTC published datetime. Also includes a list of related search strings and echoed request parameters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "minimum": 1,
   "description": "Page number for pagination. Each page returns up to 10 video results.\n\n**Allowed values:** `1` and above."
  },
  "safe": {
   "enum": [
    "off",
    "active"
   ],
   "type": "string",
   "default": "off",
   "description": "Safe search setting to filter explicit content.\n\n**Allowed values:** `off`, `active`\n\n**Default:** `off`"
  },
  "query": {
   "type": "string",
   "description": "The video search query.\n\n**Examples:**\n\n`how to invest`\n\n`product demo software`\n\n`lebron james highlights`"
  },
  "country": {
   "type": "string",
   "default": "us",
   "description": "Country code of the country to return video results for. See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 for supported values.\n\n**Default:** `us`"
  },
  "date_to": {
   "type": "string",
   "description": "End date for a custom date range filter, in `MM/DD/YYYY` format. Must be provided together with `date_from`.\n\n**Example:** `04/29/2026`"
  },
  "sort_by": {
   "enum": [
    "relevance",
    "date"
   ],
   "type": "string",
   "default": "relevance",
   "description": "Sort order for the results.\n\n**Allowed values:** `relevance`, `date`\n\n**Default:** `relevance`"
  },
  "duration": {
   "enum": [
    "any",
    "short",
    "medium",
    "long"
   ],
   "type": "string",
   "default": "any",
   "description": "Filter results by video duration.\n\n**Allowed values:** `any`, `short` (under 4 minutes), `medium` (4 to 20 minutes), `long` (over 20 minutes)\n\n**Default:** `any`"
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "The language of the results, specified as a 2-letter language code - see ISO 639-1.\n\n**Default:** `en`"
  },
  "date_from": {
   "type": "string",
   "description": "Start date for a custom date range filter, in `MM/DD/YYYY` format. Must be provided together with `date_to`. Cannot be used together with `time_period` (other than `any`).\n\n**Example:** `01/01/2026`"
  },
  "time_period": {
   "enum": [
    "any",
    "last_hour",
    "last_day",
    "last_week",
    "last_month",
    "last_year"
   ],
   "type": "string",
   "default": "any",
   "description": "Filter results to a specific time period. Cannot be used together with `date_from`/`date_to`.\n\n**Allowed values:** `any`, `last_hour`, `last_day`, `last_week`, `last_month`, `last_year`\n\n**Defa
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "videos": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "link": {
        "type": "string"
       },
       "title": {
        "type": "string"
       },
       "source": {
        "type": "string"
       },
       "duration": {
        "type": "string"
       },
       "position": {
        "type": "integer"
       },
       "source_url": {
        "type": "string"
       },
       "thumbnail_url": {
        "type": "string"
       },
       "published_date": {
        "type": "string"
       },
       "duration_seconds": {
        "type": "integer"
       },
       "source_favicon_url": {
        "type": "string"
       },
       "published_datetime_utc": {
        "type": "string"
       }
      }
     }
    },
    "related_searches": {
     "type": "array",
     "items": {
      "type": "string"
     }
    }
   }
  },
  "status": {
   "type": "string"
  },
  "parameters": {
   "type": "object",
   "properties": {
    "page": {
     "type": "integer"
    },
    "safe": {
     "type": "string"
    },
    "query": {
     "type": "string"
    },
    "country": {
     "type": "string"
    },
    "date_to": {},
    "sort_by": {
     "type": "string"
    },
    "duration": {
     "type": "string"
    },
    "language": {
     "type": "string"
    },
    "date_from": {},
    "time_period": {
     "type": "string"
    }
   }
  },
  "request_id": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-google-video-search-real-time-bcc32efa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)