# FlashData API Google Videos

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.

Référence canonique : https://flashdata.dev/fr/docs/sources/google_videos
Révisé le : 2026-10-23

Endpoint: POST https://data.flashdata.dev/v1/queries/realtime
Authentification: X-API-Key: YOUR_API_KEY
Modes: [Temps réel](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#realtime) · [Asynchrone](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/fr/docs/reference/batch-and-bulk/reference.md#batch)

Autorisation requise pour la source: google_videos

Remplacez YOUR_API_KEY par une clé API disposant de la permission requise pour cette source et d’un solde de crédits disponible. Exécutez les requêtes sur votre serveur ou dans l’environnement de votre agent.

[Configurer l’authentification](https://flashdata.dev/fr/docs/guides/headers-and-authentication/reference.md)

[Choisir et affiner une recherche Google](https://flashdata.dev/fr/docs/guides/google-search-guide/reference.md)

<a id="quickstart"></a>

## Envoyer une requête

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "google_videos",
    "query": "me at the zoo",
    "params": {
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries/realtime" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "google_videos",
  "query": "me at the zoo",
  "params": {
    "gl": "us",
    "hl": "en",
    "num": 10,
    "page": 1
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## Paramètres

<a id="parameters-group-0"></a>

### Corps de la requête

| Paramètre | Type | Obligatoire | Par défaut | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Oui | — | Définissez ce champ sur google_videos.  |
| <a id="parameter-query"></a> query | string | Oui | Non défini | Requête de recherche. Les opérateurs Google tels que site: et intitle: sont pris en charge. Longueur minimale : 1. Longueur maximale : 2000. |
| <a id="parameter-params"></a> params | object | Non | {} | Paramètres de cette requête.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Non | Non défini | Async et Batch uniquement. URL HTTPS publique de notification sur le port 443, de 2 048 caractères maximum, sans identifiants ni fragment. Omettez ce champ, ou utilisez null ou une chaîne vide pour désactiver les notifications. Dans un Batch, définissez-le pour chaque requête, en dehors de params.  |

<a id="parameters-group-1"></a>

### Pays, langue et lieu

| Paramètre | Type | Obligatoire | Par défaut | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Non | Non défini | Code pays à deux lettres, par exemple us, gb, de ou sg. Renseignez-le explicitement pour sélectionner un pays. Longueur minimale : 2. Longueur maximale : 2. Format : ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Non | Non défini | Langue de l’interface Google. Renseignez ce champ explicitement pour sélectionner une langue. Longueur minimale : 1. Longueur maximale : 35. Format : ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Non | Non défini | Lieu de recherche demandé, de préférence une ville, par exemple "London, England, United Kingdom". Sa prise en compte dépend du type de recherche. Longueur minimale : 1. Longueur maximale : 200. |

<a id="parameters-group-2"></a>

### Pagination

| Paramètre | Type | Obligatoire | Par défaut | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Non | Non défini | Nombre de résultats demandé. Si ce champ est omis, FlashData n’ajoute pas de valeur par défaut fixe. Le nombre renvoyé peut varier selon la requête et le type de recherche. Minimum : 1. Maximum : 100. |
| <a id="parameter-params-page"></a> params.page | integer | Non | Non défini | Numéro de la page de résultats demandée. Renseignez-le explicitement. Chaque page nécessite une requête API distincte. Minimum : 1. Maximum : 100. |

<a id="parameters-group-3"></a>

### Filtres de recherche

| Paramètre | Type | Obligatoire | Par défaut | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Non | Non défini | Filtres de recherche Google demandés, par exemple qdr:d pour les dernières 24 heures ou qdr:w pour les sept derniers jours. Leur disponibilité dépend du type de recherche. Longueur minimale : 1. Longueur maximale : 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Non | Non défini | Utilisez true pour demander la correction orthographique, ou false pour demander sa désactivation. Le comportement dépend du type de recherche ; omettez ce champ pour conserver le comportement de Google.  |

<a id="response"></a>

## Lire le résultat

Enregistrez la réponse JSON d’une requête réussie dans response.json. Enregistrez le script ci-dessous dans read-response.py, dans le même dossier, puis exécutez python read-response.py. Il utilise uniquement la bibliothèque standard de Python et n’envoie aucune nouvelle requête.

### read-response.py

```python
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = [
    {"title": item.get("title"), "url": item.get("link"), "duration": item.get("duration")}
    for item in result.get("videos", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## Exemple de réponse

Exemple enregistré ; les champs et les nombres de résultats dépendent de la source et des paramètres de la requête.
```json
{
  "source": "google_videos",
  "status": "done",
  "results": [
    {
      "searchParameters": {
        "q": "me at the zoo",
        "gl": "us",
        "hl": "en",
        "type": "videos",
        "num": 10,
        "page": 1,
        "engine": "google"
      },
      "videos": [
        {
          "title": "Me at the zoo",
          "link": "https://www.youtube.com/watch?v=jNQXAC9IVRw&vl=en",
          "snippet": "Microplastics are accumulating in human brains at an alarming rate https://www.youtube.com/watch?v=0PT5c1z3LL8 “Nanoplastics and Human ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNoybJBMfqr7vwH-saySvflZreMzBKZDBjW_zQMrY81E-xQZBBMzVuRw&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcS8uZHJMduuLjzsxqOtyhx8VWeRlui2Fo0sUg",
          "duration": "0:19",
          "source": "YouTube",
          "channel": "jawed",
          "date": "Apr 23, 2005",
          "position": 1
        },
        {
          "title": "Me at the zoo - 20 Years Later",
          "link": "https://www.youtube.com/watch?v=ydEMNzksm2M",
          "snippet": "A FAN RECREATION. same location. same outfit kinda sorta. different guy. 20 years later @jawed New video: https://youtu.be/vRgvdCkzvws How ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR8mNQG1XbHxQwXcM0_B0L3wpgVPSmORnijKhh5knB2aRxvmApdoyigXw&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcR1ZyuOVJiBgaK96Ew85Bx19aYKLXddf-dcDQ",
          "duration": "0:45",
          "source": "YouTube",
          "channel": "Cody Hales",
          "date": "Apr 23, 2025",
          "position": 2
        },
        {
          "title": "Me at the zoo",
          "link": "https://youtube.com/watch?v=jNQXAC9IVRw&si=EnSIkaIECMiOmarE",
          "snippet": "Microplastics are accumulating in human brains at an alarming rate https://www.youtube.com/watch?v=0PT5c1z3LL8 “Nanoplastics and Human ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNoybJBMfqr7vwH-saySvflZreMzBKZDBjW_zQMrY81E-xQZBBMzVuRw&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcS8uZHJMduuLjzsxqOtyhx8VWeRlui2Fo0sUg",
          "duration": "0:19",
          "source": "YouTube",
          "channel": "jawed",
          "date": "Apr 23, 2005",
          "position": 3
        },
        {
          "title": "Me at the Zoo 21 Years Later",
          "link": "https://www.youtube.com/watch?v=NiIqMwDDPQQ",
          "snippet": "YouTube's First Video: Me at the zoo by Jawed Karim in 2005 A Look back some history of Youtube's creation and what happened to the ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSELgaIiAXmIin2tym4YpTtUt3a9LT66r3qpMkg3Cm2erBOcUc_cOzfxQ&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcRSNKT2ukHk51PE2iHMpOXn0Fk-NYYzcjdtzg",
          "duration": "2:37",
          "source": "YouTube",
          "channel": "AcidGlow",
          "date": "Apr 26, 2026",
          "position": 4
        },
        {
          "title": "Me at the Zoo | 20 years of YouTube",
          "link": "https://www.youtube.com/watch?v=SKcXEYqsX1M",
          "snippet": "20 years ago, the first video was uploaded to YouTube, by Jawed. This is my remake of that first video uploaded to YouTube back on 23rd ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRYk6-MZVYhxJohW4sXDVRGWjqp796KjEJgWqKeZtfQAhCtMkyiVfVVjQ&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcSPcbOknGe09bBsfDEZ8OJXxOnYAFxeiMzRIg",
          "duration": "1:40",
          "source": "YouTube",
          "channel": "Alice Goss Travel",
          "date": "Apr 22, 2025",
          "position": 5
        },
        {
          "title": "happy 20th birthday YouTube! on this day, 2005, the first ever ...",
          "link": "https://www.facebook.com/lestwinsforsmartpeople/videos/happy-20th-birthday-youtube-on-this-day-2005-the-first-ever-video-was-uploaded-t/1174885864134048/",
          "snippet": "❤ on this day, 2005, the first ever video was uploaded to YouTube: \"Me at the Zoo\" by Jawed Karim, one of the founders of YouTube. I opened my ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQXK7QFFc7Ve5rxWu28XVD7PwN4wMGxFwBGODfb0inSiJkJXkLfspNBBQ&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcQwaWPOAa18cvUeFQmJ83tHI75KwkZZXhcz1g",
          "duration": "0:20",
          "source": "Facebook",
          "channel": "Les Twins for smart people",
          "date": "Apr 23, 2025",
          "position": 6
        },
        {
          "title": "23rd April 2005: The first video uploaded to YouTube is \"Me at ...",
          "link": "https://www.youtube.com/watch?v=nW0JMJUW394&vl=en",
          "snippet": "... Me at the zoo” shows Karim speaking in front of the elephant enclosure at the San Diego Zoo in San Diego, California. The video lasts ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQKL5tOeVLTkPnKgGJ-irZeBKXegrS3jv3aOmqfPRvnDnFDH0wlm6KTsQ&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcT32pM4ScwLqW8pW44XEj6g02KCXVGZZU12oA",
          "duration": "2:30",
          "source": "YouTube",
          "channel": "HistoryPod",
          "date": "Apr 22, 2026",
          "position": 7
        },
        {
          "title": "Me at the zoo",
          "link": "https://www.youtube.com/shorts/bXz16dux7j0",
          "snippet": "Maybe it's time to go back to the zoo?",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTKNATyMcisc3lfWovvV89H6Pgk2EMqkA4wPBgN3hwB2D9r4c0vzj9qog&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcRo2eKznhm-_ijvAmb_52BgREvjyQVWcJ5arQ",
          "duration": "0:17",
          "source": "YouTube",
          "channel": "Timeworks",
          "date": "Apr 23, 2025",
          "position": 8
        },
        {
          "title": "Me At The Zoo",
          "link": "https://www.youtube.com/watch?v=SfSsDBEs1yc",
          "snippet": "Me At The Zoo • 20th Anniversary (24/04/2025) a huge shoutout to 'Me at the zoo' today as it becomes the first video on @YouTube to be 20 ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ6BBRlx150FgR3w89enIZwuSIm7gumK0O-yC7GqO_KF0zr8ZIGuNANHA&s",
          "videoUrl": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcSG5JQlJ3MiAYkmoTPoE-KLNrrS6rkWyAkJWw",
          "duration": "0:26",
          "source": "YouTube",
          "channel": "MrHaydnSir",
          "date": "Apr 24, 2025",
          "position": 9
        },
        {
          "title": "The first ever YouTube video, \"Me at the zoo\", turns 21 years ...",
          "link": "https://www.reddit.com/r/interesting/comments/1su0btj/the_first_ever_youtube_video_me_at_the_zoo_turns/",
          "snippet": "The first ever YouTube video, \"Me at the zoo\", turns 21 years old today. ... This video cannot be played. 0:00 0: ...",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR2us_fh54LqB7h_F3viDdnV4PCbByjapkYj5JO8I6SoErU3NPFrY5tYw&s",
          "duration": "0:18",
          "source": "Reddit",
          "channel": "Deleted User",
          "date": "Apr 24, 2026",
          "position": 10
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  },
  "created_at": "2026-09-16T07:41:45.419Z"
}
```

## Champs de réponse

| Champ | Type | Description |
| --- | --- | --- |
| source | string | Source API demandée. |
| status | string | done lorsque la requête realtime réussit. |
| created_at | string | Date et heure de création de la réponse au format ISO 8601. |
| usage.credits | number | Crédits facturés pour la requête selon votre offre. |
| results[0].searchParameters | object | Paramètres de recherche renvoyés par Google, avec la requête dans le champ q. Ces paramètres peuvent différer des valeurs demandées. |
| results[0].videos | array | Résultats de recherche vidéo de Google. |
| results[0].videos[].title | string | Titre de la vidéo. |
| results[0].videos[].link | string | URL de la page vidéo. |
| results[0].videos[].snippet | string · optional | Extrait de la description de la vidéo. |
| results[0].videos[].duration | string · optional | Durée de la vidéo sous forme de texte. |
| results[0].videos[].source | string · optional | Site hébergeant la vidéo. |
| results[0].videos[].channel | string · optional | Nom de l’éditeur ou de la chaîne. |
| results[0].videos[].date | string · optional | Date de publication telle qu’elle est affichée par Google. |
| results[0].videos[].imageUrl | string · optional | URL de la vignette de la vidéo. |
| results[0].videos[].position | integer | Position du résultat. |
| results[0].videos[].videoUrl | string · optional | URL de la vidéo renvoyée par Google, lorsqu’elle est disponible. |

- Les champs disponibles dépendent de la requête et du type de recherche. Les champs facultatifs peuvent être absents, et des champs supplémentaires peuvent être renvoyés.
- Le nombre d’éléments renvoyés et searchParameters.num peuvent différer de params.num. Comptez les éléments du tableau renvoyé pour connaître le nombre réel de résultats.

## Formats de réponse

Les réponses sont en JSON par défaut. Choisissez un autre format avec ces en-têtes facultatifs.

- Accept: application/json (par défaut) ou text/plain. Le texte brut présente les mêmes champs dans une disposition lisible avec indentation.
- X-Respond-With: markdown. Ne définissez pas cet en-tête pour conserver les champs d’origine. Markdown fonctionne avec les deux formats de réponse.

Markdown est disponible pour les requêtes realtime et les résultats de tâches terminées.

Les champs ci-dessous décrivent la réponse JSON par défaut.

[Exemples de formats de requête et de réponse](https://flashdata.dev/fr/docs/guides/response-formats/reference.md#headers)

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## Bases de l’API

Le générateur de requêtes et les exemples ci-dessus utilisent les paramètres de cette source. Consultez les exemples Python et cURL ci-dessous pour les étapes communes de soumission, de suivi et de récupération des résultats. Le corps d’une requête Batch est un objet JSON contenant queries ; chaque élément renvoie son propre identifiant de tâche.

- [Requête Async et reçu de soumission](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [Vérifier l’état de la tâche](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#status)

<a id="job-results"></a>

- [Récupérer les résultats des tâches terminées](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#results)
- [Requêtes JSON Batch](https://flashdata.dev/fr/docs/reference/batch-and-bulk/reference.md#batch)
- [Spécification OpenAPI publique](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## Notifications d'achèvement

- [Recevoir et vérifier les webhooks de fin de traitement](https://flashdata.dev/fr/docs/guides/async-batch/reference.md#webhooks)

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

## Dépannage

- [Erreurs et codes d’état](https://flashdata.dev/fr/docs/errors/reference.md#status-codes)
- [Quand réessayer](https://flashdata.dev/fr/docs/errors/reference.md#retries)

## API associées

- [API de recherche YouTube](https://flashdata.dev/fr/docs/sources/youtube_search/reference.md)
- [API Google Search](https://flashdata.dev/fr/docs/sources/google_search/reference.md)
