सीधे सामग्री पर जाएँ
HI
API कुंजी प्राप्त करें
दस्तावेज़ देखें

API संदर्भ

MCP टूल और स्कीमा

FlashData MCP उपकरण तर्क, डिफ़ॉल्ट, खाता पढ़ने, नौकरी की स्थिति और परिणाम पुनर्प्राप्ति को देखें।

इस पेज पर

Markdown संस्करण

OAuth, Codex, OpenClaw और API-key Access विकल्प

अपने MCP क्लाइंट को चुनें और कनेक्ट करें

परिवहन और प्रमाणीकरण

होस्ट किए गए MCP एंडपॉइंट स्ट्रीमेबल HTTP का उपयोग करता है। API-key कनेक्शन X-API-Key भेजते हैं; उपकरण का उपयोग कुंजी के स्रोत अनुमतियों और उपलब्ध क्रेडिटों का अनुसरण करता है।

स्ट्रीमिंग HTTP
URL: https://data.flashdata.dev/mcp
X-API-Key: <your API key>

क्लाइंट के क्रेडेंशियल कॉन्फ़िगरेशन में अपने वास्तविक FlashData API कुंजी को स्टोर करें। इसे बातचीत या टूल तर्क में न डालें। यह खंड API-key कनेक्शन को कवर करता है; एजेंट एक्सेस गाइड OAuth लॉगिन और परीक्षण किए गए Codex और OpenClaw कॉन्फ़िगरेशन को कवर करता है। youtube_download उपयुक्त API-key अनुमति के साथ अतुल्यकालिक मीडिया डाउनलोड का समर्थन करता है।

प्रबंधित करें API कुंजी

क्वेरी उपकरण

आपका ग्राहक कुंजी द्वारा दिए गए उपकरणों की खोज करता है। सभी छह Google और आठ YouTube डेटा उपकरण वास्तविक समय में डिफ़ॉल्ट हैं और mode: async को भी स्वीकार करते हैं। submit_batch दोनों समूहों का समर्थन करता है। youtube_download औपचारिक डाउनलोड API का उपयोग करता है, ग्राहक भंडारण की आवश्यकता होती है, और Async नौकरियों या submit_batch का समर्थन करता है। मॉडल कार्य के लिए उपकरण चुन सकते हैं और जोड़ सकते हैं।

Google

google_search · google_images · google_news · google_shopping · google_videos · google_places

YouTube

youtube_search · youtube_search_extended · youtube_metadata · youtube_transcript · youtube_captions · youtube_trainability · youtube_channel · youtube_suggestions · youtube_download

google_search · तर्क JSON
{
  "query": "MCP protocol",
  "num": 3,
  "gl": "us",
  "hl": "en",
  "mode": "async"
}

उपकरण तर्क

REST API's params आवरण के बिना सीधे उपकरण के तर्क ऑब्जेक्ट में क्वेरी, संख्या, भाषा और मोड जैसे क्वेरी फ़ील्ड डालें। एक क्वेरी टूल का नाम अपने स्रोत का चयन करता है; केवल submit_batch में प्रविष्टियों को स्रोत की आवश्यकता होती है। API कुंजी और callback_url उपकरण तर्क नहीं हैं। नीचे JSON उदाहरण client.callTool({ name, तर्क }) के लिए तर्क वस्तुएं हैं।

JSON booleans और पूर्णांक संख्याओं का उपयोग करें, स्ट्रिंग नहीं। अज्ञात क्षेत्रों को अस्वीकार कर दिया जाता है। 14 डेटा क्वेरी टूल mode: realtime या async को स्वीकार करते हैं, जो वास्तविक समय में डिफ़ॉल्ट होते हैं। Batch प्रविष्टियां मोड को स्वीकार नहीं करती हैं।

