Przeglądaj dokumentację
Pierwsze kroki
Zadzwoń do API Google Search i YouTube bezpośrednio nad HTTP. Wyślij jedną prośbę i przeczytaj odpowiedź JSON; nie jest wymagane SDK.
Uwierzytelnij
Utwórz konto, zweryfikuj swój e-mail i utwórz klucz za zgodą Google Search. Możesz ponownie użyć istniejącego klucza.
Uruchom polecenie w terminalu i wklej klucz w ukrytym polu wejściowym. Pomiń ten krok, jeśli FLASHDATA_API_KEY jest już ustawione.
Ustaw klucz# 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_KEYUstaw klucz# 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 flashdataSecureKeyWykonaj wyszukiwanie
Wybierz klienta i uruchom przykład w tym samym terminalu. Każdy z nich wysyła do POST jeden wniosek o wydanie https://data.flashdata.dev/v1/queries/realtime i drukuje JSON. Uwierzytelnij X-API-Key; wyślij JSON Content-Type: application/json.
cURL 7.76 + · Bash na Linux, macOS lub Git Bash. Wklej i uciekaj.
Wyszukiwanie · 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 + · Wklej to native PowerShell polecenie.
Wyszukiwanie · 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 + · Zapisz jako search.mjs i uruchom lokalnie lub na swoim serwerze. Używa built- in fetch; nie instaluje 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."); }Uruchom · JavaScriptnode search.mjsPython 3.10 + · Zapisz jako search.py. Wykorzystuje tylko standardową bibliotekę; nie instaluje pip. Użyj python3 lub py -3, jeśli jest to polecenie 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.")Uruchom · Pythonpython -X utf8 search.pySprawdź wynik
Potwierdź sukces HTTP i status: done. Czytaj tytuły źródłowe, odnośniki i snippety w results[].organic, a opłata w usage.credits.
Pusty wynik lub lista organiczna z status: done jest poprawnym pustym wynikiem.
Przykład odpowiedzi{ "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" potwierdza, że zapytanie zostało zakończone pomyślnie.
results[0].organic[]- Wyniki wyszukiwania. Sprawdź, czy wyniki nie są puste przed indeksowaniem.
title / link / snippet- Nazwa źródła, URL i fragment.
usage.credits- Rzeczywiste kredyty naliczane za to zapytanie.
Zapisz odpowiedź dla debugowania
Aby uchwycić następne zamierzone żądanie, dodaj te opcje do polecenia cURL powyżej. Sprawdź pliki przed podjęciem decyzji o ponownym uruchomieniu nieudanego żądania.
--dump-header response-headers.txt --output result.jsonSprawdzić dostęp i kredyty
Te żądania GET odczytują tożsamość, równowagę i ceny bez korzystania z kredytów zapytania. Oczekuj HTTP 200 i sprawdź pola poniżej przed przedłożeniem płatnej pracy.
Konto czyta: https://api.flashdata.dev/v2. Wnioski o dane: https://data.flashdata.dev/v1. Oba stosuje się X-API-Key; JSON POST wnioski również korzystać 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- Potwierdź zamierzony accountId, access: "ready", zakresy zawierające "google_search" i wszelkie expiresAt. accountType jest "owned" dla klucza właściciela lub "temporary" dla klucza próbnego.
balance- Przeczytaj availableCredits. Wszystkie klucze do tego konta używają tego samego salda.
pricing- Dla cen [0], potwierdź źródło jest google_search i dostępne jest true. Porównaj estimatedCredits dla requestCount: 1 z availableCredits Ceny i salda mogą ulec zmianie przed złożeniem.
Kolejne kroki
Jeśli krok zawiedzie
Przeczytaj odpowiedź wydrukowaną w terminalu. JavaScript i Python zgłaszają błędy HTTP i Retry-After do stderr. Każdy przykład przedstawia się raz; nie próbuje ponownie automatycznie.
- Brak polecenia lub nieobsługiwana opcja
- Sprawdź wymaganą wersję w wybranym przykładzie. PowerShell 7 zamiast Windows PowerShell 5.1 lub Bash z cURL 7.76 +. JavaScript potrzebuje Węzła 22 +; Python potrzebuje 3.10 +. Zainstaluj brakującą runtime ze swojej oficjalnej strony pobierania, ponownie otwórz terminal, a następnie ponownie ustaw klucz.
- Brak klucza / 401
- Ustaw FLASHDATA_API_KEY w tym procesie i sprawdź tożsamość ponownie. Dostarcz pełny aktywny klucz API, bez przedrostka Berera. Jeśli wygasł lub został cofnięty, użyj aktualnego autoryzowanego identyfikatora; nie wklej go do czatu.
- 403
- Sprawdź identity.scopes dla google_search i dostęp do niego. Żądanie brakującego zezwolenia od właściciela; zmiana źródła wniosku nie zapewnia dostępu.
- 402
- Przeczytaj jeszcze raz bilans i porównaj go z bieżącą ceną. Właściciel może przejrzeć Billing. Wyczerpana próba wymaga dostępu właściciela poprzez roszczenie; tworzenie procesu zastępczego nie jest odzyskiwanie.
- 400 / 422
- Odczytaj wiadomość o błędzie. Sprawdź dokładny host danych, metodę POST, Content-Type i nazwy pól JSON. Użyj prostych cytatów i liczbowego params.num, a następnie skorygować odrzucony wniosek.
- 429
- Poszanuj Retry-After, jeśli jest obecny; w przeciwnym razie należy użyć ograniczonego backupu i zmniejszyć współwartość. Nie pętli szybko, tworzyć nowe klucze lub zarejestrować inny proces, aby obejść limit.
- HTTP 200 z nieudanym statusem lub błędem
- Czytaj błąd w organizmie i zachować wszelkie życzenie lub zadanie ID. Nie należy traktować przepuszczanego ciała JSON jako udanego zadania ani automatycznie go ponownie uśmiercać.
- Puste wyniki
- Jeśli status jest gotowy, uwierzytelnienie działa. Zachować pusty wynik lub spróbować szersze zapytanie jako nowy wniosek płatny.
- Czas, utrata połączenia, 5xx lub HTML zamiast JSON
- POST mógł zostać przyjęty nawet jeśli jego odpowiedź została utracona. Zaznacz History dla oryginalnego zapytania i zachowaj zwrócone IDs przed podjęciem decyzji o ponownym odtworzeniu. Darmowe kontrole GET można ponownie spróbować. Potwierdź URL używa data.flashdata.dev, a nie hosta strony internetowej, i nie wyłączaj weryfikacji TLS.