Переглянути документацію
Початок роботи
Виконайте перший пошук Google й отримайте структуровані результати для застосунку або ШІ-агента.
Почніть зі свого ШІ-агента
Передайте цей промпт агенту з доступом до термінала. Він налаштує FlashData та виконає один пошук.
Прочитайте https://flashdata.dev/auth.md і виконайте інструкції з налаштування FlashData для цього середовища. Повторно використовуйте наявний доступ; якщо його немає, почніть лише один пробний період за умови відповідності вимогам. Знайдіть у Google "battery recycling research", запитавши не більше п’яти результатів. Поверніть назви джерел, URL і фактично витрачені кредити. Зберігайте облікові дані в захищеному сховищі, а не в чаті. Якщо доступ заблоковано, вкажіть наступний крок замість створення нового пробного періоду.
Виконайте перший виклик API
Хочете написати код самостійно? Виконайте ці три кроки в терміналі.
Отримайте 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Задайте ключ# PowerShell 7: paste the key into a hidden prompt. $flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString $env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password Remove-Variable flashdataSecureKeyВиконайте пошук
Виберіть мову та запустіть приклад у тому самому терміналі. Кожен запуск надсилає один пошуковий запит.
Python 3.10+ · Збережіть приклад як quickstart.py.
Встановитиpython -m pip install "flashdata==1.1.0"quickstart.pyimport 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.pyNode.js 22.18+ · Почніть у порожній папці та збережіть quickstart.mts.
Налаштуватиnpm init -y npm install --save-exact @flashdata-dev/[email protected]quickstart.mtsimport { FlashData } from '@flashdata-dev/sdk'; const apiKey = process.env.FLASHDATA_API_KEY; if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.'); const client = new FlashData({ apiKey }); const response = await client.google.search({ query: 'battery recycling research', num: 5, }); if (response.status !== 'done') throw new Error(JSON.stringify(response)); console.log(JSON.stringify(response, null, 2));Запуститиnode quickstart.mtsNode.js 22+ · Почніть у порожній папці та збережіть quickstart.mjs.
Налаштуватиnpm init -y npm install --save-exact @flashdata-dev/[email protected]quickstart.mjsimport { FlashData } from '@flashdata-dev/sdk'; const apiKey = process.env.FLASHDATA_API_KEY; if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.'); const client = new FlashData({ apiKey }); const response = await client.google.search({ query: 'battery recycling research', num: 5, }); if (response.status !== 'done') throw new Error(JSON.stringify(response)); console.log(JSON.stringify(response, null, 2));Запуститиnode quickstart.mjsGo 1.25+ · Почніть у порожній папці та збережіть main.go. Пропустіть go mod init у наявному модулі.
Налаштуватиgo mod init example.com/flashdata-quickstart go get github.com/flashdatadev/[email protected]main.gopackage main import ( "context" "encoding/json" "log" "os" "time" flashdata "github.com/flashdatadev/flashdata-go" ) func main() { key := os.Getenv("FLASHDATA_API_KEY") if key == "" { log.Fatal("Set FLASHDATA_API_KEY through your server's secret manager.") } client, err := flashdata.New(flashdata.Options{APIKey: key}) if err != nil { log.Fatal(err) } ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute) defer cancel() result, err := client.Google.Search(ctx, flashdata.GoogleSearchInput{ Query: "battery recycling research", Params: &flashdata.GoogleSearchParams{Num: flashdata.Ptr(int64(5))}, }) if err != nil { // Do not automatically resubmit an uncertain paid request. log.Fatal(err) } if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { log.Fatal(err) } if result.Status != "done" { log.Fatalf("Search did not complete: %s", result.Status) } }Запуститиgo run .SDK не потрібен. Виконайте команду Bash / cURL 7.76+ або команду PowerShell 7.
Bash / cURLcurl --fail-with-body --silent --show-error \ --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}}'PowerShell 7$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}' $flashdataResult = Invoke-RestMethod -Method Post -Uri 'https://data.flashdata.dev/v1/queries/realtime' -Headers @{ 'X-API-Key' = $env:FLASHDATA_API_KEY } -ContentType 'application/json' -Body $flashdataRequest $flashdataResult | ConvertTo-Json -Depth 20Перевірте результат
Успішна відповідь містить 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 } }
Спробуйте консоль
- Створіть обліковий запис або увійдіть. Підтвердьте пошту й виконайте кроки налаштування облікового запису, показані в консолі.
- Відкрийте Google Search, виберіть джерело Google Search і режим Realtime, потім введіть battery recycling research. Розгорніть Additional parameters і встановіть Page size (num) на 5.
- Перевірте показаний запит і доступні кредити, а потім виконайте пошук один раз.
- Перевірте відповідь і використання. Відкрийте отримане джерело та перевірте його вміст, перш ніж цитувати відомості поза уривком.
Продовжуйте з першого результату
Якщо перший запит не вдався
- Не задано FLASHDATA_API_KEY
- Задайте ключ у тому самому терміналі або середовищі, де запускаєте приклад. Ці фрагменти не завантажують файли .env.
- 401 / 403
- Перевірте, що ключ або підключення активне та має дозвіл google_search.
- 402
- Перевірте доступні кредити в Billing. Прив’яжіть наявний пробний доступ до облікового запису, якщо потрібен доступ власника.
- 429
- Дотримуйтеся Retry-After. Зберігайте ту саму ідентичність і доказ реєстрації; не створюйте інший пробний доступ.
- Перевищено час очікування або статус надсилання невідомий
- Перед повтором перевірте наявний запуск. У CLI зберігайте той самий профіль та ID запуску; у SDK/API збережіть отриманий ID завдання або запиту.