उपकरणज़रूरीवैकल्पिक तर्क और डिफ़ॉल्ट
youtube_downloadvideo_id, storageमोड समर्थन करता है async केवल (डिफ़ॉल्ट)। download_type: audio_video (डिफ़ॉल्ट)/video/audio. video_quality: <=720 डिफ़ॉल्ट रूप से; best/worst ======== 144/360/480/720/1080/1440/2160/4320. एफपीएस: समान तुलना 1–240. output_formatmp4 (डिफ़ॉल्ट)/webm/mkv वीडियो के लिए, m4a (डिफ़ॉल्ट)/mp3/opus ऑडियो के लिए audio_language: default/original; audio_quality: best/320/256/192/128, केवल ऑडियो। yt_dlp_format: तक 1024 वर्ण, गुणवत्ता, एफपीएस और भाषा चयन ओवरराइड करता है। ऑडियो और audio_language के लिए Omit video_quality/fps वीडियो-केवल के लिए। भंडारण की आवश्यकता है और मैचों में API params.storage. start_at/end_at: HH:MM:SS, 12 घंटे तक; end_at को start_at का पालन करना होगा। upload_metadata: boolean, डिफ़ॉल्ट false. प्रत्येक बैच डाउनलोड को स्टोरेज की जरूरत होती है। कोई browser_delivery या callback_url नहीं।
storagestorage_type, storage_urlstorage_url आपकी बाल्टी नाम (Azure: कंटेनर) है, एक स्थानीय निर्देशिका नहीं है। storage_type: s3/s3_compatible/oss/gcs/azure/cos/bos/tos; वैकल्पिक object_prefix. S3, S3-compatible, OSS, COS, BOS और TOS लागू region/endpoint_url. के साथ access_key/secret_key का उपयोग करते हैं। GCS उपयोग service_account (project_id, client_email, private_key); Azure account_name और एक कंटेनर sas_token का उपयोग करता है जिसमें लिखने की अनुमति होती है। अंत बिंदु कार्यकर्ता से पहुंच योग्य होना चाहिए। अपने भंडारण विन्यास से क्रेडेंशियल पढ़ें; उन्हें चैट में पेस्ट न करें या उन्हें गूंजें।
google_*queryक्वेरी: 1–2, 000 वर्ण। gl: दो-अक्षर देश; hl: 1–35 वर्ण भाषा कोड; location/tbs: 1–200 वर्ण; num/page: integer 1–100; autocorrect: boolean. Omitted विकल्प खोज प्रदाता के व्यवहार का उपयोग करते हैं, जिसमें कोई निश्चित देश, भाषा या परिणाम की गारंटी नहीं है।
youtube_searchqueryक्वेरी: 1–2, 000 वर्ण। max_results: 1–20, डिफ़ॉल्ट 20; फिल्टर: फिल्टर ऑब्जेक्ट, omitted या null कोई फिल्टर के लिए।
youtube_search_extendedqueryक्वेरी: 1–2, 000 वर्ण। max_results: 1–700, डिफ़ॉल्ट 20; फ़िल्टर: मानक खोज के समान।
youtube_metadatavideo_idinclude_formats और include_chapters: booleans, दोनों डिफ़ॉल्ट true.
youtube_transcriptvideo_idOmit भाषा en-orig पसंद करने के लिए, फिर en, एक ट्रैक वापस लौटना। ऑटो = true के साथ, प्रत्येक कोड अपने -orig ट्रैक को पसंद करता है, फिर सादे कोड; स्पष्ट -orig और ऑटो = false सही रहते हैं। Arrays सभी 1–10 अनुरोधित भाषाओं की कोशिश करते हैं और क्रम में ट्रैक और त्रुटियों को वापस करते हैं। स्वत: कैप्शन के लिए true को ऑटो डिफॉल्ट।
youtube_captionsvideo_idOmit भाषा en-orig पसंद करने के लिए, फिर en, एक ट्रैक वापस लौटना। ऑटो = true के साथ, प्रत्येक कोड अपने -orig ट्रैक को पसंद करता है, फिर सादे कोड; स्पष्ट -orig और ऑटो = false सही रहते हैं। ऐरे सभी 1–10 अनुरोधित भाषाओं की कोशिश करते हैं और क्रम में ट्रैक और त्रुटियों को वापस करते हैं। अपलोडर-निर्मित कैप्शन के लिए false को ऑटो डिफॉल्ट।
youtube_trainabilityvideo_idमोड को छोड़कर कोई वैकल्पिक तर्क नहीं है। रिपोर्ट क्रिएटिव कॉमन्स लाइसेंस वर्गीकरण; यह प्रशिक्षण अनुमति नहीं देता है।
youtube_channelhandleसंभाल: 1–100 वर्ण; video_limit: 1–100, डिफ़ॉल्ट 20.
youtube_suggestionsqueryक्वेरी: 1–2, 000 वर्ण; भाषा: डिफ़ॉल्ट en; क्षेत्र: दो-अक्षर देश कोड, डिफ़ॉल्ट US.

video_id एक 11-character YouTube ID अक्षरों, संख्याओं, अंडरस्कोर या हाइफेन्स का उपयोग करते हुए; ID को वीडियो URL के बजाय आपूर्ति करें। प्रत्येक भाषा कोड 1–35 अक्षरों, संख्याओं या hyphens का उपयोग करके वर्ण है। उपशीर्षक के लिए, ऑटो = true स्वचालित कैप्शन का चयन करता है और false अपलोडर-निर्मित कैप्शन का चयन करता है, उनके बीच कोई स्वचालित गिरावट नहीं है। भाषा सरणी के लिए, जब नौकरी सफल होती है तब भी त्रुटियों की जांच करें।

