# FlashData Google Videos API

Знайдіть відео через веб-сайти з Google Відео. Отримати заголовки, відеозв'язки, ескізи, тривалість і вихідна інформація.

Канонічне посилання: https://flashdata.dev/uk/docs/sources/google_videos
Відгук: 2026-10-23

Навігація: POST https://data.flashdata.dev/v1/queries/realtime
Автентифікація: X-API-Key: YOUR_API_KEY
Режими: [Realtime](https://flashdata.dev/uk/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/uk/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/uk/docs/reference/batch-and-bulk/reference.md#batch)

Обов'язковий дозвіл на джерело: google_videos

Замініть YOUR_API_KEY з ключем API, який має дозвіл на джерело та доступні кредити. Виконайте запити на сервер або агент.

[Налаштування автентичності](https://flashdata.dev/uk/docs/guides/headers-and-authentication/reference.md)

[Оберіть та рефінансуйте пошук Google](https://flashdata.dev/uk/docs/guides/google-search-guide/reference.md)

<a id="quickstart"></a>

## Надіслати запит

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "google_videos",
    "query": "me at the zoo",
    "params": {
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries/realtime" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "google_videos",
  "query": "me at the zoo",
  "params": {
    "gl": "us",
    "hl": "en",
    "num": 10,
    "page": 1
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## Параметри

<a id="parameters-group-0"></a>

### Тіло запиту

| Параметр | Типи | Обов’язково | За замовчуванням | Опис |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | ТОЙ | — | Набір до google_videos.  |
| <a id="parameter-query"></a> query | string | ТОЙ | Не встановити | Пошук запитів. Підтримує оператори Google, такі як сайт: і в назві: Мінімальна довжина: 1. Максимальна довжина: 2000. |
| <a id="parameter-params"></a> params | object | Ні | {} | Settings для цього запиту.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Ні | Не встановити | Async і партії тільки. Public HTTPS завершена URL на порту 443, до 2,048 символів. Немає облікових даних користувача або фрагмента URL. Omit, використовуйте null або порожній рядок для повідомлення. У партії, встановивши це на кожному запиту, за межами парам.  |

<a id="parameters-group-1"></a>

### Країна, мова та місце розташування

| Параметр | Типи | Обов’язково | За замовчуванням | Опис |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Ні | Не встановити | Двомісний код країни, наприклад, нам, gb, de або sg. Визначте явно для вибору країни. Мінімальна довжина: 2. Максимальна довжина: 2. Візерунок: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Ні | Не встановити | Google мова інтерфейсу. Налаштуйте явно для вибору мови. Мінімальна довжина: 1. Максимальна довжина: 35. Візерунок: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Ні | Не встановити | Запрошення місця пошуку, бажано місто, таких як "London, England, United Kingdom". Наявність залежить від типу пошуку. Мінімальна довжина: 1. Максимальна довжина: 200. |

<a id="parameters-group-2"></a>

### Пігментація

| Параметр | Типи | Обов’язково | За замовчуванням | Опис |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Ні | Не встановити | Заявка на результат. FlashData не додає фіксованого за замовчуванням при в'язанні. Повернутий рахунок може відрізнятися за типом запиту і типом пошуку. Мінімальне: 1. Максимальна потужність: 100. |
| <a id="parameter-params-page"></a> params.page | integer | Ні | Не встановити | Заявка на результат сторінки. Встановити явно. Кожна сторінка - окремий запит API. Мінімальне: 1. Максимальна потужність: 100. |

<a id="parameters-group-3"></a>

### Фільтри для пошуку

| Параметр | Типи | Обов’язково | За замовчуванням | Опис |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Ні | Не встановити | Заява Google пошук фільтрів, таких як qdr:d для минулого дня або qdr:w за минулий тиждень. Наявність залежить від типу пошуку. Мінімальна довжина: 1. Максимальна довжина: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Ні | Не встановити | Заявка на виправлення заклинання з true або запитом її вимкнено з false. Застосовується поведінка залежить від типу пошуку; для використання поведінки Google.  |

<a id="response"></a>

## Читати результат

Збережіть успішну відповідь JSON як response.json. Збережіть це як read-response.py і запустіть python read-response.py. Використовуються тільки Python- стандартна бібліотека і не дає нового запиту.

### read-response.py

```python
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = [
    {"title": item.get("title"), "url": item.get("link"), "duration": item.get("duration")}
    for item in result.get("videos", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## Приклад відповіді

Зареєстрований приклад; поля та підрахунки залежать від джерела та запитуваного введення.
```json
{
  "source": "google_videos",
  "status": "done",
  "results": [
    {
      "searchParameters": {
        "q": "me at the zoo",
        "gl": "us",
        "hl": "en",
        "type": "videos",
        "num": 10,
        "page": 1,
        "engine": "google"
      },
      "videos": [
        {
          "title": "Me at the zoo",
          "link": "https://www.youtube.com/watch?v=jNQXAC9IVRw&vl=en",
          "snippet": "Microplastics are accumulating in human brains at an alarming rate https://www.youtube.com/watch?v=0PT5c1z3LL8 “Nanoplastics and Human ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNoybJBMfqr7vwH-saySvflZreMzBKZDBjW_zQMrY81E-xQZBBMzVuRw&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcS8uZHJMduuLjzsxqOtyhx8VWeRlui2Fo0sUg",
          "duration": "0:19",
          "source": "YouTube",
          "channel": "jawed",
          "date": "Apr 23, 2005",
          "position": 1
        },
        {
          "title": "Me at the zoo - 20 Years Later",
          "link": "https://www.youtube.com/watch?v=ydEMNzksm2M",
          "snippet": "A FAN RECREATION. same location. same outfit kinda sorta. different guy. 20 years later @jawed New video: https://youtu.be/vRgvdCkzvws How ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR8mNQG1XbHxQwXcM0_B0L3wpgVPSmORnijKhh5knB2aRxvmApdoyigXw&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcR1ZyuOVJiBgaK96Ew85Bx19aYKLXddf-dcDQ",
          "duration": "0:45",
          "source": "YouTube",
          "channel": "Cody Hales",
          "date": "Apr 23, 2025",
          "position": 2
        },
        {
          "title": "Me at the zoo",
          "link": "https://youtube.com/watch?v=jNQXAC9IVRw&si=EnSIkaIECMiOmarE",
          "snippet": "Microplastics are accumulating in human brains at an alarming rate https://www.youtube.com/watch?v=0PT5c1z3LL8 “Nanoplastics and Human ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNoybJBMfqr7vwH-saySvflZreMzBKZDBjW_zQMrY81E-xQZBBMzVuRw&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcS8uZHJMduuLjzsxqOtyhx8VWeRlui2Fo0sUg",
          "duration": "0:19",
          "source": "YouTube",
          "channel": "jawed",
          "date": "Apr 23, 2005",
          "position": 3
        },
        {
          "title": "Me at the Zoo 21 Years Later",
          "link": "https://www.youtube.com/watch?v=NiIqMwDDPQQ",
          "snippet": "YouTube's First Video: Me at the zoo by Jawed Karim in 2005 A Look back some history of Youtube's creation and what happened to the ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSELgaIiAXmIin2tym4YpTtUt3a9LT66r3qpMkg3Cm2erBOcUc_cOzfxQ&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcRSNKT2ukHk51PE2iHMpOXn0Fk-NYYzcjdtzg",
          "duration": "2:37",
          "source": "YouTube",
          "channel": "AcidGlow",
          "date": "Apr 26, 2026",
          "position": 4
        },
        {
          "title": "Me at the Zoo | 20 years of YouTube",
          "link": "https://www.youtube.com/watch?v=SKcXEYqsX1M",
          "snippet": "20 years ago, the first video was uploaded to YouTube, by Jawed. This is my remake of that first video uploaded to YouTube back on 23rd ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRYk6-MZVYhxJohW4sXDVRGWjqp796KjEJgWqKeZtfQAhCtMkyiVfVVjQ&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcSPcbOknGe09bBsfDEZ8OJXxOnYAFxeiMzRIg",
          "duration": "1:40",
          "source": "YouTube",
          "channel": "Alice Goss Travel",
          "date": "Apr 22, 2025",
          "position": 5
        },
        {
          "title": "happy 20th birthday YouTube! on this day, 2005, the first ever ...",
          "link": "https://www.facebook.com/lestwinsforsmartpeople/videos/happy-20th-birthday-youtube-on-this-day-2005-the-first-ever-video-was-uploaded-t/1174885864134048/",
          "snippet": "❤ on this day, 2005, the first ever video was uploaded to YouTube: \"Me at the Zoo\" by Jawed Karim, one of the founders of YouTube. I opened my ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQXK7QFFc7Ve5rxWu28XVD7PwN4wMGxFwBGODfb0inSiJkJXkLfspNBBQ&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcQwaWPOAa18cvUeFQmJ83tHI75KwkZZXhcz1g",
          "duration": "0:20",
          "source": "Facebook",
          "channel": "Les Twins for smart people",
          "date": "Apr 23, 2025",
          "position": 6
        },
        {
          "title": "23rd April 2005: The first video uploaded to YouTube is \"Me at ...",
          "link": "https://www.youtube.com/watch?v=nW0JMJUW394&vl=en",
          "snippet": "... Me at the zoo” shows Karim speaking in front of the elephant enclosure at the San Diego Zoo in San Diego, California. The video lasts ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQKL5tOeVLTkPnKgGJ-irZeBKXegrS3jv3aOmqfPRvnDnFDH0wlm6KTsQ&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcT32pM4ScwLqW8pW44XEj6g02KCXVGZZU12oA",
          "duration": "2:30",
          "source": "YouTube",
          "channel": "HistoryPod",
          "date": "Apr 22, 2026",
          "position": 7
        },
        {
          "title": "Me at the zoo",
          "link": "https://www.youtube.com/shorts/bXz16dux7j0",
          "snippet": "Maybe it's time to go back to the zoo?",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTKNATyMcisc3lfWovvV89H6Pgk2EMqkA4wPBgN3hwB2D9r4c0vzj9qog&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcRo2eKznhm-_ijvAmb_52BgREvjyQVWcJ5arQ",
          "duration": "0:17",
          "source": "YouTube",
          "channel": "Timeworks",
          "date": "Apr 23, 2025",
          "position": 8
        },
        {
          "title": "Me At The Zoo",
          "link": "https://www.youtube.com/watch?v=SfSsDBEs1yc",
          "snippet": "Me At The Zoo • 20th Anniversary (24/04/2025) a huge shoutout to 'Me at the zoo' today as it becomes the first video on @YouTube to be 20 ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ6BBRlx150FgR3w89enIZwuSIm7gumK0O-yC7GqO_KF0zr8ZIGuNANHA&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcSG5JQlJ3MiAYkmoTPoE-KLNrrS6rkWyAkJWw",
          "duration": "0:26",
          "source": "YouTube",
          "channel": "MrHaydnSir",
          "date": "Apr 24, 2025",
          "position": 9
        },
        {
          "title": "The first ever YouTube video, \"Me at the zoo\", turns 21 years ...",
          "link": "https://www.reddit.com/r/interesting/comments/1su0btj/the_first_ever_youtube_video_me_at_the_zoo_turns/",
          "snippet": "The first ever YouTube video, \"Me at the zoo\", turns 21 years old today. ... This video cannot be played. 0:00 0: ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR2us_fh54LqB7h_F3viDdnV4PCbByjapkYj5JO8I6SoErU3NPFrY5tYw&s",
          "duration": "0:18",
          "source": "Reddit",
          "channel": "Deleted User",
          "date": "Apr 24, 2026",
          "position": 10
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  },
  "created_at": "2026-09-16T07:41:45.419Z"
}
```

## Поля зворотнього зв'язку

| Поле | Типи | Опис |
| --- | --- | --- |
| source | string | За запитом джерело API. |
| status | string | в режимі реального часу, якщо в реальному часі буде досягнуто запит. |
| created_at | string | Час створення відповіді в форматі ISO 8601. |
| usage.credits | number | Кредит, що стягується за запит, виходячи з тарифного плану. |
| results[0].searchParameters | object | Параметри пошуку, які були опубліковані Google, з запитом, записаним як q. Повернуті налаштування можуть відрізнятися від заданих значень. |
| results[0].videos | array | Результати пошуку відео з Google. |
| results[0].videos[].title | string | Назва відео. |
| results[0].videos[].link | string | Відео сторінка URL. |
| results[0].videos[].snippet | string · optional | Відео опис ЕКСТРАЦІЯ. |
| results[0].videos[].duration | string · optional | Форматовані тривалість відео. |
| results[0].videos[].source | string · optional | Веб-сайт. |
| results[0].videos[].channel | string · optional | Видавництво або ім'я каналів. |
| results[0].videos[].date | string · optional | Дата публікації, як відображається Google. |
| results[0].videos[].imageUrl | string · optional | Відео мініатюра URL. |
| results[0].videos[].position | integer | Результатів пошуку. |
| results[0].videos[].videoUrl | string · optional | Відео URL повідомляє Google. |

- Доступні поля залежать від типу запиту та пошуку. Можливі додаткові поля, які можуть бути повернені.
- Кількість відправлених предметів і searchParameters.num може відрізнятися від params.num. Використовуйте повернуті масиви для визначення фактичного результату.

## Формати відповідей

Відповіді використовуйте JSON за замовчуванням. Виберіть інший формат з цими заголовками.

- Accept: application/json (За замовчуванням) або text/plain. Плайн-фактура представляє ті ж поля, які можна прочитати, відступивши макет.
- X-Respond-With: markdown. Залиште заявку на оригінальні поля. Markdown працює з форматом відповіді.

Markdown доступна для запитів в режимі реального часу і завершених результатів.

На полях нижче описано відповідь JSON.

[Приклади форматів запиту та відповіді](https://flashdata.dev/uk/docs/guides/response-formats/reference.md#headers)

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## Основи API

На прикладі конструктора запиту та прикладів, які вище використовують параметри цього джерела. Використовуйте Python і cURL прикладів нижче для спільного подання, стану та кроків результату. Корпус Batch є об'єктом JSON, що містить запити; кожен елемент повертає свою власну роботу ID.

- [Async запит та отримання](https://flashdata.dev/uk/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [Перевірити статус роботи](https://flashdata.dev/uk/docs/reference/realtime-and-async/reference.md#status)

<a id="job-results"></a>

- [Результати пошуку](https://flashdata.dev/uk/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON запитів](https://flashdata.dev/uk/docs/reference/batch-and-bulk/reference.md#batch)
- [Клієнт OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## Повідомлення про видалення

- [Отримувати і перевірити завершення вебхуки](https://flashdata.dev/uk/docs/guides/async-batch/reference.md#webhooks)

<a id="troubleshooting"></a>

## Виправлення несправностей

- [Помилки й коди стану](https://flashdata.dev/uk/docs/errors/reference.md#status-codes)
- [Коли птиця](https://flashdata.dev/uk/docs/errors/reference.md#retries)

## Схожі API

- [YouTube Search API](https://flashdata.dev/uk/docs/sources/youtube_search/reference.md)
- [Google Search API](https://flashdata.dev/uk/docs/sources/google_search/reference.md)
