# Google Videos

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/google/videos` |
| **Base URL** | `https://api.autom.dev` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/google-videos |

## Description

Scrape video results from Google Videos search including YouTube, Reddit, and other video platforms, with location and language support.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.autom.dev/register

## Example Request

```bash
curl --location --request GET 'https://api.autom.dev/v2/google/videos' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search 'paris travel guide'. YouTube results

```json
{
  "organic_results": [
    {
      "date": "Jan 23, 2026",
      "link": "https://www.youtube.com/watch?v=pkBQBEtPlHE",
      "title": "The Only Paris Travel Guide You'll Ever Need (2026)",
      "domain": "www.youtube.com",
      "source": "YouTube",
      "channel": "Destination Well Known",
      "snippet": "Don't visit Paris before you've watched this complete Paris travel guide I've created the ultimate Paris guide for first-time visitors ...",
      "duration": "26:20",
      "position": 1,
      "video_id": "pkBQBEtPlHE",
      "displayed_link": "www.youtube.com",
      "snippet_matched": [
        "guide",
        "paris",
        "travel"
      ]
    },
    {
      "date": "May 30, 2025",
      "link": "https://www.youtube.com/watch?v=GLKPfHVdYSU",
      "title": "Paris According to Locals | What to Do, See & Eat in Paris",
      "domain": "www.youtube.com",
      "source": "YouTube",
      "channel": "The Tour Guy",
      "snippet": "Forget the tired advice from travel guides: here's what locals actually recommend.",
      "duration": "14:02",
      "position": 2,
      "video_id": "GLKPfHVdYSU",
      "displayed_link": "www.youtube.com",
      "snippet_matched": [
        "paris",
        "travel"
      ]
    },
    {
      "date": "Mar 7, 2025",
      "link": "https://www.youtube.com/watch?v=63N38fKU3C0",
      "title": "27 Tips I Wish I Knew Before Visiting Paris",
      "domain": "www.youtube.com",
      "source": "YouTube",
      "channel": "Camden David",
      "snippet": "Here's the exact list I share with friends visiting Paris.",
      "duration": "12:00",
      "position": 3,
      "video_id": "63N38fKU3C0",
      "displayed_link": "www.youtube.com",
      "snippet_matched": [
        "guide",
        "paris",
        "travel"
      ]
    }
  ],
  "search_parameters": {
    "q": "paris travel guide",
    "gl": "us",
    "hl": "en",
    "num": 10,
    "page": 1,
    "uule": null,
    "engine": "google_videos",
    "location": null
  }
}
```

### Search 'machine learning tutorial': educational content

```json
{
  "organic_results": [
    {
      "date": "Sep 26, 2022",
      "link": "https://www.youtube.com/watch?v=i_LwzRVP7bg",
      "title": "Machine Learning for Everybody – Full Course",
      "domain": "www.youtube.com",
      "source": "YouTube",
      "channel": "freeCodeCamp.org",
      "snippet": "A professional developer studying Cyber-Sec at the Master's level found the first hour of the tutorial to be incredibly comprehensive.",
      "duration": "3:53:53",
      "position": 1,
      "video_id": "i_LwzRVP7bg",
      "displayed_link": "www.youtube.com",
      "snippet_matched": [
        "tutorial"
      ]
    },
    {
      "date": "Jun 16, 2025",
      "link": "https://www.youtube.com/watch?v=JnxUsIeTJsM",
      "title": "Machine Learning Full Course 2026 | Machine Learning Tutorial",
      "domain": "www.youtube.com",
      "source": "YouTube",
      "channel": "Simplilearn",
      "snippet": "IITK - Professional Certificate Course in Generative AI and Machine Learning.",
      "duration": "11:40:29",
      "position": 2,
      "video_id": "JnxUsIeTJsM",
      "displayed_link": "www.youtube.com",
      "snippet_matched": [
        "machine",
        "learning"
      ]
    },
    {
      "date": "Sep 17, 2020",
      "link": "https://www.youtube.com/watch?v=7eh4d6sabA0",
      "title": "Python Machine Learning Tutorial (Data Science)",
      "domain": "www.youtube.com",
      "source": "YouTube",
      "channel": "Programming with Mosh",
      "snippet": "Foundational machine learning concepts, how to apply algorithms using Python, and working with real-world data.",
      "duration": "49:43",
      "position": 3,
      "video_id": "7eh4d6sabA0",
      "displayed_link": "www.youtube.com",
      "snippet_matched": [
        "machine",
        "learning"
      ]
    }
  ],
  "search_parameters": {
    "q": "machine learning tutorial",
    "gl": "us",
    "hl": "en",
    "num": 5,
    "page": 1,
    "uule": null,
    "engine": "google_videos",
    "location": null
  }
}
```

## Documentation

## Overview
Scrape video search results from Google Videos for any query. Returns video title, URL, channel, duration, publication date, and platform source.

## Quickstart
```
POST https://api.piloterr.com/v2/google/videos
Content-Type: application/json

{"query": "paris travel guide", "gl": "us", "hl": "en"}
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The video search query |
| `location` | string | no | City-level location |
| `gl` | string | no | 2-letter country code |
| `hl` | string | no | 2-letter language code |
| `page` | integer | no | Page number for pagination |
| `num` | integer | no | Results per page (default: 10) |

## Main use cases
- Discover top-performing video content for competitive video SEO analysis
- Build video content intelligence pipelines to track trending videos
- Monitor brand coverage across YouTube and other video platforms
- Identify high-performing channels for influencer marketing research