YouTube खोज फ़िल्टर

filters.type: video/channel/playlist/movie; upload_date: today/last_hour/this_week/this_month/this_year; अवधि: <4, 4-20 या >20; sort_by: rating/relevance/view_count/upload_date. फ़ीचर झंडे बोलान हैं; true को उस सुविधा की आवश्यकता है: 360, 3D, 4k, creative_commons, HD, HDR, लाइव, स्थान, खरीदे गए, उपशीर्षक, vr180।

youtube_search · तर्क JSON
{
  "query": "renewable energy",
  "max_results": 5,
  "filters": {
    "type": "video",
    "duration": "<4",
    "subtitles": true
  }
}

लेखा अंतर्दृष्टि (मुक्त)

get_balance अपने साझा खाता शेष को पढ़ता है; get_pricing क्वेरी लागत का आकलन करता है; get_limits योजना सीमा और वर्तमान लंबित नौकरियों को पढ़ता है; get_usage डिफ़ॉल्ट रूप से अंतिम 7 दिनों को संक्षेप में प्रस्तुत करता है, अधिकतम 31-day विंडो के साथ। उपयोग में कॉलिंग कुंजी द्वारा अधिकृत स्रोतों के लिए सभी खाता कुंजी शामिल हैं और देरी हो सकती है।

