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

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

Python SDK швидкийстарт

Встановіть Python SDK і роздрукуйте результати пошуку з декількома лініями коду. Включає синхронні і асинхронні приклади.

  1. Встановити SDK

    Вимагає Python 3.10+. Запустіть ці команди в каталозі проекту. Уже використовуючи віртуальне середовище? Встановіть флешdata==1.1.0 з цим середовищем python -m pip замість цього.

    Встановити
    python3 -m venv .venv
    .venv/bin/python -m pip install "flashdata==1.1.0"
  2. Ауттентицид

    Створіть ключ API з дозволом Google Search або повторно використовуйте уповноважений ключ. Встановіть його в цей термінал за допомогою прихованого підказка нижче.

    Пропустити запит, якщо FLASHDATA_API_KEY вже встановлений. Ці приклади читають змінну безпосередньо; вони не завантажують .env файли.

    Прихована ключова підказка · Bash
    # 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
  3. Виконайте пошук

    Заощаджуйте це як quickstart.py, після чого запустіть його з таким же віртуальним середовищем. Це робить запит Google Search до п'яти результатів і друк назв, URLs і кредитних коштів, які використовуються.

    quickstart.py
    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)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])
    Запустити
    .venv/bin/python quickstart.py
  4. Перевірте результат

    Виходи скрипту зазвичай після перевірки стану. Заголовки джерела та URLs слідувати за використовуваними кредитами. Порожній органічний список є дією відповідь; результати змінюються з вашим запитом.

    Приклад виходу
    Battery recycling research https://example.org/recycling
    Credits used: 0.02
    results[].organic[]
    Google Search переглядів: назва, посилання та snippet. Інші джерела мають різні поля результатів.
    usage.credits
    Вартість цього запиту. До п'яти результатів тут є один запит на пошук.

Спробуйте ще одне джерело даних

Кожна вкладка є повним скриптом. Замініть quickstart.py з одним прикладом і запустіть його з командуванням з кроку 3. Кожен забіг подає один новий запит; ключ повинен мати дозвіл на джерело.

Вимагає google_news. Друк назв та вихідних посилань від results[].news[].

quickstart.py
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.news("battery recycling", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    for page in response["results"]:
        for article in page.get("news", []):
            print(article.get("title"), article.get("link"))

Що підтримує Python SDK

google / youtube
Google Search, Новини, Зображення, покупка, відео та місця; YouTube відкриття, метадані, підписи, перезаписи та дані каналів.
youtube.download
Надайте аудіо або відео доставку на хмарне сховище. Вимагає дозвіл youtube_download і налаштування зберігання; слідувати за повним прикладом завантаження нижче.
jobs / bulk
Заощаджуйте прийнятий роботу ID, чекайте завершення та отримання результатів. Використовуйте сипучих для збільшення відео-ID datasets і відновлюють існуючі робочі місця після перезавантаження.
account
Читання доступу, баланс, ціноутворення, ліміти та використання перед рецидивною роботою. Змініть уповноважений ключ від вашого середовища або секретного магазину.
respond_with / accept
Використовуйте respond_with="markdown" для Markdown у відповідь["content"], або приймати="text/plain" для рядка. JSON є типовими.

Використання асинхроніки

Замініть quickstart.py з цією версією і використовуйте команду запуску. AsyncFlashData виводить ті ж ресурси з очікуваним. Що ще чекає на відповідь на пошук в режимі реального часу; mode="async" подає серверну роботу замість роботи.

У Юпітері або аплікації з проточною петлею, використання чекає головний() замість asyncio.run(основний()). Зловживання клієнтом в межах цієї петлі заходу.

quickstart.py
import asyncio
import os
from flashdata import AsyncFlashData

async def main():
    async with AsyncFlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = await client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])

asyncio.run(main())

Наступний крок

Якщо крок не зникає

ModuleNotFoundError
Встановіть і запустіть з того ж перекладача: .venv/bin/python -m pip шоу флешки (Windows: .\.venv\Scripts\python.exe -m pip шоу флешки). Не ім'я вашого скрипта flashdata.py.
KeyError: FLASHDATA_API_KEY / 401
Встановіть активний ключ API в одному терміналі. Файл .env самостійно не завантажується цим прикладом. Використовуйте API ключ, не MCP OAuth токен.
403
Надайте дозвіл на джерело, необхідний прикладом до цього ключа.
402
Перевірте Billing для доступних кредитів. Якщо вичерпний доступ, застосуйте підключення до вашого облікового балансу.
429 / APIError
Огляд error.retry_after і зменшення швидкості запиту. SDK надсилає кожен запит один раз і не змінює автоматично.
SubmissionUnknownError
Подання часу вже може бути прийнята. Перевірити History перед його повторенням; повторно використовувати збережену роботу ID при наявності.
asyncio.run() / running event loop
Використовуйте expect main() в блокнот або існуючій петлі заходу. Зареєструватися asyncio.run(голова()) для самостійного сценарію.