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

शुरू करें

API क्विकस्टार्ट

Google Search और YouTube APIs को सीधे HTTP पर कॉल करें। एक अनुरोध भेजें और JSON प्रतिक्रिया पढ़ें; कोई SDK की आवश्यकता नहीं है।

  1. प्रमाणीकरण

    एक खाता बनाएं, अपने ईमेल को सत्यापित करें और Google Search अनुमति के साथ एक कुंजी बनाएं। आप मौजूदा कुंजी का पुन: उपयोग कर सकते हैं।

    टर्मिनल में चलाएँ और छिपे हुए इनपुट प्रॉम्प्ट पर कुंजी पेस्ट करें। FLASHDATA_API_KEY पहले से सेट है तो यह चरण छोड़ दें।

    कुंजी सेट करें
    # 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
  2. खोज चलाएँ

    एक ग्राहक चुनें और उसी टर्मिनल में उदाहरण चलाएं। प्रत्येक एक भेजता है POST अनुरोध करना https://data.flashdata.dev/v1/queries/realtime और प्रिंट JSON. X-API-Key के साथ प्रमाणीकरण करें; JSON को Content-Type के साथ भेजें: application/json.

    cURL 7.76+· Bash on Linux, macOS या Git Bash. पेस्ट करें और चलाएं।

    खोज · Bash / cURL
    curl --fail-with-body --silent --show-error --max-time 70 \
      --request POST https://data.flashdata.dev/v1/queries/realtime \
      --header "X-API-Key: $FLASHDATA_API_KEY" \
      --header 'Content-Type: application/json' \
      --data '{
      "source": "google_search",
      "query": "battery recycling research",
      "params": {
        "num": 5
      }
    }'
  3. परिणाम जाँचें

    HTTP सफलता और status: done की पुष्टि करें। results[].organic में स्रोत शीर्षक, लिंक और स्निपेट्स पढ़ें, और usage.credits में चार्ज करें।

    status: done के साथ एक खाली परिणाम या कार्बनिक सूची एक वैध खाली परिणाम है।

    उदाहरण
    {
      "source": "google_search",
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    status
    "done" क्वेरी सफलतापूर्वक समाप्त होने की पुष्टि करता है।
    results[0].organic[]
    परिणाम खोजें। जांचें कि परिणाम अनुक्रमण से पहले कोई भी समस्या नहीं है।
    title / link / snippet
    स्रोत शीर्षक, URL और अंश।
    usage.credits
    इस प्रश्न के लिए वास्तविक क्रेडिट का शुल्क लिया गया है।

डिबगिंग के लिए प्रतिक्रिया सहेजें

अगले अनुरोध पर कब्जा करने के लिए, इन विकल्पों को ऊपर cURL कमांड में जोड़ें। असफल अनुरोध को पुनः प्राप्त करने की निर्णय लेने से पहले फ़ाइलों का निरीक्षण करें।

cURL
--dump-header response-headers.txt --output result.json

पहुँच और क्रेडिट की जाँच करें

इन GET अनुरोधों ने क्वेरी क्रेडिट का उपयोग किए बिना पहचान, संतुलन और मूल्य निर्धारण को पढ़ा। HTTP 200 को Expect करें और भुगतान किए गए कार्य को जमा करने से पहले नीचे दिए गए फ़ील्ड को चेक करें।

खाता पढ़ता है: https://api.flashdata.dev/v2. डेटा अनुरोध: https://data.flashdata.dev/v1. दोनों X-API-Key का उपयोग करते हैं; JSON POST अनुरोध भी Content-Type का उपयोग करें: application/json.

नि: शुल्क चेक · Bash
(
for endpoint in 'identity' 'balance' 'pricing?source=google_search&request_count=1'; do
  printf '\n%s\n' "$endpoint"
  curl --fail-with-body --silent --show-error --max-time 20 \
    --header "X-API-Key: $FLASHDATA_API_KEY" \
    --write-out '\nHTTP %{http_code}\n' \
    "https://api.flashdata.dev/v2/api-access/$endpoint" || exit
done
)
identity
इरादा accountId, access: "ready", "google_search" युक्त दायरे और किसी भी expiresAt की पुष्टि करें। accountType एक मालिक कुंजी या "temporary" के लिए "owned" है।
balance
पढ़िए availableCredits. इस खाते के लिए सभी कुंजी समान शेष राशि का उपयोग करती है।
pricing
कीमतों के लिए [0], पुष्टि स्रोत google_search है और उपलब्ध true है। requestCount के लिए estimatedCredits की तुलना करें: 1 के साथ availableCredits मूल्य और शेष राशि जमा करने से पहले बदल सकते हैं।

अगला कदम

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

अपने टर्मिनल में मुद्रित प्रतिक्रिया पढ़ें। JavaScript और Python की रिपोर्ट HTTP त्रुटियों और Retry-After को stderr को। प्रत्येक उदाहरण एक बार प्रस्तुत करता है; यह स्वचालित रूप से पुनः प्रयास नहीं करता है।

कमान लापता या असमर्थित विकल्प
चयनित उदाहरण में आवश्यक संस्करण की जाँच करें। उपयोग PowerShell 7 बजाय Windows PowerShell 5.1, या उपयोग Bash साथ cURL 7.76+. JavaScript को नोड 22+ की आवश्यकता है; Python को 3.10+ की जरूरत है। अपने आधिकारिक डाउनलोड पृष्ठ से लापता रनटाइम स्थापित करें, टर्मिनल को फिर से खोलने के बाद फिर से कुंजी सेट करें।
मिसिंग कुंजी / 401
इस प्रक्रिया में FLASHDATA_API_KEY सेट करें और फिर पहचान की जांच करें। पूर्ण सक्रिय API कुंजी की आपूर्ति, बिना बियरर उपसर्ग के। यदि यह समाप्त हो गया है या रद्द कर दिया गया है, तो वर्तमान अधिकृत क्रेडेंशियल का उपयोग करें; इसे चैट में पेस्ट न करें।
403
google_search के लिए identity.scopes की जाँच करें और तैयार करने के लिए उपयोग करें। मालिक से लापता अनुमति का अनुरोध करें; अनुरोध में स्रोत को बदलने से एक्सेस नहीं मिलती है।
402
फिर से संतुलन पढ़ें और इसे वर्तमान मूल्य के साथ तुलना करें। मालिक Billing की समीक्षा कर सकता है। एक थकावट परीक्षण को दावा करने के माध्यम से मालिक की पहुंच की आवश्यकता होती है; प्रतिस्थापन परीक्षण बनाना वसूली नहीं है।
400 / 422
लौटे त्रुटि संदेश पढ़ें। सटीक डेटा होस्ट, POST विधि, Content-Type और JSON फ़ील्ड नामों की जाँच करें। सीधे उद्धरण और एक संख्यात्मक params.num का उपयोग करें, फिर अस्वीकार किए गए अनुरोध को सही करें।
429
यदि उपस्थित हो तो Retry-After का सम्मान करें; अन्यथा एक बाध्य बैकऑफ़ का उपयोग करें और सहमति को कम करें। तेजी से लूप न करें, नई कुंजी बनाएं या सीमा को बायपास करने के लिए एक अन्य परीक्षण दर्ज करें।
HTTP 200 असफल स्थिति या त्रुटि के साथ
शरीर में त्रुटि को पढ़ें और किसी भी अनुरोध या नौकरी को संरक्षित करें ID. एक सफल कार्य के रूप में एक parsed JSON बॉडी का इलाज न करें या इसे स्वचालित रूप से दोहराएं।
खाली परिणाम
यदि स्थिति की जाती है, तो प्रमाणीकरण कार्य करता है। खाली परिणाम रखें या एक नए भुगतान अनुरोध के रूप में एक व्यापक क्वेरी की कोशिश करें।
JSON के बजाय टाइमआउट, कनेक्शन हानि, 5xx या HTML
एक POST को स्वीकार किया जा सकता है, भले ही इसकी प्रतिक्रिया खो गई हो। मूल क्वेरी के लिए History की जाँच करें और किसी भी लौटाने वाले IDs की रक्षा करें। नि: शुल्क GET चेक को पुनः प्राप्त किया जा सकता है। की पुष्टि करें URL data.flashdata.dev का उपयोग करता है, वेबसाइट होस्ट नहीं करता है, और TLS सत्यापन को अक्षम नहीं करता है।
Markdown