# Apify YouTube डेटा के लिए वैकल्पिक

FlashData की तुलना Apify YouTube अभिनेताओं से करें: अभिनेता-विशिष्ट मूल्य, मासिक उपयोग बजट, मेटाडेटा और कैप्शन वर्कफ़्लो, और चलाने योग्य Python और Bash माइग्रेशन उदाहरण।

एक्टर रन से लेकर डायरेक्ट वीडियो लुकअप तक। ज्ञात IDs से प्रारंभ करें, अपने एप्लिकेशन फ़ील्ड को सुरक्षित रखें और शेष पाइपलाइन को बदलने से पहले एक निर्माता को स्थानांतरित करें।

Apify तथ्यों की समीक्षा 2026-11-10. FlashData दरें और परीक्षण भत्ते इसके वर्तमान सार्वजनिक कैटलॉग का उपयोग करते हैं।

- [विशेषताएं](#features)
- [अभिनेता मूल्य निर्धारण](#actors)
- [लागत की तुलना करें](#costs)
- [एक लुकअप माइग्रेट करें](#migration)
- [डेटासेट और शेड्यूल](#production)
- [एआई एजेंटों के लिए](#agents)
- [अक्सर पूछे जाने वाले प्रश्न](#faq)

<a id="features"></a>
## सुविधाओं की तुलना

### लक्षित लुकअप को किफायती रखें

| विशेषता | FlashData | Apify YouTube अभिनेता |
| --- | --- | --- |
| बिना किसी मासिक सदस्यता के सशुल्क उपयोग | हाँ — भुगतान-जैसा-आप-जाओ क्रेडिट; $10 से टॉप-अप | मुफ़्त बजट, फिर सशुल्क योजना — $5/माह मुफ़्त में; Starter $19/माह $19 उपयोग के साथ |
| 1,000 ज्ञात वीडियो IDs के लिए मेटाडेटा | $0.50 — भुगतान-जैसी-आप-उपयोग दर | $3.00 — स्ट्रीमर्स/youtube-scraper · Starter दर, योजना के बजट से कटौती की गई |
| एक-वीडियो लुकअप | हाँ — एक स्पष्ट video_id | अभिनेता पर निर्भर — स्ट्रीमर्स इसका समर्थन करते हैं; API डोजो वर्तमान में एकल-वीडियो को बाहर करता है URLs |

### आपके ऐप के लिए आवश्यक वीडियो ढूंढें और समृद्ध करें

| विशेषता | FlashData | Apify YouTube अभिनेता |
| --- | --- | --- |
| खोज फ़िल्टर के साथ कीवर्ड खोज | हाँ — दिनांक, अवधि, प्रकार और छँटाई फ़िल्टर | हाँ — searchQueries प्लस सॉर्टिंग, दिनांक और वीडियो फ़िल्टर |
| शीर्षक, चैनल और सहभागिता डेटा | हाँ — वीडियो द्वारा समर्पित मेटाडेटा लुकअप ID | हाँ — अभिनेता डेटासेट में वीडियो रिकॉर्ड |
| मेटाडेटा को कैप्शन से अलग से ताज़ा करें | हाँ — रिफ्रेश के लिए केवल youtube_metadata का अनुरोध करें | हाँ — transcriptionAndSubtitle=NONE के साथ चलाएँ |

### अपने आवेदन के लिए कैप्शन साक्ष्य तैयार करें

| विशेषता | FlashData | Apify YouTube अभिनेता |
| --- | --- | --- |
| कई मौजूदा कैप्शन भाषाएँ चुनें | 10 तक स्पष्ट भाषाएँ — एक प्रतिलेख अनुरोध में प्रति-भाषा त्रुटियों को ट्रैक करता है | मुख्य अभिनेता: एक भाषा या कोई भी — अलग-अलग अभिनेता अलग-अलग इनपुट उजागर कर सकते हैं |
| एक सख्त कैप्शन मूल का चयन करें | अपलोडर या YouTube-जनरेट किया गया — params.auto एक मूल का चयन करता है; कोई क्रॉस-ओरिजिन फ़ॉलबैक नहीं | मुख्य अभिनेता: मूल प्राथमिकता — preferAutoGeneratedSubtitles एक प्राथमिकता है, वही अनुबंध नहीं |
| स्रोत उद्धरणों के लिए टाइमस्टैम्प्ड पाठ | सामान्यीकृत JSON खंड — सेकंड में प्रारंभ/end बार के साथ टेक्स्ट करें | एसआरटी, वीटीटी या एक्सएमएल उपशीर्षक — उद्धरण समय के लिए चयनित उपशीर्षक प्रारूप को पार्स करें |
| संक्षेपण के लिए सादा पाठ | fullText खंडों के साथ | सादा पाठ उपशीर्षक प्रारूप — या पार्स करें और समयबद्ध उपशीर्षक आउटपुट में शामिल हों |
| मौजूदा प्रतिलेख के बिना वीडियो | लापता ट्रैक की रिपोर्ट करें — कोई भाषण-से-पाठ पीढ़ी नहीं | वैकल्पिक एआई प्रतिलेखन — फ़ॉलबैक या हमेशा-ट्रांसक्राइब मोड; उपयोग शुल्क अलग |

### कम एकीकरण कोड के साथ वर्कफ़्लो चलाएँ

| विशेषता | FlashData | Apify YouTube अभिनेता |
| --- | --- | --- |
| अभिनेता संसाधनों का प्रबंधन किए बिना सीधा परिणाम | रीयलटाइम परिणाम[] + उपयोग — कोई एक्टर ID, बिल्ड या मेमोरी सेटिंग नहीं | अभिनेता रन + इनपुट स्कीमा — सिंक एंडपॉइंट एक HTTP कॉल में भी परिणाम लौटा सकता है |
| ब्राउज़र कंसोल में सहेजी गई सूची को संसाधित करें | Bulk Jobs एक वीडियो-ID फ़ाइल के साथ — प्रगति को ट्रैक करें और प्रकट और परिणाम भागों को पुनः प्राप्त करें | URL इनपुट के साथ अभिनेता कंसोल — CSV या Google शीट आयात का समर्थन करता है |
| क्लाइंट के डिस्कनेक्ट होने के बाद पृष्ठभूमि परिणाम | सहेजा गया async या थोक कार्य ID — स्थिति जांच फिर से शुरू करें और completed आउटपुट पुनर्प्राप्त करें | सहेजा गया एक्टर रन और डेटासेट IDs — रन का निरीक्षण करें और उसके डेटासेट आइटम पुनर्प्राप्त करें |
| एप्लिकेशन और एजेंट आउटपुट स्वरूप | JSON, सादा पाठ या Markdown | डेटासेट निर्यात — JSON, CSV, एक्सेल और अन्य प्रारूप |
| आवर्ती संग्रह | आपका शेड्यूलर या एजेंट होस्ट — स्वामी क्रेडेंशियल और सहेजी गई कार्य स्थिति का पुन: उपयोग करें | होस्ट किए गए अभिनेता शेड्यूल — क्रॉन, टाइमज़ोन सेटिंग्स और वैकल्पिक वेबहुक |
| मेटाडेटा, कैप्शन और Google एक API अनुबंध में खोजें | एक प्रश्न API, स्रोत-विशिष्ट अनुमतियाँ — साझा खाता शेष; स्रोत-विशिष्ट कीमतें | साझा मंच; अभिनेता-विशिष्ट स्कीमा — प्रासंगिक एक्टर इनपुट और आउटपुट चुनें और बनाए रखें |
| स्वचालन के लिए CLI, एसडीके और MCP | हाँ — स्टैंडअलोन CLI; Python, TypeScript और गो एसडीके; MCP | हाँ — Apify CLI, Python/JavaScript ग्राहक और MCP |

अभिनेता-विशिष्ट पंक्तियाँ स्ट्रीमर्स/youtube-scraper को संदर्भित करती हैं जब तक कि किसी अन्य अभिनेता का नाम न दिया गया हो। दोनों सेवाएँ SDK, CLI और MCP प्रदान करती हैं। Apify कस्टम कोड, होस्ट किए गए शेड्यूल और अन्य वेबसाइटों के स्क्रैपर्स भी चलाता है।

### एक-वीडियो लुकअप छोटा रखें

एक वीडियो पास करें ID और सीधे मेटाडेटा प्राप्त करें। जब नौकरी के लिए प्लेटफ़ॉर्म सदस्यता या चैनल क्रॉल की आवश्यकता न हो तो भुगतान-एज़-यू-गो एक्सेस का उपयोग करें।

### अपने एप्लिकेशन का डेटा मॉडल रखें

उन फ़ील्ड्स को मैप करें जिन्हें आपका ऐप वास्तव में पढ़ता है। null गिनती सुरक्षित रखें, प्रकाशन तिथियां स्पष्ट रखें और उन उपभोक्ताओं के लिए JSON सरणी सहेजें जो पहले डेटासेट आइटम पढ़ते हैं।

### खोज को संवर्धन से अलग रखें

एक उपयोगी खोज वर्कफ़्लो जारी रखें, इसके वीडियो IDs को डीडुप्लिकेट करें, फिर FlashData के साथ केवल उन वीडियो को समृद्ध करें जिनकी आपके उत्पाद को आवश्यकता है।

<a id="actors"></a>
## कोई एकल Apify YouTube कीमत नहीं है

अभिनेता लेखक इनपुट, आउटपुट और मूल्य निर्धारण मॉडल चुनते हैं। ये तीन अभिनेता प्रति-परिणाम घटनाओं का उपयोग करते हैं, लेकिन उनकी क्षमताएं अलग-अलग हैं। नीचे दिए गए मूल्य USD प्रति 1,000 लौटाए गए वीडियो हैं।

| अभिनेता | निःशुल्क / 1,000 वीडियो | Starter | Scale | Business | इसके लिए इसे चुनें |
| --- | --- | --- | --- | --- | --- |
| streamers/youtube-scraper | $4.00 | $3.00 | $2.60 | $2.40 | वीडियो URLs, खोज और वैकल्पिक मौजूदा उपशीर्षक। यह कैलकुलेटर का अभिनेता है. |
| streamers/youtube-channel-scraper | $1.30 | $1.00 | $0.80 | $0.50 | बुनियादी वीडियो डेटा के साथ चैनल खोज। यह एक मनमाना ID के लिए पूर्ण मेटाडेटा लुकअप नहीं है। |
| apidojo/youtube-scraper | $0.50 | $0.50 | $0.50 | $0.50 | डिस्कवरी इनपुट. इसके वर्तमान README में एकल-वीडियो URLs शामिल नहीं है और प्रति इनपुट कम से कम 10 वीडियो की आवश्यकता होती है। मुफ़्त डेमो: 5 रन/माह, अधिकतम 10 आइटम/run. |

स्व-सेवा मासिक योजनाएं: Starter से Bronze, Scale से Silver और Business से Gold तक के मानचित्र। सस्ते खोज अभिनेताओं को ज्ञात-वीडियो कैलकुलेटर में प्रतिस्थापित नहीं किया जाता है।

### बिल योग्य घटना की जाँच करें

Apify भुगतान-प्रति-घटना, भुगतान-प्रति-उपयोग और संयुक्त मॉडल का समर्थन करता है। स्ट्रीमर्स/youtube-scraper के लिए, परिणाम ईवेंट और चयनित ऐड-ऑन की गणना करें; स्वचालित रूप से सामान्य गणना शुल्क न जोड़ें। अपने स्वयं के एक्टर रन के इवेंट ब्रेकडाउन का निरीक्षण करें।

### मौजूदा उपशीर्षकों को एआई ट्रांसक्रिप्शन से अलग करें

मुख्य अभिनेता अपने परिणाम में मौजूदा उपशीर्षक शामिल कर सकता है। इसके एआई ट्रांसक्रिप्शन का बिल प्रति वीडियो शुरू होने वाले मिनट के हिसाब से किया जाता है: Starter पर, 10-मिनट का वीडियो $0.003 परिणाम इवेंट से पहले $0.41 जोड़ता है। एआई सारांश, विवरण और चैनल दिनांक फ़िल्टरिंग की भी अपनी ईवेंट कीमतें होती हैं। FlashData मौजूदा ट्रैक पुनर्प्राप्त करता है; यह लुप्त कैप्शन उत्पन्न नहीं करता है।

### खोज को संवर्धन से अलग रखें

ज्ञात वीडियो IDs का उपयोग करें जब यह आपके ऐप में पहले से मौजूद हो। एक डिस्कवरी क्रॉल उन वीडियो को लौटा सकता है जिनका आपने कभी उपयोग नहीं किया है। बजट की खोज और उसके बाद का कोई संवर्धन अलग से।

<a id="costs"></a>
## यूनिट दरों और मासिक शुल्क की तुलना करें

USD, मासिक सूची योजनाएँ। यह मॉडल स्ट्रीमर्स/youtube-scraper के परिणाम ईवेंट का उपयोग करता है, प्रति इनपुट एक लौटाया गया वीडियो ID, दिनांक फ़िल्टरिंग और एआई ऐड-ऑन बंद के साथ। मौजूदा उपशीर्षक इसकी ALWAYS_SUBTITLES सेटिंग का उपयोग करते हैं; मेटाडेटा प्लस कैप्शन एक अभिनेता परिणाम है लेकिन दो FlashData अनुरोध हैं। FlashData कीमतें इसके वर्तमान YouTube डेटा कैटलॉग से आती हैं। अतिरिक्त उपयोग जोड़ने से पहले प्रत्येक योजना की संपूर्ण सम्मिलित शेष राशि इस वर्कफ़्लो में आवंटित की जाती है। Apify इसके $5 बजट पर निःशुल्क स्टॉप; सशुल्क योजनाएं शामिल बजट से ऊपर उपयोग जोड़ती हैं। अतिरिक्त क्रेडिट की आवश्यकता होने पर शून्य बैलेंस से FlashData खरीदारी में इसका $10 न्यूनतम टॉप-अप शामिल होता है। कर, वार्षिक छूट, अन्य अभिनेता, अलग भंडारण/export शुल्क और failed प्रयास को बाहर रखा गया है। शून्य वीडियो पर, चयनित भुगतान योजना का अभी भी मासिक शुल्क है; प्रति वीडियो प्रभावी लागत अपरिभाषित है.

### Apify प्लेटफ़ॉर्म योजनाएँ

| Apify योजना | मासिक शुल्क | उपयोग/माह शामिल है | मुख्य अभिनेता / 1,000 वीडियो | इस बजट के भीतर वीडियो |
| --- | --- | --- | --- | --- |
| मुफ़्त | $0.00 | $5.00 | $4.00 | 1,250 |
| Starter | $19.00 | $19.00 | $3.00 | 6,333 |
| Scale | $199.00 | $199.00 | $2.60 | 76,538 |
| Business | $999.00 | $999.00 | $2.40 | 416,250 |

ये गणना बिना किसी ऐड-ऑन या अन्य प्लेटफ़ॉर्म उपयोग के परिणामी घटनाओं के लिए संपूर्ण बजट आवंटित करती है। यदि आप अन्य एक्टर्स के लिए Apify रखते हैं, तो इसकी सदस्यता बनी रहती है; अपने शेष बजट के विरुद्ध वृद्धिशील उपयोग की तुलना करें।

### FlashData YouTube डेटा प्लान

| FlashData योजना | प्रति 1,000 अनुरोध | मासिक शुल्क | हर महीने शामिल अनुरोध |
| --- | --- | --- | --- |
| उपयोग के अनुसार भुगतान | $0.50 | $0.00 | 0 |
| Micro | $0.40 | $49.00 | 125,000 |
| Starter | $0.35 | $199.00 | 571,428 |
| Pro | $0.30 | $499.00 | 1,666,666 |
| Scale | $0.25 | $999.00 | 4,000,000 |
| Business | $0.20 | $1,999.00 | 10,000,000 |

ये मानक YouTube डेटा दरें हैं। विस्तारित खोज और डाउनलोड की अलग-अलग कीमतें हैं। [पूरी मूल्य सूची](https://flashdata.dev/hi/pricing/youtube-data).

### काम के उदाहरण

FlashData भुगतान करें बनाम Apify Starter और स्ट्रीमर्स/youtube-scraper. मेटाडेटा प्लस मौजूदा उपशीर्षक एक अभिनेता परिणाम घटना है, लेकिन दो FlashData अनुरोध हैं। ये उपयोग और मासिक लागत अनुमान हैं, समान प्रतिक्रिया फ़ील्ड का दावा नहीं।

| वीडियो | कार्यप्रवाह | FlashData अनुरोध | FlashData प्रतिरूपित उपयोग | अभिनेता घटना उपयोग | Apify शुल्क सहित मासिक लागत |
| --- | --- | --- | --- | --- | --- |
| 1,000 | ज्ञात वीडियो के लिए मेटाडेटा IDs | 1,000 | $0.50 | $3.00 | $19.00 |
| 1,000 | मेटाडेटा + मौजूदा कैप्शन | 2,000 | $1.00 | $3.00 | $19.00 |
| 10,000 | ज्ञात वीडियो के लिए मेटाडेटा IDs | 10,000 | $5.00 | $30.00 | $30.00 |
| 10,000 | मेटाडेटा + मौजूदा कैप्शन | 20,000 | $10.00 | $30.00 | $30.00 |
| 100,000 | ज्ञात वीडियो के लिए मेटाडेटा IDs | 100,000 | $50.00 | $300.00 | $300.00 |
| 100,000 | मेटाडेटा + मौजूदा कैप्शन | 200,000 | $100.00 | $300.00 | $300.00 |

शून्य बैलेंस से FlashData खरीदारी पर न्यूनतम टॉप-अप $10 होता है। Apify के शुल्क में पहले से ही इसका सम्मिलित उपयोग शामिल है; उस उपयोग को दो बार न जोड़ें. HTML कैलकुलेटर आपको दोनों योजनाओं को स्वतंत्र रूप से चुनने की सुविधा देता है।

### नि:शुल्क प्रवेश

Apify मुफ़्त में $5 मासिक साझा बजट है; व्यक्तिगत अभिनेता डेमो प्रतिबंध भी लागू हो सकते हैं। ऊपर दिखाए गए API डोजो एक्टर की सीमा प्रति माह पांच डेमो रन और प्रति रन दस आइटम तक निःशुल्क है।

योग्य सत्यापित FlashData साइनअप 4,000 मानक YouTube डेटा अनुरोध तक प्रारंभिक भत्ता प्राप्त कर सकते हैं। यह मासिक रूप से रीसेट नहीं होता है.

<a id="migration"></a>
## डेटासेट रीडर रखें; एक लुकअप बदलें

किसी ज्ञात सार्वजनिक वीडियो ID से प्रारंभ करें। उदाहरण चयनित परिचित अभिनेता फ़ील्ड को JSON सरणी के रूप में लिखता है और संपूर्ण FlashData प्रतिक्रिया को अलग से सहेजता है।

### 1. पहुंच सेट करें और अनुरोध को मैप करें

[API कुंजियाँ](https://flashdata.dev/app/api-keys) में youtube_metadata अनुमति के साथ एक कुंजी बनाएं या पुन: उपयोग करें और [उपलब्ध क्रेडिट](https://flashdata.dev/app/billing) जांचें। एजेंटों को पहले पहुंच का पुन: उपयोग करना चाहिए, या योग्य परीक्षण का उपयोग करना चाहिए। चाबियाँ चैट के बाहर रखें.

माइग्रेशन संदर्भ के लिए मौजूदा अभिनेता कॉल:

```bash
# The existing Actor call, shown for migration reference.
curl --fail-with-body --silent --show-error --max-time 310 \
  --request POST \
  'https://api.apify.com/v2/acts/streamers~youtube-scraper/run-sync-get-dataset-items' \
  --header "Authorization: Bearer $APIFY_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"startUrls":[{"url":"https://www.youtube.com/watch?v=FUfGcZ092b0"}],
    "maxResults":1,"maxResultsShorts":0,"maxResultStreams":0,
    "transcriptionAndSubtitle":"NONE","aiVideoDescription":false,"aiVideoSummary":false}'
```

FlashData JSON POST /v1/queries/realtime: के लिए बॉडी

```json
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": true
  }
}
```

एक्टर सिंक एंडपॉइंट पहले से ही एक HTTP प्रतिक्रिया में आइटम लौटा सकता है। अनुरोध, लिफ़ाफ़ा और फ़ील्ड माइग्रेट करें; अनावश्यक मतदान न जोड़ें.

### 2. स्क्रिप्ट सहेजें, फिर उसे चलाएँ

Python या Bash चुनें। प्रत्येक नया आउटपुट फ़ोल्डर एक अनुरोध सबमिट करता है। फ़ोल्डर का पुन: उपयोग सहेजे गए आउटपुट को पढ़ता है; निरीक्षण के लिए बाधित या failed प्रयास रुकते हैं। दोनों संस्करण समान फ़ाइलों का उपयोग करते हैं।

#### Python

Python 3.10+ आवश्यक है। python -m pip install requests से आवश्यक पैकेज इंस्टॉल करें। नए कार्य फ़ोल्डर में नीचे दिया पूरा स्क्रिप्ट video-lookup.py नाम से सेव करें, फिर उसे चलाएँ।

```python
import argparse
import getpass
import json
import math
import os
import re
from pathlib import Path

import requests

parser = argparse.ArgumentParser()
parser.add_argument("video_id")
parser.add_argument("folder", type=Path)
args = parser.parse_args()
if not re.fullmatch(r"[A-Za-z0-9_-]{11}", args.video_id):
    raise SystemExit("Use an 11-character YouTube video ID")
body = {"source": "youtube_metadata", "video_id": args.video_id,
        "params": {"include_formats": False, "include_chapters": True}}
out = args.folder
if not out.exists():
    key = os.environ.get("FLASHDATA_API_KEY") or getpass.getpass("FlashData API key: ")
    if not key.strip():
        raise SystemExit("An API key is required")
    out.mkdir(parents=True)
    (out / "request.json").write_text(json.dumps(body), encoding="utf-8")
    try:
        response = requests.post(
            "https://data.flashdata.dev/v1/queries/realtime", json=body,
            headers={"X-API-Key": key, "Accept": "application/json"},
            timeout=120, allow_redirects=False,
        )
    except requests.RequestException:
        raise SystemExit("Outcome unknown. Keep this folder and check History before retrying.")
    (out / "response.json").write_bytes(response.content)
    (out / "http-status.txt").write_text(str(response.status_code), encoding="utf-8")
    (out / "retry-after.txt").write_text(response.headers.get("Retry-After", ""), encoding="utf-8")
else:
    print("Reading saved output; no API call.")

try:
    saved = json.loads((out / "request.json").read_text(encoding="utf-8"))
    status = (out / "http-status.txt").read_text(encoding="utf-8").strip()
except (OSError, ValueError):
    raise SystemExit("Incomplete attempt. Inspect this folder and History before retrying.")
if saved != body:
    raise SystemExit("This folder belongs to a different request. Use a new folder.")
if status != "200":
    raise SystemExit(f"HTTP {status}: inspect response.json and retry-after.txt")
data = json.loads((out / "response.json").read_text(encoding="utf-8"))
if not isinstance(data, dict) or data.get("status") != "done" or data.get("source") != body["source"]:
    raise SystemExit("Request did not complete successfully; inspect response.json")
items = data.get("results")
if not isinstance(items, list) or len(items) != 1 or not isinstance(items[0], dict):
    raise SystemExit("Expected one metadata result")
item = items[0]
if item.get("videoId") != args.video_id:
    raise SystemExit("Returned video does not match the request")
seconds = item.get("duration")
duration = None
if seconds is not None:
    if type(seconds) not in (int, float) or not math.isfinite(seconds) or seconds < 0:
        raise SystemExit("Invalid duration")
    whole = int(seconds)
    duration = f"{whole // 3600:02d}:{whole % 3600 // 60:02d}:{whole % 60:02d}"
mapped = [{
    "id": item["videoId"],
    "url": "https://www.youtube.com/watch?v=" + item["videoId"],
    "title": item.get("title"), "text": item.get("description"),
    "channelName": item.get("channel"), "channelId": item.get("channelId"),
    "viewCount": item.get("viewCount"), "likes": item.get("likeCount"),
    "commentsCount": item.get("commentCount"), "duration": duration,
    "uploadDateRaw": item.get("uploadDate"),
    "captionLanguages": item.get("transcriptLanguages"),
}]
(out / "dataset-items.json").write_text(
    json.dumps(mapped, ensure_ascii=False, indent=2) + "\n", encoding="utf-8"
)
print(f"Saved {out}/dataset-items.json; actual usage: {json.dumps(data.get('usage'))}")

```

अपने डेटासेट से सार्वजनिक वीडियो के साथ ID को प्रतिस्थापित करते हुए, उस फ़ोल्डर से चलाएँ:

```bash
python video-lookup.py FUfGcZ092b0 video-001
```

#### Bash

Bash, cURL 7.76+ और jq 1.6+ की आवश्यकता है। नीचे दी गई पूरी स्क्रिप्ट को अपने कार्यशील फ़ोल्डर में video-lookup.sh के रूप में सहेजें:

```bash
#!/usr/bin/env bash
set -euo pipefail
video_id="${1:?Use: VIDEO_ID OUTPUT_FOLDER}"
out="${2:?Set OUTPUT_FOLDER}"
[[ "$video_id" =~ ^[A-Za-z0-9_-]{11}$ ]] || { echo 'Invalid video ID' >&2; exit 1; }
body=$(jq -n --arg id "$video_id" '{source: "youtube_metadata", video_id: $id,
  params: {include_formats: false, include_chapters: true}}')
if [[ ! -e "$out" ]]; then
  if [[ -z "${FLASHDATA_API_KEY:-}" ]]; then
    read -r -s -p 'FlashData API key: ' FLASHDATA_API_KEY; printf '\n'
  fi
  : "${FLASHDATA_API_KEY:?An API key is required}"
  mkdir -p -- "$out"
  printf '%s\n' "$body" > "$out/request.json"
  curl --fail-with-body --silent --show-error --max-time 120 \
    --request POST 'https://data.flashdata.dev/v1/queries/realtime' \
    --header "X-API-Key: $FLASHDATA_API_KEY" \
    --header 'Content-Type: application/json' --header 'Accept: application/json' \
    --data-binary "@$out/request.json" --output "$out/response.json" \
    --dump-header "$out/response-headers.txt" --write-out '%{http_code}' \
    > "$out/http-status.txt" || {
      printf 'Request failed. Keep this folder and inspect History before retrying.\n' >&2
      exit 1
    }
else
  printf 'Reading saved output; no API call.\n'
fi
jq -e --argjson expected "$body" '. == $expected' "$out/request.json" >/dev/null
[[ "$(cat "$out/http-status.txt")" == 200 ]] || {
  printf 'Inspect the saved status, response and Retry-After header.\n' >&2; exit 1;
}
mapped=$(jq -e --arg id "$video_id" '
  def pad: tostring | if length < 2 then "0" + . else . end;
  def hms:
    if . == null then null
    elif type != "number" then error("Invalid duration")
    elif (isfinite | not) or . < 0 then error("Invalid duration")
    else floor | [(./3600 | floor | pad), ((.%3600)/60 | floor | pad), (.%60 | pad)] | join(":") end;
  if .source != "youtube_metadata" or .status != "done" then error("Request not done") else . end
  | .results | if type != "array" then error("Expected results")
    elif length != 1 then error("Expected one result") else .[0] end
  | if .videoId != $id then error("Wrong video") else . end
  | [{id: .videoId, url: ("https://www.youtube.com/watch?v=" + .videoId),
      title, text: .description, channelName: .channel, channelId,
      viewCount, likes: .likeCount, commentsCount: .commentCount,
      duration: (.duration | hms), uploadDateRaw: .uploadDate,
      captionLanguages: .transcriptLanguages}]' "$out/response.json")
printf '%s\n' "$mapped" > "$out/dataset-items.json"
printf 'Saved %s/dataset-items.json; actual usage: ' "$out"
jq -c '.usage' "$out/response.json"

```

उस फ़ोल्डर से चलाएँ:

```bash
bash video-lookup.sh FUfGcZ092b0 video-001
```

### 3. सहेजे गए आउटपुट को पढ़ें

वीडियो-001/dataset-items.json आपके एप्लिकेशन रीडर के लिए एक सरणी है। response.json मूल परिणाम और उपयोग रखता है। यह एक फ़ील्ड एडाप्टर है, Apify डेटासेट API नहीं। यह डेटासेट ID नहीं बनाता है, अज्ञात मेट्रिक्स को पॉप्युलेट नहीं करता है या टिप्पणियाँ या मुद्रीकरण फ़ील्ड नहीं बनाता है।

उदाहरणात्मक dataset-items.json:

```json
[
  {
    "id": "FUfGcZ092b0",
    "url": "https://www.youtube.com/watch?v=FUfGcZ092b0",
    "title": "Example video",
    "text": "Example description",
    "channelName": "Example channel",
    "channelId": "UC_EXAMPLE",
    "viewCount": 1200,
    "likes": null,
    "commentsCount": null,
    "duration": "00:03:17",
    "uploadDateRaw": "2025-01-15",
    "captionLanguages": [
      "en",
      "es"
    ]
  }
]
```

| मौजूदा अभिनेता क्षेत्र | FlashData मेटाडेटा | स्थानांतरण क्रिया |
| --- | --- | --- |
| आईडी/यूआरएल | videoId | आईडी रखें और विहित YouTube घड़ी URL बनाएं। |
| शीर्षक/पाठ | शीर्षक/विवरण | यदि आपका पाठक अभिनेता के क्षेत्र के नाम की अपेक्षा करता है तो विवरण को टेक्स्ट में मैप करें। |
| channelName / channelId | चैनल / channelId | नाम और ID सुरक्षित रखें. किसी चैनल हैंडल का उसके प्रदर्शन नाम से अनुमान न लगाएं। |
| पसंद / commentsCount / viewCount | likeCount / commentCount / viewCount | लुप्त मानों को null के रूप में रखें। एक लुप्त मीट्रिक शून्य नहीं है. |
| अवधि, अक्सर HH:MM:SS | अवधि सेकंड में | उदाहरण null को बनाए रखते हुए सेकंड को HH:MM:SS स्ट्रिंग में परिवर्तित करता है। |
| तिथि, जो पूर्ण या सापेक्ष हो सकती है | uploadDate | उदाहरण uploadDateRaw रखता है। सामान्यीकृत तिथि भरने से पहले अपना स्वयं का दिनांक पार्सर जोड़ें। |
| उपशीर्षक[] / transcriptionUrl | एक अलग youtube_transcript या youtube_captions अनुरोध | मौजूदा ट्रैक और उत्पन्न स्पीच-टू-टेक्स्ट आपके ऐप के लिए अलग-अलग इनपुट हैं। |
| अभिनेता-केवल संवर्धन क्षेत्र | कोई स्वचालित समकक्ष नहीं | टिप्पणियों, चैनल विस्तार और एआई-जनरेटेड विश्लेषण के लिए एक अलग संवर्धन चरण रखें। |

[मेटाडेटा स्कीमा](https://flashdata.dev/hi/docs/sources/youtube_metadata/reference.md).

### उपशीर्षक अभिप्राय को जारी रखें

| मुख्य अभिनेता इनपुट | FlashData प्रवास |
| --- | --- |
| ALWAYS_SUBTITLES | मौजूदा ट्रैक के लिए एक अलग youtube_transcript या youtube_captions अनुरोध जोड़ें। |
| subtitlesLanguage | params.language का प्रयोग करें. 10 तक की भाषाओं की एक श्रृंखला ट्रैक के साथ-साथ प्रति-भाषा त्रुटियाँ भी लौटाती है। |
| preferAutoGeneratedSubtitles | यह एक प्राथमिकता है. FlashData params.auto क्रॉस-ऑरिजिन फ़ॉलबैक के बिना, YouTube-जेनरेटेड या अपलोडर द्वारा प्रदत्त कैप्शन का सख्ती से चयन करता है। |
| TRANSCRIPTION_AS_FALLBACK / ALWAYS_TRANSCRIBE | भाषण-से-पाठ को अलग रखें; FlashData गुम ट्रैक उत्पन्न नहीं करता है। |
| उपशीर्षक[].srt / transcriptionUrl | टाइमस्टैम्प्ड सेगमेंट को मैप करें या फ़ाइल को स्पष्ट रूप से प्रारूपित करें। उत्पन्न सादा-पाठ URL एक टाइमस्टैम्प्ड खंड सरणी नहीं है। |

[टाइमस्टैम्प वाले कैप्शन का उदाहरण](https://flashdata.dev/hi/docs/guides/timestamped-captions-recipe/reference.md).

<a id="production"></a>
## डेटासेट, लंबी-running नौकरियां और शेड्यूल

यदि आपके उपकरण Apify डेटासेट IDs और शेड्यूल पर निर्भर हैं, तो ऑर्केस्ट्रेटर के रूप में एक कस्टम एक्टर रखें: इसके अंदर FlashData को कॉल करें और मैप किए गए आइटम को इसके डेटासेट में लिखें। FlashData उपयोग के साथ अभिनेता के रनटाइम और स्टोरेज का बजट। उपरोक्त कैलकुलेटर सीधे FlashData कॉल मॉडल करता है।

| चिंता | Apify | FlashData |
| --- | --- | --- |
| निवेदन | अभिनेता ID + बिल्ड/input विकल्प; वैकल्पिक सहेजा गया कार्य | स्रोत + video_id + पैरामीटर; कोई एक्टर बिल्ड या मेमोरी विकल्प नहीं |
| तुल्यकालिक परिणाम | रन-सिंक-गेट-डेटासेट-आइटम एक आइटम सरणी लौटाता है; इसकी प्रलेखित HTTP सीमा 300 सेकंड है | रीयलटाइम प्रतिक्रिया में स्थिति, परिणाम[] और उपयोग होता है; फ़ील्ड मैप करने से पहले परिणाम निकालें |
| लंबा-running काम | रन प्रारंभ करें, रन ID सहेजें, टर्मिनल स्थिति की प्रतीक्षा करें, defaultDatasetId पढ़ें | async या batch कार्य सबमिट करें, उसका ID सहेजें, उसकी स्थिति का सर्वेक्षण करें और उसका परिणाम पुनः प्राप्त करें |
| आउटपुट भंडारण | डेटासेट आइटम और URL द्वारा संदर्भित वैकल्पिक कुंजी-मूल्य रिकॉर्ड | प्रतिक्रिया सहेजें या अपने स्वयं के टिकाऊ भंडारण में निर्यात करें; एक Apify डेटासेट ID एक FlashData कार्य नहीं है ID |
| आवर्ती कार्य | Apify शेड्यूल प्रारंभ अभिनेता/Tasks; वेबहुक डाउनस्ट्रीम उपभोक्ताओं को सूचित करते हैं | FlashData पर कॉल करने के लिए अपने एप्लिकेशन, क्रॉन, सीआई या एजेंट होस्ट का उपयोग करें; शेड्यूल और उपभोक्ता को एक साथ स्थानांतरित करें |

### किसी मौजूदा डेटासेट को स्थानांतरित करें

उत्पादकों को बदलने से पहले मौजूदा डेटासेट के प्रत्येक पृष्ठ को निर्यात करें। संदर्भित उपशीर्षक फ़ाइलें जिनकी आपको अभी भी आवश्यकता है, जारी रखें। केवल पहले से एकत्र किए गए आउटपुट को डाउनलोड करने के लिए किसी एक्टर को दोबारा न चलाएं।

[नतीजे सेव करें और दोबारा उपयोग करें](https://flashdata.dev/hi/docs/guides/save-results/reference.md)

### वीडियो लाइब्रेरी ताज़ा करें

वीडियो को डुप्लिकेट करें IDs, प्रत्येक परिणाम को चेकपॉइंट करें और इनपुट-टू-आउटपुट IDs रखें। बड़ी सूचियों के लिए बैच या बल्क प्रोसेसिंग का उपयोग करें; failed आइटमों की त्रुटियों का निरीक्षण करने के बाद पुनः प्रयास करें।

[बल्क प्रोसेसिंग संदर्भ](https://flashdata.dev/hi/docs/reference/bulk-processing/reference.md)

### निर्धारित कार्य को पूर्वानुमानित रखें

समयक्षेत्र, ताल, क्रेडेंशियल्स और अपने आउटपुट गंतव्य को साथ रखें। पुराने निर्माता को सेवानिवृत्त करने से पहले एक completed शेड्यूल विंडो रिकॉर्ड करें, ताकि ओवरलैपिंग शेड्यूल डुप्लिकेट कार्य न बनाएं।

[आवर्ती कार्य चलाएँ](https://flashdata.dev/hi/docs/guides/recurring-tasks/reference.md)

### कटओवर चेकलिस्ट

1. सटीक अभिनेता, निर्माण, कार्य इनपुट, बिल योग्य घटनाएं, आउटपुट फ़ील्ड और डाउनस्ट्रीम उपभोक्ता रिकॉर्ड करें।
2. मौजूदा रन हटाएं और सभी डेटासेट पेज निर्यात करें। क्लीन=true रिकॉर्ड को छोड़ सकता है, इसलिए केवल एक छोटा पृष्ठ इस बात का प्रमाण नहीं है कि निर्यात पूरा हो गया है; पेजिनेशन मेटाडेटा की जाँच करें।
3. एडॉप्टर को सहेजे गए IDs के विरुद्ध सत्यापित करें, जिसमें null मेट्रिक्स, दिनांक और कैप्शन मूल शामिल हैं।
4. ताल, समय क्षेत्र और गंतव्य को अपने धावक में ले जाएँ। चौकियाँ रखें. maxTotalChargeUsd FlashData API-मुख्य व्यय सीमा नहीं है; एप्लिकेशन-स्तरीय व्यय नियंत्रण जोड़ें।
5. डुप्लिकेट रन के बिना अगली शेड्यूल विंडो के लिए निर्माता को स्विच करें। निर्यात को सुरक्षित रखें. निरस्त क्रेडेंशियल्स या अपर्याप्त शेष पर बार-बार काम करना बंद करें।

<a id="agents"></a>
## कोडिंग और व्यक्तिगत एजेंट

योग्य एजेंट 72 घंटों के लिए 1 credit (100 मानक YouTube डेटा अनुरोध तक) से शुरू कर सकते हैं। मेटाडेटा और कैप्शन भत्ता साझा करते हैं।

1. अभिनेता एकीकरण की पहचान करें और पहले मौजूदा FlashData क्रेडेंशियल का पुन: उपयोग करें।
2. एक वीडियो लुकअप साबित करें और वास्तविक उपयोग के साथ कच्चे और मैप किए गए आउटपुट दोनों को सहेजें।
3. स्वामी साइन इन या साइन अप करता है, ईमेल सत्यापित करता है और दावे, दायरे और साझा-शेष पहुंच को मंजूरी देता है। अप्रयुक्त परीक्षण क्रेडिट स्थानांतरित नहीं होते.
4. आवर्ती उपयोग के लिए स्वामी का प्रमाण पत्र बनाए रखें। निरसन पर रोक; नए परीक्षण मत बनाओ.

```text
Replace this project's Apify YouTube metadata lookup with FlashData.
Read https://flashdata.dev/auth.md and https://flashdata.dev/docs/sources/youtube_metadata/reference.md.
Identify the exact Actor ID, build, input, output fields, schedule and storage consumer first.
Reuse a saved FlashData credential or start one eligible trial with youtube_metadata permission.
Run one known video ID. Save the raw response, actual usage and a mapped JSON item array.
Keep null metrics and preserve the raw publication date. Do not invent Actor-only fields.
Keep channel discovery, comments, AI transcription and hosted scheduling separate unless explicitly migrated.
Reuse saved results after restart. Ask the owner to claim before recurring use and store keys outside chat.
Stop after revocation or insufficient balance; never create more trials to continue.
```

[ट्रायल और खाते से लिंक करना](https://flashdata.dev/hi/docs/guides/agent-onboarding/reference.md) · [स्टैंडअलोन CLI](https://flashdata.dev/hi/docs/guides/flashdata-cli/reference.md) · [MCP सेटअप](https://flashdata.dev/hi/docs/integrations/mcp-clients/reference.md)

<a id="faq"></a>
## इससे पहले कि आप स्विच करें

### क्या यह Apify प्लेटफ़ॉर्म का प्रतिस्थापन है?

यह आपके वर्कफ़्लो में विशिष्ट YouTube डेटा कॉल को प्रतिस्थापित करता है। Apify एक एक्टर मार्केटप्लेस, कस्टम रनटाइम, होस्टेड शेड्यूल और स्टोरेज भी प्रदान करता है। उन हिस्सों को वहीं रखें जहां आप उनका उपयोग करते हैं, या उनकी ज़िम्मेदारियों को अपने स्वयं के अनुप्रयोग में स्थानांतरित करें।

### हर अभिनेता की तुलना एक कीमत पर क्यों नहीं की जाती?

अभिनेता डेवलपर्स विभिन्न मूल्य निर्धारण मॉडल, आउटपुट और इनपुट प्रतिबंध चुनते हैं। कैलकुलेटर स्ट्रीमर्स का उपयोग करता है/youtube-scraper. अभिनेता तालिका में एक सस्ता खोज अभिनेता भी शामिल है; ऑन-डिमांड लुकअप को प्रतिस्थापित करते समय इसके एकल-वीडियो प्रतिबंध मायने रखते हैं।

### क्या Apify सदस्यता सम्मिलित उपयोग के लिए दो बार चार्ज करती है?

नहीं, योजना शुल्क में प्रीपेड उपयोग बजट शामिल है। आगे एक्टर का उपयोग जोड़ने से पहले कैलकुलेटर उस बजट को घटा देता है। यह मानता है कि इस वर्कफ़्लो के लिए पूरा बजट उपलब्ध है। यदि अन्य अभिनेता इसका उपभोग करते हैं, तो YouTube कम बचता है।

### क्या मैं Apify डेटासेट उपभोक्ता रख सकता हूँ?

उदाहरण चयनित परिचित फ़ील्ड नामों के साथ JSON सरणी लिखता है। यह Apify डेटासेट नहीं बनाता है या ID नहीं चलाता है। नई फ़ाइल को सीधे पढ़ें, इसे अपने स्वयं के स्टोरेज के माध्यम से प्रकाशित करें, या एक कस्टम एक्टर रखें जो आपके मौजूदा उपभोक्ता के लिए इन मैप किए गए आइटम को अपने डेटासेट में लिखता है।

### उपशीर्षक और AI प्रतिलेखन का क्या होता है?

Apify का मुख्य अभिनेता मौजूदा उपशीर्षक और वैकल्पिक एआई ट्रांसक्रिप्शन प्रदान करता है। FlashData मौजूदा YouTube ट्रैक पुनर्प्राप्त करता है। मेटाडेटा और कैप्शन का अलग से अनुरोध करें, लौटाई गई भाषा और मूल की जांच करें, और किसी भी भाषण-से-पाठ या एआई सारांश चरण को अलग रखें।

### क्या मेरा मौजूदा शेड्यूल या रन खर्च सीमा स्थानांतरित हो जाएगी?

नहीं, अपने चुने हुए रनर में शेड्यूल दोबारा बनाएं, और एक एप्लिकेशन-स्तरीय बजट जांच जोड़ें। Apify maxTotalChargeUsd सेटिंग FlashData API-कुंजी व्यय सीमा नहीं है। स्वामी कुंजियाँ साझा खाता शेष का उपयोग करती हैं।
