Перейти к содержимому
RU
Ключ 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 задания или запроса.