# Démarrage rapide

Lancez votre première recherche Google et obtenez des résultats structurés pour votre application ou votre agent IA.

Référence canonique : https://flashdata.dev/fr/docs/guides/quickstart
Vérifié le 2026-11-04 par FlashData

<a id="agent"></a>

## Commencez avec votre agent IA

Transmettez ces instructions à un agent disposant d’un terminal. Il configurera FlashData et effectuera une recherche.

### Instructions de configuration et première tâche

```text
Lisez https://flashdata.dev/auth.md et suivez les instructions de configuration de FlashData pour cet environnement. Réutilisez les accès existants ; à défaut, démarrez un seul essai si vous y êtes admissible. Recherchez "battery recycling research" sur Google et demandez au plus cinq résultats. Renvoyez les titres, les URL et les crédits réellement consommés. Conservez les identifiants dans un stockage protégé, jamais dans la conversation. Si l’accès est bloqué, indiquez l’étape suivante au lieu de créer un autre essai.
```

- [Configurer MCP](https://flashdata.dev/fr/docs/integrations/mcp-clients/reference.md)
- [Skills pour agents](https://flashdata.dev/fr/docs/guides/agent-skill/reference.md)

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

## Effectuez votre premier appel API

Vous préférez écrire le code ? Suivez ces trois étapes dans votre terminal.


<a id="api-key"></a>

### Obtenez une clé API

Créez un compte, vérifiez votre adresse e-mail et créez une clé autorisant Google Search. Si vous disposez déjà d’une clé, réutilisez-la.

Exécutez cette commande dans votre terminal et collez la clé dans la saisie masquée. Ignorez cette étape si FLASHDATA_API_KEY est déjà définie.

#### Bash

##### Définir votre clé

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

##### Définir votre clé

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


- [Créer un compte](https://flashdata.dev/signup)
- [Ouvrir les clés API](https://flashdata.dev/app/api-keys)

<a id="request"></a>

### Lancer une recherche

Choisissez votre langage et exécutez l’exemple dans le même terminal. Chaque exécution effectue une recherche.

#### Python

Python 3.10+ · Enregistrez l’exemple dans quickstart.py.

##### Installer

```bash
python -m pip install "flashdata==1.1.0"
```

##### quickstart.py

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

##### Exécuter

```bash
python quickstart.py
```


#### TypeScript

Node.js 22.18+ · Partez d’un dossier vide et enregistrez quickstart.mts.

##### Configurer

```bash
npm init -y
npm install --save-exact @flashdata-dev/sdk@1.1.0
```

##### quickstart.mts

```typescript
import { 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));
```

##### Exécuter

```bash
node quickstart.mts
```


#### JavaScript

Node.js 22+ · Partez d’un dossier vide et enregistrez quickstart.mjs.

##### Configurer

```bash
npm init -y
npm install --save-exact @flashdata-dev/sdk@1.1.0
```

##### quickstart.mjs

```javascript
import { 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));
```

##### Exécuter

```bash
node quickstart.mjs
```


#### Go

Go 1.25+ · Partez d’un dossier vide et enregistrez main.go. Dans un module existant, omettez go mod init.

##### Configurer

```bash
go mod init example.com/flashdata-quickstart
go get github.com/flashdatadev/flashdata-go@v1.1.0
```

##### main.go

```go
package 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)
    }
}
```

##### Exécuter

```bash
go run .
```


#### HTTP API

Aucun SDK nécessaire. Exécutez la commande Bash / cURL 7.76+ ou la commande PowerShell 7.

##### Bash / cURL

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

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


- [Vérifier le résultat ci-dessous](https://flashdata.dev/fr/docs/guides/quickstart/reference.md#result)

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

### Vérifiez le résultat

Une réponse réussie contient status: done. Les sources se trouvent dans results[].organic et les crédits facturés dans usage.credits.

#### Exemple de réponse (extrait)

```json
{
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "Battery recycling research",
          "link": "https://example.org/recycling",
          "snippet": "An example search excerpt."
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  }
}
```

- [Affiner votre recherche](https://flashdata.dev/fr/docs/guides/google-search-guide/reference.md)
- [Essayer les données YouTube](https://flashdata.dev/fr/docs/guides/youtube-data-guide/reference.md)
- [Configuration et dépannage de l’API](https://flashdata.dev/fr/docs/guides/http-quickstart/reference.md)

<a id="console"></a>

## Essayez la console

1. Créez un compte ou connectez-vous. Vérifiez votre adresse e-mail et terminez les étapes de configuration affichées dans la console.
2. Ouvrez Google Search, sélectionnez la source Google Search et le mode Realtime, puis saisissez battery recycling research. Développez Additional parameters et définissez Page size (num) sur 5.
3. Vérifiez la requête affichée et les crédits disponibles, puis lancez la recherche une seule fois.
4. Examinez la réponse et la consommation. Ouvrez une source renvoyée pour en vérifier le contenu avant de citer davantage que son extrait.

- [Créer un compte](https://flashdata.dev/signup)
- [Ouvrir Google Search](https://flashdata.dev/app/google-search)

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

## Allez plus loin

- [Rechercher avec des filtres](https://flashdata.dev/fr/docs/guides/google-search-guide/reference.md)
- [Explorer les données YouTube](https://flashdata.dev/fr/docs/guides/youtube-data-guide/reference.md)
- [Ajouter la recherche à une application](https://flashdata.dev/fr/docs/guides/search-in-an-app/reference.md)

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

## Si la première requête échoue

| Symptôme | Solution |
| --- | --- |
| FLASHDATA_API_KEY manquante | Définissez la clé dans le terminal ou l’environnement qui exécute l’exemple ; ces extraits ne chargent pas les fichiers .env. |
| 401 / 403 | Vérifiez que la clé ou la connexion est active et dispose de l’autorisation google_search. |
| 402 | Vérifiez les crédits disponibles dans Billing. Rattachez l’essai existant si un accès titulaire est nécessaire. |
| 429 | Respectez Retry-After. Conservez la même identité et la même preuve d’inscription ; ne créez pas un autre essai. |
| Délai dépassé ou résultat de soumission inconnu | Vérifiez l’exécution existante avant de réessayer. Avec la CLI, conservez le profil et l’identifiant d’exécution ; avec un SDK ou l’API, conservez tout identifiant de tâche ou de requête reçu. |

