दस्तावेज़ देखें
API संदर्भ
अपने आवेदन के लिए संरचित JSON चुनें या AI एजेंट के लिए Markdown सामग्री। दो शीर्षलेखों के साथ प्रतिक्रिया को नियंत्रित करें।
इस पेज पर
एक प्रारूप चुनें
मूल परिणाम फ़ील्ड के साथ JSON डिफ़ॉल्ट है। Accept JSON या सादे पाठ का चयन करता है; X-Respond-With: मार्कडाउन परिणाम सामग्री को Markdown में परिवर्तित करता है। आपका अनुरोध शरीर JSON रहता है।
| जवाब | Accept | X-Respond-With | उपयोग के लिए |
|---|---|---|---|
| JSON | application/json | ओमित | कोड में फ़ील्ड पार्सिंग · डिफ़ॉल्ट |
| JSON + Markdown | application/json | markdown | संरचित मेटाडाटा के साथ एजेंट संदर्भ |
| सादा पाठ | text/plain | ओमित | एक टर्मिनल में मूल फ़ील्ड पढ़ना |
| पाठ + Markdown | text/plain | markdown | पढ़ना मेटाडाटा और Markdown एक साथ |
अनुरोध और प्रतिक्रिया उदाहरण
ये टैब प्रत्येक प्रारूप में समान Google Search दिखाते हैं। Bash और cURL 7.76+ का उपयोग FLASHDATA_API_KEY के साथ एक कुंजी सेट करें जो google_search को अनुमति देता है। एक कमांड चलाने से एक बिलेबल खोज जमा होती है।
डिफ़ॉल्ट। परिणाम सारणी पार्स करें; इसके अंदर के क्षेत्र स्रोत पर निर्भर करते हैं।
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"
}एक Markdown स्ट्रिंग के रूप में सामग्री पढ़ें। यह परिणाम की जगह लेता है; स्रोत, स्थिति और उपयोग JSON फ़ील्ड के रूप में उपलब्ध रहता है।
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' \
--header 'X-Respond-With: markdown' \
--data '{"source":"google_search","query":"vector databases"}'{
"source": "google_search",
"status": "done",
"usage": {
"credits": 0.01
},
"created_at": "2026-10-22T12:00:00.000Z",
"content": "# Google search\n\n## Organic\n\n### 1. Example page\n\n**Link:** <https://example.com/article>\n\n**Snippet:** A short source snippet\\.\n"
}पाठ के रूप में प्रतिक्रिया पढ़ें। इसमें एक इंडेंट लेआउट में मूल फ़ील्ड शामिल हैं, एक JSON दस्तावेज़ नहीं है।
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: text/plain' \
--data '{"source":"google_search","query":"vector databases"}'Source: "google_search"
Status: "done"
Results:
1:
Organic:
1:
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"
पाठ के रूप में प्रतिक्रिया पढ़ें: मेटाडाटा पहले, उसके बाद Markdown सामग्री।
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: text/plain' \
--header 'X-Respond-With: markdown' \
--data '{"source":"google_search","query":"vector databases"}'Source: "google_search"
Status: "done"
Usage: {"credits":0.01}
Created at: "2026-10-22T12:00:00.000Z"
Markdown Content:
# Google search
## Organic
### 1. Example page
**Link:** <https://example.com/article>
**Snippet:** A short source snippet\.
समर्थित समापन बिंदु
उसी नियम 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 ने किसी अन्य प्रश्न को प्रस्तुत किए बिना मौजूदा परिणामों को पढ़ लिया।
| अनुरोधित प्रारूप | परिणाम प्रतिक्रिया |
|---|---|
| मूल JSON | 302 एक हस्ताक्षरित भंडारण के साथ URL स्थान में। Fetch कि URL अलग से, X-API-Key के बिना। संग्रहीत परिणाम gzip-compressed हो सकता है। |
| सादा पाठ या तो Markdown विकल्प | 200 सीधे जवाब में स्वरूपित शरीर के साथ। |
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_representation | X-Respond-With का उपयोग करें: हेडर को मार्कडाउन या छोड़ दें। जैसे कि जेसन या टेक्स्ट समर्थित नहीं हैं। |
| 406 · not_acceptable | Accept: application/json या text/plain. text/markdown और application/xml का उपयोग समर्थित नहीं है। |
Accept शीर्षलेख विवरण
Omit Accept या JSON प्राप्त करने के लिए */* भेजें। प्रतिक्रियाएं UTF-8 का उपयोग करती हैं। मीडिया रेंज और q भार समर्थित हैं; एक असमर्थित charset रिटर्न 406 जब तक कि एक अन्य स्वीकार्य रेंज मैच नहीं होते हैं। Content-Type: application/json अनुरोध निकाय का वर्णन करता है, उत्तर नहीं।
Accept: text/plain; charset=utf-8, application/json;q=0.8