Перейти до вмісту
UK
Отримати ключ API
Переглянути документацію

Початок роботи

Швидкий старт

Виконайте перший пошук Google й отримайте структуровані результати для застосунку або ШІ-агента.

Почніть зі свого ШІ-агента

Передайте цей промпт агенту з доступом до термінала. Він налаштує 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 завдання або запиту.