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

शुरू करें

त्वरित शुरुआत

अपनी पहली Google खोज चलाएँ और ऐप या AI एजेंट के लिए संरचित परिणाम पाएँ।

अपने AI एजेंट से शुरू करें

यह प्रॉम्प्ट ऐसे एजेंट को दें जिसके पास टर्मिनल का एक्सेस हो। वह FlashData सेटअप करेगा और एक खोज चलाएगा।

अपनी पहली API कॉल करें

खुद कोड लिखना चाहते हैं? टर्मिनल में ये तीन चरण पूरे करें।

  1. API कुंजी लें

    खाता बनाएँ, ईमेल सत्यापित करें और 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. खोज चलाएँ

    भाषा चुनें और उसी टर्मिनल में उदाहरण चलाएँ। हर बार चलाने पर एक खोज भेजी जाती है।

    Python 3.10+ · उदाहरण को quickstart.py के नाम से सहेजें।

    इंस्टॉल करें
    python -m pip install "flashdata==1.1.0"
    quickstart.py
    import json
    import os
    from flashdata import FlashData
    
    with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        print(json.dumps(response, indent=2))
    चलाएँ
    python quickstart.py
  3. परिणाम जाँचें

    सफल जवाब में status: done होता है। स्रोत results[].organic में और खर्च किए गए क्रेडिट usage.credits में होते हैं।

    उदाहरण जवाब (संक्षिप्त)
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

कंसोल आज़माएँ

  1. खाता बनाएँ या साइन इन करें। ईमेल सत्यापन और कंसोल में दिखाए गए खाता सेटअप चरण पूरे करें।
  2. Google Search खोलें, Google Search स्रोत और Realtime मोड चुनें, फिर battery recycling research दर्ज करें। Additional parameters खोलकर Page size (num) को 5 पर सेट करें।
  3. दिखाया गया अनुरोध और उपलब्ध क्रेडिट जाँचें, फिर खोज एक बार चलाएँ।
  4. जवाब और उपयोग जाँचें। मिले हुए अंश से आगे किसी जानकारी का हवाला देने से पहले स्रोत खोलकर उसकी सामग्री जाँचें।

पहले परिणाम से आगे बढ़ें

पहला अनुरोध विफल हो जाए तो

FLASHDATA_API_KEY नहीं है
उदाहरण वाले टर्मिनल या रनटाइम में ही कुंजी सेट करें। ये उदाहरण .env फ़ाइलें नहीं पढ़ते।
401 / 403
देखें कि कुंजी या कनेक्शन सक्रिय है और उसके पास google_search की अनुमति है।
402
Billing में उपलब्ध क्रेडिट जाँचें। मालिक के एक्सेस की ज़रूरत हो तो मौजूदा ट्रायल को खाते से लिंक करें।
429
Retry-After का पालन करें। वही पहचान और पंजीकरण का प्रमाण रखें; दूसरा ट्रायल न बनाएँ।
समय सीमा समाप्त या अनुरोध भेजने की स्थिति अज्ञात
दोबारा कोशिश करने से पहले मौजूदा रन जाँचें। CLI उपयोगकर्ता वही प्रोफ़ाइल और रन ID रखें; SDK/API उपयोगकर्ता लौटाया गया जॉब या अनुरोध ID सहेजें।
Markdown