# API Quickstart

Rufen Sie Google Search und YouTube APIs direkt über HTTP auf. Senden Sie eine Anfrage und lesen Sie die Antwort von JSON; es ist kein SDK erforderlich.

Kanonische Referenz: https://flashdata.dev/de/docs/guides/http-quickstart
Test: 2026-11-04 von FlashData

<a id="application"></a>

## Machen Sie Ihre erste HTTP-Anfrage

Legen Sie Ihren API-Schlüssel fest, senden Sie eine Google-Suche und prüfen Sie die gespeicherte Antwort.


<a id="prepare"></a>

### Authentifizierend

Erstellen Sie ein Konto, überprüfen Sie Ihre E-Mail und erstellen Sie einen Schlüssel mit der Google Search-Berechtigung. Sie können einen vorhandenen Schlüssel wiederverwenden.

Führen Sie den Befehl im Terminal aus und fügen Sie Ihren Schlüssel in die verdeckte Eingabe ein. Überspringen Sie diesen Schritt, wenn FLASHDATA_API_KEY bereits gesetzt ist.

#### Bash

##### Schlüssel setzen

```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
```


#### PowerShell 7

##### Schlüssel setzen

```powershell
# 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
```


- [Konto erstellen](https://flashdata.dev/signup)
- [API Keys öffnen](https://flashdata.dev/app/api-keys)
- [Agent-Authentifizierung](https://flashdata.dev/auth.md)

<a id="curl"></a>

### Suche ausführen

Wählen Sie einen Client aus und führen Sie das Beispiel im selben Terminal aus. Jeder sendet eine POST-Anfrage an https://data.flashdata.dev/v1/queries/realtime und druckt JSON aus. Authentifizierung mit X-API-Key; senden Sie JSON mit Content-Type: application/json.

#### cURL

cURL 7.76+ · Bash auf Linux, macOS oder Git Bash. Paste und Run.

##### Suche · Bash / cURL

```bash
curl --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 7+ · Fügen Sie diesen nativen PowerShell-Befehl ein.

##### Suche · 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."
}
```


#### JavaScript

Node.js 22+ · Speichern Sie als search.mjs und laufen Sie lokal oder auf Ihrem Server. Verwendet eingebauten Fetch; keine npm Installation.

##### search.mjs

```javascript
const 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.");
}
```

##### Laufen · JavaScript

```bash
node search.mjs
```


#### Python

Python 3.10+ · Speichern Sie als search.py. Verwendet nur die Standardbibliothek; keine pip Installation. Verwenden Sie python3 oder py -3, wenn dies Ihr Befehl Python ist.

##### search.py

```python
import 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.")
```

##### Laufen · Python

```bash
python -X utf8 search.py
```



<a id="result"></a>

### Ergebnis prüfen

HTTP Erfolg und status: done. Lesen Sie Quelltitel, Links und Snippets in results[].organic und die Ladung in usage.credits.

Eine leere Ergebnisse oder organische Liste mit status: done ist ein gültiges leeres Ergebnis.

| Feld | Verwenden Sie es für |
| --- | --- |
| status | "done" bestätigt, dass die Abfrage erfolgreich abgeschlossen wurde. |
| results[0].organic[] | Suchergebnisse. Überprüfen Sie, ob die Ergebnisse nicht leer sind, bevor Sie sie indizieren. |
| title / link / snippet | Quelltitel, URL und Auszug. |
| usage.credits | Tatsächliche credits, die für diese abfrage berechnet werden. |

#### Beispielantwort

```json
{
  "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
  }
}
```


<a id="diagnostics"></a>

## Speichern Sie eine Antwort für Debugging

Um die nächste beabsichtigte Anforderung zu erfassen, fügen Sie diese Optionen dem oben genannten Befehl cURL hinzu. Überprüfen Sie die Dateien, bevor Sie sich entscheiden, eine fehlgeschlagene Anforderung erneut zu versuchen.

### cURL

```bash
--dump-header response-headers.txt --output result.json
```

- [HTTP Fehler und Wiederherstellung](https://flashdata.dev/de/docs/errors/reference.md)

<a id="check"></a>

## Zugriff und Credits prüfen

Diese GET-Anforderungen lesen Identität, Saldo und Preisgestaltung, ohne Abfragegutschriften zu verwenden. Erwarten Sie HTTP 200 und überprüfen Sie die Felder unten, bevor Sie bezahlte Arbeit einreichen.

Konto liest: https://api.flashdata.dev/v2. Datenanforderungen: https://data.flashdata.dev/v1. Beide verwenden X-API-Key; JSON POST-Anforderungen verwenden auch Content-Type: application/json.

| Lesen | Was in der Antwort zu überprüfen ist |
| --- | --- |
| identity | Bestätigen Sie den beabsichtigten accountId, access: "ready", Scopes, die "google_search" und einen beliebigen expiresAt enthalten. accountType ist "owned" für einen Besitzerschlüssel oder "temporary" für einen Testschlüssel. |
| balance | Lesen Sie availableCredits. Alle Schlüssel für dieses Konto verwenden den gleichen Saldo. |
| pricing | Für Preise[0] ist die Bestätigungsquelle google_search und verfügbar ist true. Vergleichen Sie estimatedCredits mit requestCount: 1 mit availableCredits. Preise und Salden können sich vor der Einreichung ändern. |

### Bash / cURL

#### Kostenlose Schecks · Bash

```bash
(
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
)
```


### PowerShell 7

#### Kostenlose Schecks · PowerShell

```powershell
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
}
```



<a id="next"></a>

## Nächste Schritte

- [Google Search Best Practices](https://flashdata.dev/de/docs/guides/google-search-guide/reference.md)
- [YouTube Data](https://flashdata.dev/de/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/de/docs/guides/youtube-download-guide/reference.md)
- [API-Referenz](https://flashdata.dev/de/docs/api-reference/reference.md)
- [OpenAPI-Spezifikation](https://flashdata.dev/docs/openapi.json)

<a id="troubleshooting"></a>

## Wenn ein Schritt fehlschlägt

Lesen Sie die in Ihrem Terminal gedruckte Antwort. JavaScript und Python melden HTTP Fehler und Retry-After an stderr. Jedes Beispiel wird einmal eingereicht; es wird nicht automatisch wiederholt.

| Symptom | Nächste Maßnahme |
| --- | --- |
| Befehl fehlende oder nicht unterstützte Option | Überprüfen Sie die gewünschte Version im ausgewählten Beispiel. Verwenden Sie PowerShell 7 anstelle von Windows PowerShell 5.1 oder verwenden Sie Bash mit cURL 7.76+. JavaScript benötigt Node 22+; Python benötigt 3.10+. Installieren Sie die fehlende Laufzeit von der offiziellen Download-Seite, öffnen Sie das Terminal erneut und setzen Sie den Schlüssel erneut. |
| Fehlender Schlüssel / 401 | Setzen Sie FLASHDATA_API_KEY in diesem Prozess und überprüfen Sie die Identität erneut. Geben Sie den vollen aktiven API-Schlüssel ohne Bearer-Präfix ein. Wenn es abgelaufen ist oder widerrufen wurde, verwenden sie einen aktuellen autorisierten anmeldenachweis; fügen sie ihn nicht in den chat ein. |
| 403 | Überprüfen Sie identity.scopes für google_search und Zugriff für bereit. Fordern Sie die fehlende Berechtigung vom Eigentümer an; das Ändern der Quelle in der Anforderung gewährt keinen Zugriff. |
| 402 | Lesen Sie das Gleichgewicht noch einmal und vergleichen Sie es mit dem aktuellen Preis. Der Besitzer kann Billing überprüfen. Eine erschöpfte Studie benötigt den Zugriff des Besitzers durch Beanspruchung; das Erstellen einer Ersatzstudie ist keine Wiederherstellung. |
| 400 / 422 | Lesen Sie die zurückgegebene Fehlermeldung. Überprüfen Sie den genauen Datenhost, die POST-Methode, die Feldnamen Content-Type und JSON. Verwenden Sie gerade Anführungszeichen und eine numerische params.num, dann korrigieren Sie die abgelehnte Anforderung. |
| 429 | Respektieren Sie Retry-After, falls vorhanden; ansonsten verwenden Sie ein begrenztes Backoff und reduzieren Sie die Parallelität. Schleifen Sie nicht schnell, erstellen Sie neue Schlüssel oder registrieren Sie eine andere Testversion, um das Limit zu umgehen. |
| HTTP 200 mit fehlgeschlagenem Status oder Fehler | Lesen Sie den Fehler im Körper und bewahren Sie jede Anfrage oder jeden Job ID auf. Behandeln Sie einen analysierten JSON-Körper nicht als erfolgreiche Aufgabe oder senden Sie ihn automatisch erneut ab. |
| Leerergebnisse | Wenn der Status abgeschlossen ist, funktionierte die Authentifizierung. Behalten Sie das leere Ergebnis bei oder versuchen Sie eine breitere Abfrage als neue bezahlte Anfrage. |
| Timeout, Verbindungsverlust, 5xx oder HTML anstelle von JSON | Ein POST wurde möglicherweise akzeptiert, auch wenn seine Antwort verloren ging. Überprüfen Sie History für die ursprüngliche Abfrage und bewahren Sie alle zurückgegebenen IDs auf, bevor Sie sich für das erneute Senden entscheiden. Kostenlose GET-Checks können erneut getestet werden. Bestätigen Sie, dass URL data.flashdata.dev verwendet, nicht den Website-Host, und deaktivieren Sie die TLS-Verifizierung nicht. |

- [Anfrageverlauf](https://flashdata.dev/app/jobs)
- [Schlüssel verwalten](https://flashdata.dev/app/api-keys)
- [cURL Downloads](https://curl.se/download.html)
- [PowerShell](https://learn.microsoft.com/powershell/scripting/install/installing-powershell)
- [Node.js Downloads](https://nodejs.org/en/download)
- [Python Downloads](https://www.python.org/downloads/)