get_balance और get_limits लेने {}. get_pricing एक वैकल्पिक स्रोत को स्वीकार करता है; इसे अपने कुंजी द्वारा अधिकृत सभी MCP क्वेरी स्रोतों के लिए छोड़ दें। request_count 1 से 100000, डिफ़ॉल्ट 1; प्रत्येक पृष्ठ या बैच आइटम एक अलग अनुरोध के रूप में गिनती करता है। get_usage एक वैकल्पिक स्रोत को स्वीकार करता है; इसे सभी अधिकृत स्रोतों के लिए छोड़ देता है। इसमें youtube_download उपयोग शामिल है। मूल्य निर्धारण रिटर्न creditsPerTb (1 टीबी = 10^12 bytes; आरक्षित क्रेडिट डाउनलोड करें और वास्तविक अपलोड बाइट्स द्वारा बसे। request_count डाउनलोड करने के लिए आवेदन नहीं करता है और estimatedCredits है null.

get_usage from/to होना चाहिए UTC ISO timetamps जैसे 2026-09-21T00:00:00Z, वैकल्पिक रूप से 1–3 भिन्नात्मक दूसरे अंकों के साथ। से समावेशी है, विशेष रूप से, मिनटों में नीचे गोल। डिफ़ॉल्ट विंडो 7 दिन है और अधिकतम 31 दिन है। केवल सात दिनों के बाद, केवल सात दिनों के लिए, केवल सात दिनों पहले ही होता है। प्रभावी विंडो के लिए प्रतिक्रिया के from/to को पढ़ें।

get_pricing · तर्क JSON
{
  "source": "google_search",
  "request_count": 3
}
get_usage · तर्क JSON
{
  "source": "youtube_metadata",
  "from": "2026-09-21T00:00:00Z",
  "to": "2026-09-22T00:00:00Z"
}

नौकरी और बड़े परिणाम

एक async अनुरोध एक नौकरी आईडी लौटाता है; इसे job_id से get_job के रूप में पारित करने के लिए job.status पढ़ने के लिए। पूर्ण नौकरियों में आउटपुट में मूल क्वेरी प्रतिक्रिया शामिल है। डाउनलोड के लिए, आउटपुट अपलोड प्रकट होता है: output.results[0].file_url ग्राहक भंडारण के लिए अंक, file_size, downloaded_bytes और MD5 के साथ। निजी फ़ाइलों को आपके भंडारण प्रमाणीकरण की आवश्यकता होती है। JSON परिणाम 24 घंटों के लिए बनाए रखा गया है; मीडिया प्रतिधारण और पहुंच आपकी भंडारण नीतियों का पालन करती है। submit_batch प्रत्येक प्रविष्टि पर स्रोत और फ्लैट तर्क के साथ कम से कम एक Google या YouTube क्वेरी (डाउनलोड सहित) को स्वीकार करता है। प्रत्येक प्रविष्टि को अलग से बिल दिया जाता है और आपकी योजना का बैच और लंबित सीमा लागू होती है। पढ़ना नौकरी फिर से चार्ज नहीं करती है। फ़ाइल-आधारित Bulk एक MCP उपकरण नहीं है।

एक ID फ़ाइल का प्रसंस्करण? Bulk HTTP API का उपयोग करें

youtube_transcript · तर्क JSON
{
  "video_id": "FUfGcZ092b0",
  "language": "en",
  "auto": true,
  "mode": "async"
}
submit_batch · तर्क JSON
{
  "queries": [
    {
      "source": "google_search",
      "query": "renewable energy",
      "num": 3
    },
    {
      "source": "youtube_metadata",
      "video_id": "FUfGcZ092b0",
      "include_formats": false
    }
  ]
}

उदाहरण job_id, result_id और अपनी प्रतिक्रिया से मूल्यों के साथ ऑफसेट बदलें। अगले भाग को फिर से क्वेरी को दोहराए बिना पढ़ें।

get_job · तर्क JSON
{
  "job_id": "job_REPLACE_WITH_RETURNED_ID"
}

बड़ी प्रतिक्रियाओं में एक JSON टेक्स्ट चंक, result_id और next_offset शामिल हैं। उसी कुंजी के साथ get_result को कॉल करें और लौटाए गए result_id। ऑफसेट एक गैर-नकारात्मक पूर्णांक है, डिफ़ॉल्ट 0; जारी रखने के लिए पिछले next_offset का उपयोग करें। सीमा 1 से 16000, डिफ़ॉल्ट 16000 तक एक पूर्णांक है, जिसे UTF-16 कोड इकाइयों में मापा जाता है। JSON; next_offset=null अंत को चिन्हित करने से पहले क्रम में समतुल्य चंक। परिणाम 10 मिनट के लिए कैश किए गए हैं, जिसमें प्रत्येक कुंजी के चार बड़े परिणाम होते हैं, और जल्द ही इसे evicted किया जा सकता है। रीडिंग चंक क्वेरी या चार्ज क्रेडिट को दोहरा नहीं जाता है।

get_result · तर्क JSON
{
  "result_id": "result_1800000000000_00000000-0000-0000-0000-000000000000",
  "offset": 16000,
  "limit": 16000
}

Billing और त्रुटियाँ

Queries अपने मौजूदा योजना के क्रेडिट मूल्य निर्धारण का उपयोग बिना किसी अतिरिक्त MCP शुल्क के करता है। टूल त्रुटियों ने isError को सेट किया और अपस्ट्रीम HTTP स्थिति को बनाए रखा और ID का अनुरोध किया। अपर्याप्त शेष राशि के लिए क्रेडिट को पुनर्स्थापित करें और एक्सेस त्रुटियों के लिए कुंजी अनुमतियों की जांच करें।

एक टाइमआउट या खोए हुए कनेक्शन का मतलब यह नहीं है कि क्वेरी को निष्पादित नहीं किया गया था। query_outcome_unknown के लिए, फिर से जमा करने के पहले कंसोल में History का अनुरोध करें। स्वचालित रूप से भुगतान प्रस्तुतियों को पुनः प्राप्त न करें; मौजूदा नौकरियों या चंकों के पढ़ने को पुनः प्राप्त किया जा सकता है। अपस्ट्रीम प्रतिक्रियाएं 4 MiB तक सीमित हैं, इसलिए खोज आकार को सीमित करें; अतिरंजित प्रतिक्रियाओं को पहले से ही चार्ज किया जा सकता है।

Underlying HTTP स्थिति कोड · Retry नियम

एक JavaScript क्लाइंट के साथ सत्यापित करें

यह क्लाइंट सत्यापित आधिकारिक SDK 1.30.0 का उपयोग करता है ताकि वे बिना किसी भुगतान क्वेरी के स्ट्रीमेबल HTTP और सूची टूल को कनेक्ट कर सकें। इसे mcp-check.mjs के रूप में सहेजें, अपने पर्यावरण में FLASHDATA_API_KEY सेट करें, फिर नोड mcp-check.mjs चलाएं।

npm
npm install @modelcontextprotocol/[email protected]
mcp-check.mjs
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const key = process.env.FLASHDATA_API_KEY;
if (!key) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new Client({ name: 'my-app', version: '1.0.0' });
try {
  await client.connect(new StreamableHTTPClientTransport(
    new URL('https://data.flashdata.dev/mcp'),
    { requestInit: { headers: { 'X-API-Key': key } } }
  ));
  console.log((await client.listTools()).tools.map(tool => tool.name));
} finally {
  await client.close();
}