# FlashData Google Videos API

Video video di seluruh situs web dengan Google Videos. Mengambil judul, video link, thumbnail, durasi dan informasi sumber.

Referensi boonical: https://flashdata.dev/ms/docs/sources/google_videos
Diulas: 2026-10-23

Titik akhir Ukur: POST https://data.flashdata.dev/v1/queries/realtime
Pengesahan: X-API-Key: YOUR_API_KEY
Mode: [Realtime](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/ms/docs/reference/batch-and-bulk/reference.md#batch)

Izin sumber yang dibutuhkan: google_videos

Megantikan YOUR_API_KEY dengan kunci API yang memiliki izin sumber ini dan kredit yang tersedia. Permintaan run run pada server atau agen host anda.

[Otentikasi Gagal](https://flashdata.dev/ms/docs/guides/headers-and-authentication/reference.md)

[Pilih dan perbaiki pencarian Google](https://flashdata.dev/ms/docs/guides/google-search-guide/reference.md)

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

## Upn permintaan

### 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>

## Parameter

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

### Badan permintaan

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ya | — | Ditetapkan untuk google_videos.  |
| <a id="parameter-query"></a> query | string | Ya | Tidak Diset | Pertanyaan pencarian. Sogodis Supports Google operator pencarian seperti situs: dan judul:. Panjang Min: 1. Panjang maksimum: 2000. |
| <a id="parameter-params"></a> params | object | Tak ada | {} | Settings untuk permintaan ini.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Tak ada | Tidak Diset | Async dan hanya kelumpuhan. Kompisi HTTPS publik URL pada port 443, hingga karakter 2,048. Kelayakan pengguna tidak ada atau fragmen URL. Omit, gunakan null atau string kosong tanpa pemberitahuan. Dalam kelompok, set ini pada setiap pertanyaan, param luar.  |

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

### Kampung, bahasa & lokasi

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Tak ada | Tidak Diset | Kode negara dua huruf, seperti kita, gb, de atau sg. Diatur secara eksplisit untuk memilih sebuah negara. Panjang Min: 2. Panjang maksimum: 2. Corak: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Tak ada | Tidak Diset | Google Bahasa antarmuka jaringan. [ Gambar di hlm. Panjang Min: 1. Panjang maksimum: 35. Corak: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Tak ada | Tidak Diset | Yang diminta untuk mencari lokasi, lebih baik sebuah kota, seperti "London, England, United Kingdom". Ketersediaan tergantung pada jenis pencarian. Panjang Min: 1. Panjang maksimum: 200. |

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

### Kepinaran

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Tak ada | Tidak Diset | Hasil yang diminta dihitung. FlashData tidak menambahkan default tetap ketika diabaikan. Angka yang dikembalikan dapat berbeda menurut pertanyaan dan jenis pencarian. Minimal: 1. Maximum: 100. |
| <a id="parameter-params-page"></a> params.page | integer | Tak ada | Tidak Diset | Halaman hasil yang dimintakan untuk diminta. Set secara eksplisit. Setiap halaman adalah permintaan API yang terpisah. Minimal: 1. Maximum: 100. |

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

### penapis pencarian fanfan

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Tak ada | Tidak Diset | FANFA yang diminta filter pencarian Google, seperti qdr:d untuk hari terakhir atau qdr:w untuk minggu terakhir. Ketersediaan tergantung pada jenis pencarian. Panjang Min: 1. Panjang maksimum: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Tak ada | Tidak Diset | Permintaan koreksi ejaan dengan trueQ atau meminta dinon-aktifkan dengan false. Perilaku yang diterapkan berdasarkan tipe pencarian; mengabaikan untuk menggunakan perilaku Google.  |

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

## Baca hasilnya

Simpan respon JSON yang sukses sebagai response.json. Simpan ini sebagai read-response.py dan jalankan python read-response.py. Ini hanya menggunakan perpustakaan standar Python dan tidak membuat permintaan baru.

### 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))
```

## Contoh respons

Contoh terrekam; bidang dan hitungan bergantung pada sumber dan masukan yang diminta.
```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"
}
```

## Medan tanggapan palsu

| Ukrainian | Jenis | Keterangan |
| --- | --- | --- |
| source | string | Sumber API yang diminta. |
| status | string | Hal ini dilakukan ketika permintaan realtime berhasil. |
| created_at | string | Waktu penciptaan responsi kreasi dalam format ISO 8601. |
| usage.credits | number | Penghargaan atas permintaan itu, berdasarkan rencanamu. |
| results[0].searchParameters | object | Pengaturan pencarian visier dilaporkan oleh Google, dengan pertanyaan yang dicatat sebagai q. Pengaturan yang dikembalikan dapat berbeda dengan nilai yang diminta. |
| results[0].videos | array | Hasil pencarian video dari Google. |
| results[0].videos[].title | string | Video judul. |
| results[0].videos[].link | string | Halaman video URL. |
| results[0].videos[].snippet | string · optional | Penjelasan video kutipan. |
| results[0].videos[].duration | string · optional | Durasi video yang diformat. |
| results[0].videos[].source | string · optional | Situs web Hosting OFN. |
| results[0].videos[].channel | string · optional | Penerbit atau nama saluran. |
| results[0].videos[].date | string · optional | Tanggal penerbitan seperti yang ditampilkan oleh Google. |
| results[0].videos[].imageUrl | string · optional | thumbnail video URL. |
| results[0].videos[].position | integer | Posisi hasil. |
| results[0].videos[].videoUrl | string · optional | Video URL dilaporkan oleh Google bila tersedia. |

- Bidang-bidang yang tersedia tergantung pada jenis pertanyaan dan pencarian. Medan opsional mungkin tidak ada, dan ladang tambahan mungkin dikembalikan.
- Jumlah barang yang dikembalikan dan searchParameters.num dapat berbeda dengan params.num. Anda menggunakan susunan yang dikembalikan untuk menentukan jumlah hasil yang sebenarnya.

## Format respons

Sambutan menggunakan JSON secara default. Memikul format lain dengan header opsional ini.

- Accept: application/json (default) OR atau ORANG text/plain. Teks Plain menyajikan bidang yang sama dalam tata letak yang dapat dibaca dan diindentasi.
- X-Respond-With: markdown. Jangan sampai tidak sesuai dengan bidang asli. Markdown bekerja dengan baik format respon.

Markdown tersedia untuk pertanyaan waktu nyata dan hasil selesai.

Bidang-bidang di bawah ini menggambarkan respon JSON baku.

[Contoh format permintaan dan tanggapan](https://flashdata.dev/ms/docs/guides/response-formats/reference.md#headers)

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

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

## Asas API

Waaswan permintaan pembangun dan contoh di atas menggunakan parameter sumber ini. Andaikata menggunakan contoh Python dan cURL di bawah ini untuk penyerahan bersama, status dan langkah hasil. Tubuh Batch adalah sebuah objek JSON yang berisi kueri; setiap item mengembalikan pekerjaannya sendiri ID.

- [Permintaan dan penerimaan Async](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#async)

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

- [Periksa status pekerjaan](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#status)

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

- [Hasil yang telah selesai](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#results)
- [Permintaan Batch JSON](https://flashdata.dev/ms/docs/reference/batch-and-bulk/reference.md#batch)
- [BukaAPI Pelanggan oleh:](https://flashdata.dev/docs/openapi.json)

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

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

## Pemberitahuan penyelesaian hasil Pengundian

- [Terima dan sahkan pelengkapan webhooks](https://flashdata.dev/ms/docs/guides/async-batch/reference.md#webhooks)

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

## Penerjemahan Masalah

- [Ralat dan kod status](https://flashdata.dev/ms/docs/errors/reference.md#status-codes)
- [Bila hendak mencoba lagi](https://flashdata.dev/ms/docs/errors/reference.md#retries)

## API yang berkaitan dengan anak - anak

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