Переглянути документацію
Початок роботи
Зателефонуйте Google Search та YouTube API безпосередньо над HTTP. Відправити запит і читати JSON відповідь; SDK обов'язковий.
Ауттентицид
Створіть обліковий запис, перевірте свою електронну пошту та створіть ключ з дозволом 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Виконайте пошук
Оберіть клієнт і запустіть приклад в одному терміналі. Відправляється один POST запит на https://data.flashdata.dev/v1/queries/realtime і друк JSON. Аутентифікація з X-API-Key; відправити JSON з Content-Type: application/json.
cURL 7.76+ · Bash на Linux, macOS або Git Bash. Паста і бігти.
Пошук · Bash / cURLcurl --fail-with-body --silent --show-error --max-time 70 \ --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+ · Вставте це рідне командування PowerShell.
Пошук · PowerShell$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}' $flashdataSearch = @{ Uri = 'https://data.flashdata.dev/v1/queries/realtime' Method = 'Post' Headers = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY } ContentType = 'application/json' Body = $flashdataRequest TimeoutSec = 70 MaximumRedirection = 0 SkipHttpErrorCheck = $true ErrorAction = 'Stop' } $flashdataResponse = Invoke-WebRequest @flashdataSearch $flashdataResponse.Content if ($flashdataResponse.StatusCode -ge 400) { throw "HTTP $($flashdataResponse.StatusCode). Inspect the response above before retrying." }Node.js 22+ · Збережіть як search.mjs і запустіть локально або на сервері. Використання вбудованої fetch; без встановлення npm.
search.mjsconst key = process.env.FLASHDATA_API_KEY; if (!key) throw new Error("Set FLASHDATA_API_KEY in this terminal."); let response; try { response = await fetch("https://data.flashdata.dev/v1/queries/realtime", { method: "POST", redirect: "error", signal: AbortSignal.timeout(70000), headers: { "X-API-Key": key, "Content-Type": "application/json" }, body: JSON.stringify({"source":"google_search","query":"battery recycling research","params":{"num":5}}), }); } catch { throw new Error("Request did not complete. Check History before resubmitting."); } const body = await response.text(); console.log(body); // Print the full response before checking its status. if (!response.ok) { const retryAfter = response.headers.get("retry-after"); throw new Error("HTTP " + response.status + ". See the response above." + (retryAfter ? " Retry-After: " + retryAfter : "")); } let result; try { result = JSON.parse(body); } catch { throw new Error("Expected JSON. Inspect the response above and the API URL."); } if (!result || result.error === true || result.status !== "done" || !Array.isArray(result.results)) { throw new Error("Query did not succeed. Inspect status and error in the response above."); }Запуск · JavaScriptnode search.mjsPython 3.10+ · Зберегти як search.py. Використовуйте лише стандартну бібліотеку; без встановлення pip. Використовуйте python3 або py -3, якщо це ваша команда Python.
search.pyimport json import os import urllib.error import urllib.request key = os.environ.get("FLASHDATA_API_KEY") if not key: raise SystemExit("Set FLASHDATA_API_KEY in this terminal.") # Do not forward the API key to a redirect destination. class NoRedirect(urllib.request.HTTPRedirectHandler): def redirect_request(self, req, fp, code, msg, headers, newurl): return None request = urllib.request.Request( "https://data.flashdata.dev/v1/queries/realtime", data=json.dumps({"source":"google_search","query":"battery recycling research","params":{"num":5}}).encode("utf-8"), headers={"X-API-Key": key, "Content-Type": "application/json"}, method="POST", ) try: with urllib.request.build_opener(NoRedirect).open(request, timeout=70) as response: body = response.read().decode("utf-8") except urllib.error.HTTPError as error: print(error.read().decode("utf-8", errors="replace")) retry_after = error.headers.get("Retry-After") raise SystemExit("HTTP " + str(error.code) + ". See the response above." + (" Retry-After: " + retry_after if retry_after else "")) except (urllib.error.URLError, TimeoutError): raise SystemExit("Request did not complete. Check History before resubmitting.") print(body) # The run command saves this full response to result.json. try: result = json.loads(body) except json.JSONDecodeError: raise SystemExit("Expected JSON. Inspect the response above and the API URL.") if (not isinstance(result, dict) or result.get("error") is True or result.get("status") != "done" or not isinstance(result.get("results"), list)): raise SystemExit("Query did not succeed. Inspect status and error in the response above.")Запуск · Pythonpython -X utf8 search.pyПеревірте результат
Підтвердіть успіх HTTP і status: done. Читання назв джерела, посилань та фрагментів у results[].organic та заряду у usage.credits.
За допомогою status: done є діє порожній результат.
Приклад відповіді{ "source": "google_search", "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }status- "done" підтверджує успішність запиту.
results[0].organic[]- Результати пошуку. Перевірити результати, які не можна, перш ніж його індексувати.
title / link / snippet- Заголовок джерела, URL та ЕКЗ.
usage.credits- Актуальні кредити, що стягуються за цей запит.
Заощаджуйте відгук про відбілювання
Для захоплення наступного призначеного запиту додайте ці параметри до команди cURL вище. Переглядайте файли перед тим, як видалити дані про недійсний запит.
--dump-header response-headers.txt --output result.jsonПеревірити доступ і кредити
Ці запити GET читати ідентичність, баланс та ціноутворення без використання кредитних запитів. Очікуйте HTTP 200 і перевірте поля нижче, перш ніж подати платну роботу.
Ознайомитися з обліковими записами: https://api.flashdata.dev/v2. Запити даних: https://data.flashdata.dev/v1. Як використовувати X-API-Key; JSON POST також використовують Content-Type: application/json.
(
for endpoint in 'identity' 'balance' 'pricing?source=google_search&request_count=1'; do
printf '\n%s\n' "$endpoint"
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--write-out '\nHTTP %{http_code}\n' \
"https://api.flashdata.dev/v2/api-access/$endpoint" || exit
done
)try {
foreach ($flashdataPath in @('identity', 'balance', 'pricing?source=google_search&request_count=1')) {
Write-Host $flashdataPath
$flashdataRead = @{
Uri = "https://api.flashdata.dev/v2/api-access/$flashdataPath"
Headers = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
TimeoutSec = 20
MaximumRedirection = 0
ErrorAction = 'Stop'
}
Invoke-RestMethod @flashdataRead | ConvertTo-Json -Depth 20
}
} catch {
throw
}identity- Підтвердіть призначене accountId, access: "ready", обсяги, що містять "google_search", і будь-який expiresAt. accountType є "owned" для ключа власника або "temporary" для тестового ключа.
balance- Читати availableCredits. Всі ключі для даного облікового запису використовують однаковий баланс.
pricing- Для prices[0] підтвердіть джерело google_search і доступний true. Порівняйте estimatedCredits для requestCount: 1 з availableCredits. Ціни і баланси можуть змінюватися перед подачею.
Наступний крок
Якщо крок не зникає
Прочитайте відповідь, надана в терміналі. JavaScript і Python звіт HTTP помилки і Retry-After до stderr. Кожен приклад подає один раз; він не автоматично переробляє.
- Відсутня або не підтримується опція
- Перевірити необхідну версію в обраному прикладі. Використовуйте PowerShell 7, а не Windows PowerShell 5.1, або використовуйте Bash з cURL 7.76+. JavaScript не потребує 22+; Python потребує 3.10+. Встановіть відсутній робочий час з офіційної сторінки завантаження, перекрийте термінал, потім знову встановіть ключ.
- Змішувач ключ / 401
- Встановіть FLASHDATA_API_KEY в цьому процесі і перевірте стиль знову. Поставка повного активного ключа API, без префікса ведмедя. Якщо це було скасовано або було викликано, використовуйте поточний уповноважений достовірність; не вставте його в чат.
- 403
- Перевірте identity.scopes для google_search і доступ до готовності. Запитати про відсутність дозволу власника; змінити джерело в запиті не надано доступу.
- 402
- Повторно перевірте баланс і порівняйте його з поточною ціною. Власник може переглянути Billing. Вичерпаний пробний доступ слід прив’язати до облікового запису власника; створення нового пробного доступу не є відновленням.
- 400 / 422
- Читати повернуті повідомлення про помилку. Перевірити точну кількість даних, метод POST, Content-Type та JSON. Використовуйте прямі котирування та нумерична params.num, потім виправте відхилений запит.
- 429
- Зверніть увагу, що Retry-After, якщо присутні; в іншому випадку використовується обмежений зворотний зв'язок і зменшити опуклість. Не петля швидко, створити нові ключі або зареєструвати ще одну пробну версію для обходу ліміту.
- HTTP 200 з недійсним статусом або помилкою
- Прочитайте похибку в тілі і зберігайте будь-який запит або роботу ID. Не лікуйте тіло JSON як успішне завдання або автоматично відмініть його.
- Зручні результати
- У разі виконання статусу, автентифікації працювала. Зберігайте порожній результат або спробуйте більш широкий запит, як новий платний запит.
- Час, з'єднання втрат, 5xxx або HTML замість JSON
- А.А. POST може бути прийнята навіть якщо її відмова втратили. Перевірити History для оригінального запиту і зберегти будь-який повернутий IDs перед відмовою від перевитрат. Безкоштовна перевірка GET може бути перерозподілена. Підтвердіть URL використовує data.flashdata.dev, не відвідайте веб-сайт, і не відключити перевірку TLS.