# Python SDK Quickstart

Python SDK स्थापित करें और कुछ लाइनों के कोड के साथ खोज परिणाम प्रिंट करें। तुल्यकालिक और asyncio उदाहरण शामिल हैं।

कैनोनिकल संदर्भ: https://flashdata.dev/hi/docs/guides/flashdata-python
समीक्षित: 2026-11-04 द्वारा FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-python) — स्रोत और SDK संदर्भ
- [API कुंजी लें](https://flashdata.dev/app/api-keys) — कंसोल में एक कुंजी बनाएं

<a id="application"></a>

## अपना पहला Python अनुरोध बनाएं

SDK स्थापित करें, अपनी API कुंजी सेट करें और एक खोज चलायें। उत्तर डिफ़ॉल्ट रूप से Python शब्दकोश हैं।

- [Python SDK संदर्भ](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)
- [PyPI](https://pypi.org/project/flashdata/1.1.0/)

<a id="install"></a>

### SDK स्थापित करें

Python 3.10+ की आवश्यकता है। अपनी परियोजना डायरेक्टरी में इन कमांडों को चलाएं। पहले से ही आभासी वातावरण का उपयोग कर? Flashdata==1.1.0 को उस वातावरण के python-m pip के बजाय स्थापित करें।

#### Linux / macOS

##### इंस्टॉल करें

```bash
python3 -m venv .venv
.venv/bin/python -m pip install "flashdata==1.1.0"
```


#### Windows PowerShell

##### इंस्टॉल करें

```powershell
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install "flashdata==1.1.0"
```


- [स्थापित करें Python](https://www.python.org/downloads/)

<a id="key"></a>

### प्रमाणीकरण

Google Search अनुमति के साथ एक API कुंजी बनाएं, या एक अधिकृत कुंजी का पुन: उपयोग करें। इस टर्मिनल में इसे नीचे छिपे हुए प्रॉम्प्ट का उपयोग करके सेट करें।

यदि FLASHDATA_API_KEY पहले से ही सेट किया गया है तो यह संकेत छोड़ दें। इन उदाहरणों में वेरिएबल को सीधे पढ़ा जाता है; वे .env फ़ाइलों को लोड नहीं करते हैं।

#### Bash

##### छिपे हुए कुंजी संकेत Bash

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```


#### PowerShell 7

##### छिपे हुए कुंजी संकेत PowerShell

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```


- [खाता बनाएँ](https://flashdata.dev/signup)
- [API Keys खोलें](https://flashdata.dev/app/api-keys)
- [ओपन Billing](https://flashdata.dev/app/billing)
- [एजेंट परीक्षण सेटअप](https://flashdata.dev/hi/docs/guides/agent-onboarding/reference.md)

<a id="query"></a>

### खोज चलाएँ

इसे quickstart.py के रूप में सहेजें, फिर इसे उसी आभासी वातावरण के साथ चलाएं। यह पांच परिणाम और प्रिंट शीर्षक, URLs और क्रेडिट के लिए एक Google Search अनुरोध बनाता है।

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.search("battery recycling research", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    for page in response["results"]:
        for hit in page.get("organic", []):
            print(hit["title"], hit["link"])
    print("Credits used:", response["usage"]["credits"])
```

#### Linux / macOS

##### चलाएँ

```bash
.venv/bin/python quickstart.py
```


#### Windows PowerShell

##### चलाएँ

```powershell
.\.venv\Scripts\python.exe quickstart.py
```



<a id="result"></a>

### परिणाम जाँचें

सामान्य रूप से स्थिति की जांच के बाद स्क्रिप्ट बाहर निकलती है। स्रोत शीर्षक और URLs के बाद क्रेडिट्स का प्रयोग किया जाता है। एक खाली कार्बनिक सूची एक वैध प्रतिक्रिया है; परिणाम आपके क्वेरी के साथ भिन्न होते हैं।

| फील्ड | उपयोग |
| --- | --- |
| results[].organic[] | Google Search हिट: शीर्षक, लिंक और स्निपेट। अन्य सूत्रों में अलग परिणाम क्षेत्र होते हैं। |
| usage.credits | इस अनुरोध की लागत। यहां तक कि पांच परिणाम एक खोज अनुरोध है। |

#### उदाहरण

```text
Battery recycling research https://example.org/recycling
Credits used: 0.02
```


<a id="common-tasks"></a>

## एक और डेटा स्रोत आज़माएं

प्रत्येक टैब एक पूर्ण स्क्रिप्ट है। quickstart.py को एक उदाहरण के साथ बदलें और इसे कदम 3 से कमांड के साथ चलाएं। प्रत्येक रन एक नया अनुरोध प्रस्तुत करता है; कुंजी को दिखाया गया स्रोत अनुमति की आवश्यकता होती है।

### Google समाचार

google_news की आवश्यकता है। results[].news[] से लेख शीर्षक और स्रोत लिंक प्रिंट करता है।

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.news("battery recycling", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    for page in response["results"]:
        for article in page.get("news", []):
            print(article.get("title"), article.get("link"))
```


### YouTube मेटाडाटा

youtube_metadata की आवश्यकता है। वीडियो शीर्षक, चैनल और अवधि को सेकंड में प्रिंट करता है। जिस वीडियो में आप निरीक्षण करना चाहते हैं उसके साथ वीडियो ID को बदलें।

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.youtube.metadata("dQw4w9WgXcQ", include_formats=False)
    if response["status"] != "done":
        raise RuntimeError(response)
    for video in response["results"]:
        print(video.get("title"), video.get("channel"))
        print("Seconds:", video.get("duration"))
```


### YouTube ट्रांसक्रिप्ट

youtube_transcript की आवश्यकता है। results[].fullText. से एक मौजूदा अंग्रेजी स्वचालित ट्रांसक्रिप्ट प्रिंट करता है वीडियो में वह ट्रैक होना चाहिए; यह कॉल कैप्शन उत्पन्न या अनुवाद नहीं करता है।

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.youtube.transcript("dQw4w9WgXcQ", language="en", auto=True)
    if response["status"] != "done":
        raise RuntimeError(response)
    for track in response["results"]:
        print(track.get("fullText", ""))
```


- [सभी स्रोत विधियों और मापदंडों](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/sources/index.md)

<a id="features"></a>

## क्या Python SDK समर्थन करता है

| उपयोग | SDK प्रविष्टि बिंदु |
| --- | --- |
| google / youtube | Google Search, समाचार, चित्र, खरीदारी, वीडियो और स्थान; YouTube खोज, मेटाडाटा, कैप्शन, ट्रांसक्रिप्ट और चैनल डेटा। |
| youtube.download | अपने क्लाउड स्टोरेज के लिए ऑडियो या वीडियो डिलीवरी का काम सबमिट करें। youtube_download अनुमति और भंडारण विन्यास की आवश्यकता है; नीचे पूर्ण डाउनलोड उदाहरण का पालन करें। |
| jobs / bulk | स्वीकृत नौकरी ID सेव करें, पूर्ण होने और परिणाम प्राप्त करने की प्रतीक्षा करें। बड़े वीडियो-ID डेटासेट के लिए थोक का उपयोग करें और एक पुनरारंभ के बाद मौजूदा नौकरियों को फिर से शुरू करें। |
| account | आवर्ती कार्य से पहले पहुंच, संतुलन, मूल्य निर्धारण, सीमा और उपयोग पढ़ें। अपने पर्यावरण या गुप्त स्टोर से अधिकृत कुंजी का पुन: उपयोग करें। |
| respond_with / accept | का प्रयोग करें respond_with="markdown" for Markdown in उत्तर ["content"], या स्वीकार = "text/plain" for a string. JSON शब्दकोश डिफ़ॉल्ट हैं। |

- [पूर्ण Python डाउनलोड उदाहरण](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/examples/youtube_download.py)
- [डाउनलोड संग्रहण को कॉन्फ़िगर करें](https://flashdata.dev/hi/docs/guides/youtube-download-guide/reference.md)
- [Python प्रतिक्रिया प्रारूप](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/response-formats.md)

<a id="asyncio"></a>

## Asyncio का उपयोग करें

इस संस्करण के साथ quickstart.py बदलें और उसी रन कमांड का उपयोग करें। AsyncFlashData एक ही संसाधन को इंतजार के साथ उजागर करता है। यह अभी भी एक वास्तविक समय खोज प्रतिक्रिया के लिए इंतजार करता है; mode="async" इसके बजाय सर्वर-साइड पृष्ठभूमि नौकरी जमा करता है।

Jupyter या एक चल घटना पाश के साथ एक आवेदन में, asyncio.run (मुख्य) के बजाय मुख्य () का इंतजार कर रहा है। उस घटना लूप के भीतर क्लाइंट का पुन: उपयोग करें।

### quickstart.py

```python
import asyncio
import os
from flashdata import AsyncFlashData

async def main():
    async with AsyncFlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = await client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])

asyncio.run(main())
```

- [Async क्लाइंट कॉन्फ़िगरेशन](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/client.md)

<a id="next"></a>

## अगला कदम

- [लेखा जांच और सहेजे गए परिणाम](https://flashdata.dev/hi/docs/guides/sdk-operations/reference.md)
- [पृष्ठभूमि नौकरियां और बैच](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/jobs.md)
- [Bulk डेटासेट](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/bulk.md)
- [SDK विधि संदर्भ](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)

<a id="errors"></a>

## यदि कोई कदम विफल हो जाता है

| समस्या | फिक्स |
| --- | --- |
| ModuleNotFoundError | उसी अनुवादक के साथ स्थापित और चलाएं: .venv/bin/python -m pip शो फ्लैशडाटा (Windows: .\.venv\Scripts\python.exe -m pip show flashdata)। अपने स्क्रिप्ट flashdata.py नाम नहीं है। |
| KeyError: FLASHDATA_API_KEY / 401 | उसी टर्मिनल में एक सक्रिय API कुंजी सेट करें। अकेले एक फ़ाइल इस उदाहरण से लोड नहीं है। एक API कुंजी का उपयोग करें, एक MCP OAuth टोकन नहीं। |
| 403 | इस कुंजी के लिए उदाहरण द्वारा आवश्यक स्रोत अनुमति देना। |
| 402 | उपलब्ध क्रेडिट के लिए Billing की जाँच करें। यदि परीक्षण का उपयोग समाप्त हो जाता है, तो अपने खाते की शेष राशि का उपयोग करने के लिए कनेक्शन का दावा करें। |
| 429 / APIError | निरीक्षण error.retry_after और अनुरोध दर को कम करें। SDK प्रत्येक अनुरोध को एक बार भेजता है और स्वचालित रूप से पुनः प्राप्त नहीं करता है। |
| SubmissionUnknownError | एक समयबद्ध प्रस्तुतीकरण पहले से ही स्वीकार किया जा सकता है। इसे दोहराने से पहले History की जाँच करें; उपलब्ध होने पर एक बचाया नौकरी ID का पुनः उपयोग करें। |
| asyncio.run() / running event loop | एक नोटबुक या मौजूदा घटना लूप में मुख्य () का उपयोग करें। एक स्टैंडअलोन स्क्रिप्ट के लिए asyncio.run (मुख्य) रखें। |

- [अनुरोध इतिहास](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [Python त्रुटियों और वसूली](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/errors.md)
