# Google Videos

Search and scrape video results from Google.

- **Documentation:** [https://scrappa.co/docs/google-videos-api/google_videos](https://scrappa.co/docs/google-videos-api/google_videos)
- **API group:** Google Videos API
- **Endpoint:** `GET https://scrappa.co/api/google/videos`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | string | Yes | Search term for videos |
| `google_domain` | string | No | Google domain to query (e.g. google.com, google.de). |
| `gl` | string | No | Country code for geographic targeting (2 letters, e.g. de). |
| `safe` | string | No | SafeSearch: active or off. |
| `nfpr` | integer | No | Set to 1 to disable automatic spelling correction, 0 to allow it. |
| `filter` | integer | No | Set to 1 to omit near-duplicate results (default), 0 to keep them. |
| `page` | integer | No | Page number (starts at 1). |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/google/videos?q=tutorial"
```

## Example response

```json
{
    "search_information": {
        "video_results_state": "Results for exact spelling",
        "query_displayed": "coffee"
    },
    "video_results": [
        {
            "position": 1,
            "title": "Coffee Brewing Tutorial",
            "link": "https://www.youtube.com/watch?v=example",
            "displayed_link": "www.youtube.com > watch",
            "thumbnail": "https://i.ytimg.com/vi/example/hqdefault.jpg",
            "snippet": "Learn how to brew coffee step by step.",
            "duration": "12:34",
            "date": "3 days ago",
            "video_link": "https://www.google.com/url?q=https://www.youtube.com/watch?v=example",
            "rich_snippet": {
                "top": {
                    "extensions": [
                        "YouTube",
                        "Epicurious",
                        "2 weeks ago"
                    ],
                    "detected_extensions": {
                        "weeks_ago": 2
                    }
                }
            },
            "key_moments": [
                {
                    "time": "00:00",
                    "title": "Intro",
                    "link": "https://www.youtube.com/watch?v=example&t=0s"
                },
                {
                    "time": "02:30",
                    "title": "Equipment Setup",
                    "link": "https://www.youtube.com/watch?v=example&t=150s"
                }
            ]
        }
    ],
    "found_in_videos": [
        {
            "position": 1,
            "title": "Coffee Brewing Guide",
            "link": "https://www.youtube.com/watch?v=found1",
            "thumbnail": "https://i.ytimg.com/vi/found1/hqdefault.jpg",
            "key_moment": {
                "time": "02:34",
                "title": "Grinding the beans"
            },
            "channel": "Coffee Channel"
        }
    ],
    "short_videos": [
        {
            "position": 1,
            "title": "Quick Coffee Tips",
            "source": "YouTube",
            "thumbnail": "https://i.ytimg.com/vi/short1/hqdefault.jpg",
            "clip": "https://www.youtube.com/shorts/short1",
            "link": "https://www.youtube.com/shorts/short1",
            "extensions": [
                "YouTube",
                "Barista Pro"
            ],
            "profile_name": "Barista Pro"
        }
    ],
    "search_parameters": {
        "engine": "google_videos",
        "q": "coffee",
        "google_domain": "google.com",
        "hl": "en",
        "gl": "us",
        "safe": "off"
    },
    "pagination": {
        "current": 1
    },
    "scrappa_pagination": {
        "current": 1
    },
    "related_searches": []
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The query, locale, filter, or pagination parameters failed validation. |
| 503 | Google Videos Upstream Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)