# Référence API

Paramètres, schémas de réponse et exemples exécutables pour chaque source.

Référence canonique: https://flashdata.dev/fr/docs/reference

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

## Principes des requêtes

Définissez source selon le produit souhaité et authentifiez-vous avec X-API-Key. Les pages ci-dessous détaillent les champs, les exemples de réponse et proposent un constructeur de requêtes interactif.

### Hôtes API

```text
Data API        https://data.flashdata.dev
Management API  https://api.flashdata.dev
Header          X-API-Key: YOUR_API_KEY
```

| Workflow | Requête | Réponse |
| --- | --- | --- |
| Temps réel · API de données | POST /v1/queries/realtime | Résultats de la source dans la réponse |
| Asynchrone · API de données | POST /v1/queries | Identifiant de tâche pour consulter l’état et les résultats |
| Batch · API de données | POST /v1/queries/batch | Accusé de réception distinct pour chaque requête |
| Bulk · Management API | POST /v2/bulk-jobs | Identifiant Bulk et URL signée pour envoyer le fichier d’entrée |
| Tâche · API de gestion | GET /v2/jobs/{id} | État d’une tâche existante |

### [API](https://flashdata.dev/fr/docs/guides/http-quickstart/reference.md)

Vous découvrez l’API ? Définissez votre clé et exécutez une première requête complète.

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

## Bases de l’API

### [Temps réel et asynchrone](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md)

Recevez les résultats dans la réponse ou soumettez une tâche pour les récupérer plus tard. Choisissez comment votre application ou votre agent attend le traitement.

### [Batch et Bulk](https://flashdata.dev/fr/docs/reference/batch-and-bulk/reference.md)

Choisissez Batch pour des requêtes indépendantes avec des entrées différentes. Choisissez Bulk pour un fichier d’identifiants vidéo nécessitant tous la même opération.

### [Formats de réponse](https://flashdata.dev/fr/docs/guides/response-formats/reference.md)

Choisissez du JSON structuré pour votre application ou du contenu Markdown pour un agent IA. Deux en-têtes contrôlent la réponse.

### [Erreurs et codes d’état](https://flashdata.dev/fr/docs/errors/reference.md)

Interprétez une erreur pour savoir s’il faut corriger la requête, réessayer ou arrêter.

<a id="google-search"></a>

## Google Search

### [Recherche](https://flashdata.dev/fr/docs/sources/google_search/reference.md)

Récupérez les résultats organiques, les questions associées et les résultats enrichis de Google Search au format JSON structuré. Filtrez par pays, langue et lieu.

source: `google_search`

### [Images](https://flashdata.dev/fr/docs/sources/google_images/reference.md)

Recherchez dans Google Images et récupérez les URL des images d’origine, les vignettes, les dimensions et les pages sources au format JSON.

source: `google_images`

### [Actualités](https://flashdata.dev/fr/docs/sources/google_news/reference.md)

Récupérez les articles Google News avec leurs titres, les publications sources, les liens et les dates de publication. Filtrez par pays, langue et période.

source: `google_news`

### [Shopping](https://flashdata.dev/fr/docs/sources/google_shopping/reference.md)

Recherchez des produits dans Google Shopping et récupérez leurs prix, les vendeurs, les notes et les liens au format JSON structuré.

source: `google_shopping`

### [Vidéos](https://flashdata.dev/fr/docs/sources/google_videos/reference.md)

Trouvez des vidéos sur différents sites avec Google Videos. Récupérez leurs titres, liens, vignettes, durées et informations sur les sources.

source: `google_videos`

### [Lieux](https://flashdata.dev/fr/docs/sources/google_places/reference.md)

Recherchez des établissements et des lieux. Récupérez leurs noms, adresses, coordonnées géographiques, notes et coordonnées de contact lorsqu’ils sont disponibles.

source: `google_places`

<a id="youtube-data"></a>

## Données YouTube

### [Recherche](https://flashdata.dev/fr/docs/sources/youtube_search/reference.md)

Recherchez des vidéos YouTube par mot-clé et récupérez leurs titres, chaînes, durées, nombres de vues et vignettes au format JSON.

source: `youtube_search`

### [Recherche étendue](https://flashdata.dev/fr/docs/sources/youtube_search_extended/reference.md)

Récupérez jusqu’à 700 résultats YouTube par requête, avec les détails des vidéos, les vignettes et des filtres de recherche.

source: `youtube_search_extended`

### [Métadonnées vidéo](https://flashdata.dev/fr/docs/sources/youtube_metadata/reference.md)

Récupérez les métadonnées d’une vidéo à partir de son identifiant YouTube : détails de la chaîne, statistiques d’interaction, vignettes, formats disponibles et chapitres.

source: `youtube_metadata`

### [Transcription](https://flashdata.dev/fr/docs/sources/youtube_transcript/reference.md)

Récupérez une transcription YouTube sous forme de texte horodaté et de texte intégral. Les sous-titres automatiques sont sélectionnés par défaut.

source: `youtube_transcript`

### [Sous-titres](https://flashdata.dev/fr/docs/sources/youtube_captions/reference.md)

Récupérez les sous-titres YouTube sous forme de texte horodaté et de transcription intégrale. Les sous-titres fournis par l’auteur de la vidéo sont sélectionnés par défaut.

source: `youtube_captions`

### [Chaîne](https://flashdata.dev/fr/docs/sources/youtube_channel/reference.md)

Récupérez le profil d’une chaîne YouTube et ses vidéos récentes à partir de son identifiant @ : nombre d’abonnés, images de la chaîne et détails des vidéos.

source: `youtube_channel`

### [Suggestion](https://flashdata.dev/fr/docs/sources/youtube_suggestions/reference.md)

Récupérez les suggestions de saisie automatique de YouTube pour un mot-clé ou une expression, en choisissant la langue et la région.

source: `youtube_suggestions`

### [Licences](https://flashdata.dev/fr/docs/sources/youtube_trainability/reference.md)

Vérifiez si les métadonnées de licence d’une vidéo YouTube portent une mention Creative Commons et récupérez le résultat au format JSON.

source: `youtube_trainability`

<a id="youtube-download"></a>

## Téléchargement YouTube

### [Téléchargement](https://flashdata.dev/fr/docs/sources/youtube_download/reference.md)

Téléchargez des vidéos ou de l’audio YouTube dans votre stockage cloud. Choisissez la résolution, le format et la durée de l’extrait, puis suivez la tâche asynchrone jusqu’à la fin.

source: `youtube_download`

<a id="bulk-processing"></a>

## Traitement Bulk

### [API de traitement Bulk](https://flashdata.dev/fr/docs/reference/bulk-processing/reference.md)

Créez et pilotez des tâches YouTube à partir de fichiers, puis récupérez leurs manifestes et leurs fichiers de résultats.

<a id="group-5"></a>

## Références des protocoles

### [API de gestion](https://flashdata.dev/fr/docs/api-reference/reference.md)

Tâches, accès au compte, inscription des agents, rattachement et transfert des identifiants.

### [Outils et schémas MCP](https://flashdata.dev/fr/docs/mcp/reference.md)

Arguments des outils, accès au compte, tâches en arrière-plan et résultats volumineux.

<a id="group-6"></a>

## Spécifications et références des clients

### [Spécification OpenAPI (JSON)](https://flashdata.dev/docs/openapi.json)

Opérations et schémas lisibles par les outils de développement API.

### [Référence des commandes CLI](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

Commandes, options et codes de sortie de la version 1.2.1. Ouvre GitHub.

### [Référence des méthodes du SDK Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

Méthodes et types du client en version 1.1.0. Ouvre GitHub.
