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

API संदर्भ

जवाब के फ़ॉर्मैट

अपने आवेदन के लिए संरचित JSON चुनें या AI एजेंट के लिए Markdown सामग्री। दो शीर्षलेखों के साथ प्रतिक्रिया को नियंत्रित करें।

इस पेज पर

एक प्रारूप चुनें

मूल परिणाम फ़ील्ड के साथ JSON डिफ़ॉल्ट है। Accept JSON या सादे पाठ का चयन करता है; X-Respond-With: मार्कडाउन परिणाम सामग्री को Markdown में परिवर्तित करता है। आपका अनुरोध शरीर JSON रहता है।

जवाबAcceptX-Respond-Withउपयोग के लिए
JSONapplication/jsonओमितकोड में फ़ील्ड पार्सिंग · डिफ़ॉल्ट
JSON + Markdownapplication/jsonmarkdownसंरचित मेटाडाटा के साथ एजेंट संदर्भ
सादा पाठtext/plainओमितएक टर्मिनल में मूल फ़ील्ड पढ़ना
पाठ + Markdowntext/plainmarkdownपढ़ना मेटाडाटा और Markdown एक साथ

अनुरोध और प्रतिक्रिया उदाहरण

ये टैब प्रत्येक प्रारूप में समान Google Search दिखाते हैं। Bash और cURL 7.76+ का उपयोग FLASHDATA_API_KEY के साथ एक कुंजी सेट करें जो google_search को अनुमति देता है। एक कमांड चलाने से एक बिलेबल खोज जमा होती है।

डिफ़ॉल्ट। परिणाम सारणी पार्स करें; इसके अंदर के क्षेत्र स्रोत पर निर्भर करते हैं।

अनुरोध cURL / Bash
curl --fail-with-body --silent --show-error \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{"source":"google_search","query":"vector databases"}'
उदाहरण उत्तर · व्याख्यात्मक मान
{
  "source": "google_search",
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "Example page",
          "link": "https://example.com/article",
          "snippet": "A short source snippet."
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-10-22T12:00:00.000Z"
}

समर्थित समापन बिंदु

उसी नियम Google Search और YouTube क्वेरी स्रोतों पर लागू होते हैं। YouTube Download के लिए, वे वितरण रिकॉर्ड को प्रारूपित करते हैं, वीडियो या ऑडियो बाइट नहीं। खाता एपीआई, Bulk प्रकट होता है और NDJSON भागों, कॉलबैक और MCP उत्तर अपने स्वयं के प्रारूपों का उपयोग करते हैं।

समापन बिंदुJSON / सादे पाठMarkdown सामग्री
POST /v1/queries/realtimeसमर्थितसमर्थित
GET /v2/jobs/{id}/resultsसमर्थितसमर्थित
POST /v1/queriesसबमिशन रसीदIgnored — यह चयन करें जब पढ़ने परिणाम
POST /v1/queries/batchसबमिशन रसीदIgnored — यह चयन करें जब पढ़ने परिणाम
GET /v2/jobs/{id}नौकरी की स्थितिIgnored — यहाँ कोई परिणाम सामग्री नहीं

एक पूर्ण नौकरी परिणाम स्वरूप

परिणाम पढ़ने पर हेडर सेट करें, भले ही आप उन्हें प्रस्तुत करने पर सेट करें। एक पूर्ण नौकरी के लिए JOB_ID सेट करें जिसे आप एक्सेस कर सकते हैं। इस GET ने किसी अन्य प्रश्न को प्रस्तुत किए बिना मौजूदा परिणामों को पढ़ लिया।

अनुरोधित प्रारूपपरिणाम प्रतिक्रिया
मूल JSON302 एक हस्ताक्षरित भंडारण के साथ URL स्थान में। Fetch कि URL अलग से, X-API-Key के बिना। संग्रहीत परिणाम gzip-compressed हो सकता है।
सादा पाठ या तो Markdown विकल्प200 सीधे जवाब में स्वरूपित शरीर के साथ।
Retrieve Markdown in JSON · cURL / Bash
curl --fail-with-body --silent --show-error \
  "https://api.flashdata.dev/v2/jobs/${JOB_ID:?Set JOB_ID}/results" \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Accept: application/json' \
  --header 'X-Respond-With: markdown'

प्रारूप त्रुटियां

API त्रुटियां JSON या application/problem+json बनी हुई हैं, भले ही आप सादे पाठ का अनुरोध करते हैं। सफलता प्रारूप को पार करने से पहले HTTP स्थिति की जांच करें।

स्थिति / कोडफिक्स
400 · unsupported_representationX-Respond-With का उपयोग करें: हेडर को मार्कडाउन या छोड़ दें। जैसे कि जेसन या टेक्स्ट समर्थित नहीं हैं।
406 · not_acceptableAccept: application/json या text/plain. text/markdown और application/xml का उपयोग समर्थित नहीं है।

Accept शीर्षलेख विवरण

Omit Accept या JSON प्राप्त करने के लिए */* भेजें। प्रतिक्रियाएं UTF-8 का उपयोग करती हैं। मीडिया रेंज और q भार समर्थित हैं; एक असमर्थित charset रिटर्न 406 जब तक कि एक अन्य स्वीकार्य रेंज मैच नहीं होते हैं। Content-Type: application/json अनुरोध निकाय का वर्णन करता है, उत्तर नहीं।

Prefer text, अनुमति JSON
Accept: text/plain; charset=utf-8, application/json;q=0.8
Markdown