# FlashData Google Videos API

Google वीडियो के साथ वेबसाइटों में वीडियो खोजें। शीर्षक, वीडियो लिंक, थंबनेल, अवधि और स्रोत जानकारी पुनर्प्राप्त करें।

कैनोनिकल संदर्भ: https://flashdata.dev/hi/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/hi/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/hi/docs/reference/batch-and-bulk/reference.md#batch)

आवश्यक स्रोत अनुमति: google_videos

YOUR_API_KEY को API कुंजी के साथ बदलें जिसमें इस स्रोत की अनुमति और उपलब्ध क्रेडिट हैं। अपने सर्वर या एजेंट होस्ट पर अनुरोध चलाएं।

[प्रमाणीकरण सेट करें](https://flashdata.dev/hi/docs/guides/headers-and-authentication/reference.md)

[एक Google खोज को चुनें और परिष्कृत करें](https://flashdata.dev/hi/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 खोज ऑपरेटरों का समर्थन करता है: और intitle: न्यूनतम लंबाई: 1 अधिकतम लंबाई: 2000 |
| <a id="parameter-params"></a> params | object | नहीं | {} | इस अनुरोध के लिए Settings  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | नहीं | सेट नहीं | केवल Async और बैच। सार्वजनिक HTTPS पूरा होने URL बंदरगाह 443 पर, 2,048 वर्ण तक। कोई उपयोगकर्ता क्रेडेंशियल या URL खंड नहीं। Omit, उपयोग null या कोई अधिसूचना के लिए एक खाली स्ट्रिंग। एक बैच में, इसे प्रत्येक क्वेरी पर सेट करें, बाहर के पैराम।  |

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

### देश, भाषा और स्थान

| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | विवरण |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | नहीं | सेट नहीं | दो-अक्षर देश कोड, जैसे कि हम, जीबी, डी या एसजी। एक देश का चयन करने के लिए स्पष्ट रूप से सेट करें। न्यूनतम लंबाई: 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 एक निश्चित डिफ़ॉल्ट नहीं है जब omitted है। वापसी की गिनती क्वेरी और खोज प्रकार से भिन्न हो सकती है। न्यूनतम: 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. मूल क्षेत्रों के लिए unset छोड़ दें। Markdown या तो प्रतिक्रिया प्रारूप के साथ काम करता है।

Markdown वास्तविक समय के प्रश्नों और पूर्ण परिणाम के लिए उपलब्ध है।

नीचे दिए गए फ़ील्ड डिफ़ॉल्ट JSON प्रतिक्रिया का वर्णन करते हैं।

[अनुरोध और प्रतिक्रिया प्रारूप उदाहरण](https://flashdata.dev/hi/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/hi/docs/reference/realtime-and-async/reference.md#async)

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

- [नौकरी की स्थिति चेक करें](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#status)

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

- [प्राप्त करने के परिणाम](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON अनुरोध](https://flashdata.dev/hi/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/hi/docs/guides/async-batch/reference.md#webhooks)

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

## समस्या निवारण

- [त्रुटियाँ और स्टेटस कोड](https://flashdata.dev/hi/docs/errors/reference.md#status-codes)
- [कब्ज़ा](https://flashdata.dev/hi/docs/errors/reference.md#retries)

## संबंधित एपीआई

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