YouTube API: Recherche — Tout par pays

Ce que fait cet endpoint

Ce que vous pouvez construire avec cette méthode d'API

Examinez d'abord le résultat et les flux courants, puis passez aux paramètres et à un exemple de requête fonctionnel.

À quoi sert cet endpoint

La réponse contient les Recherche correspondants, le contexte public et les données de pagination lorsque d'autres résultats sont disponibles.

Quand l'utiliser

Utilisez « Tout par pays » lorsque vous ne connaissez pas l'identifiant exact de l'objet et devez d'abord trouver des candidats pertinents.

Cas d'usage courants

Recherche dans le produit

Ajoutez la recherche dans les données YouTube aux interfaces clients et internes.

Constitution de catalogues

Trouvez des candidats par requête et conservez les objets pertinents pour un enrichissement ultérieur.

Études de marché

Collectez des ensembles de résultats pour analyser les sujets, les créateurs et la concurrence.

Versions disponibles

Version de la réponse

Les deux versions répondent au même besoin et acceptent les mêmes paramètres. Utilisez le sélecteur pour comparer la structure de la réponse et choisissez la version attendue par votre client.

Version de la réponse V2

Changez de version sur cette page pour comparer les structures de réponse sous la même URL de documentation.

Ce qui reste identique

L'authentification, les paramètres obligatoires et la forme de la requête sont identiques en V1 et V2. En pratique, vous choisissez la version en construisant le chemin de l'endpoint et en lisant la réponse.

Ce qui change entre les versions

La principale différence réside dans l'enveloppe de la réponse. Utilisez V2 pour les nouvelles intégrations et ne conservez V1 que si vous avez besoin de compatibilité avec un contrat client existant.

Comment l'utiliser

Comment appeler la méthode

Utilisez le même en-tête de clé API et les mêmes paramètres de requête dans les deux versions. Cette documentation présente d'abord l'ensemble commun de paramètres, puis les chemins et extraits de code de chaque version.

Paramètres d'entrée

Paramètres communs

Paramètre	Obligatoire	Type	Exemple	Description
`country_code`	Oui	`str`	`US`	Two-letter ISO 3166-1 alpha-2 country code used for YouTube localization. Example: US.
`query`	Oui	`str`	`technology review`	Requête de recherche saisie par l'utilisateur.
`cursor`	Non	`str \| None`	`cursor-next-page`	Curseur de la page suivante issu de la réponse précédente. À omettre pour la première page.

Chemin de requête par version

V2

Choisissez une version lorsque vous copiez le chemin exact de l'endpoint, l'URL d'exemple et l'extrait de code. La liste des paramètres ci-dessus ne change pas.

GET /api/v2/youtube.com/search/all-by-country

Format normalisé

Aperçu de la requête

URL de base https://www.scrapestorm.net

Endpoint /api/v2/youtube.com/search/all-by-country

Paramètres obligatoires

country_code query

Paramètres facultatifs

cursor

URL d'exemple

https://www.scrapestorm.net/api/v2/youtube.com/search/all-by-country?country_code=US&query=technology+review

Exemples de code

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/youtube.com/search/all-by-country" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'country_code=US' \
  --get --data-urlencode 'query=technology review' \
  # Optional parameters:
  # --data-urlencode 'cursor=cursor-next-page'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/youtube.com/search/all-by-country"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "country_code": "US",
    "query": "technology review",
}

# Optional parameters
# params["cursor"] = "cursor-next-page"

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v2/youtube.com/search/all-by-country";

const params = new URLSearchParams({
  country_code: "US",
  query: "technology review",
});

// Optional parameters
// params.set("cursor", "cursor-next-page");

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const payload = await response.json();
console.log(payload);

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  country_code: "US",
  query: "technology review",
};

// Optional parameters
// params.cursor = "cursor-next-page";

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "country_code" => "US",
    "query" => "technology review",
];

// Optional parameters
// $query["cursor"] = "cursor-next-page";

try {
    $response = $client->request("GET", "/api/v2/youtube.com/search/all-by-country", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "time"
)

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v2/youtube.com/search/all-by-country"

    params := url.Values{}
    params.Set("country_code", "US")
    params.Set("query", "technology review")

    // Optional parameters
    // params.Set("cursor", "cursor-next-page")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

Chemin de requête par version

V1

Choisissez une version lorsque vous copiez le chemin exact de l'endpoint, l'URL d'exemple et l'extrait de code. La liste des paramètres ci-dessus ne change pas.

GET /api/v1/youtube.com/search/all-by-country

Format natif de la plateforme

Aperçu de la requête

URL de base https://www.scrapestorm.net

Endpoint /api/v1/youtube.com/search/all-by-country

Paramètres obligatoires

country_code query

Paramètres facultatifs

cursor

URL d'exemple

https://www.scrapestorm.net/api/v1/youtube.com/search/all-by-country?country_code=US&query=technology+review

Exemples de code

curl --request GET \
  --url "https://www.scrapestorm.net/api/v1/youtube.com/search/all-by-country" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'country_code=US' \
  --get --data-urlencode 'query=technology review' \
  # Optional parameters:
  # --data-urlencode 'cursor=cursor-next-page'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v1/youtube.com/search/all-by-country"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "country_code": "US",
    "query": "technology review",
}

# Optional parameters
# params["cursor"] = "cursor-next-page"

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v1/youtube.com/search/all-by-country";

const params = new URLSearchParams({
  country_code: "US",
  query: "technology review",
});

// Optional parameters
// params.set("cursor", "cursor-next-page");

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const payload = await response.json();
console.log(payload);

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  country_code: "US",
  query: "technology review",
};

// Optional parameters
// params.cursor = "cursor-next-page";

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "country_code" => "US",
    "query" => "technology review",
];

// Optional parameters
// $query["cursor"] = "cursor-next-page";

try {
    $response = $client->request("GET", "/api/v1/youtube.com/search/all-by-country", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "time"
)

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v1/youtube.com/search/all-by-country"

    params := url.Values{}
    params.Set("country_code", "US")
    params.Set("query", "technology review")

    // Optional parameters
    // params.Set("cursor", "cursor-next-page")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

Exemple de réponse

Réponse en direct par version

L'aperçu contient les champs clés et les premiers éléments de la collection pour vous permettre de vérifier rapidement la forme de la réponse. Le format JSON change avec la version.

Exemple de réponse

V2 JSON de réponse

Exemple vérifié

Cet exemple JSON compact provient de la dernière vérification réussie de V2.

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "query": "technology review",
    "country_code": "US"
  },
  "data": {
    "estimated_results": 13105432,
    "videos": {
      "count": 18,
      "items": [
        {
          "author": {
            "url": "https://www.youtube.com/@howtomen",
            "channel_id": "UCqjVP9gAanUGFgTA5BRDvyA",
            "username": "howtomen",
            "display_name": "HowToMen"
          },
          "url": "https://www.youtube.com/watch?v=m9mCqZ7tmUg&pp=ygURdGVjaG5vbG9neSByZXZpZXc%3D",
          "video_id": "m9mCqZ7tmUg",
          "title": "CES 2026: 20 Best Tech You’ll Actually Want!",
          "snippet": "Here are the Best Gadgets at CES 2026 that will make you jealous that you don't own them! ▣ Aiper Learn more about AIPER ...",
          "published_time": "6 months ago",
          "duration_seconds": 1794,
          "duration_text": "29:54",
          "view_count": 836484,
          "badges": [
            "4K",
            "Verified"
          ],
          "thumbnail_url": "https://example.com/image.jpg",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/m9mCqZ7tmUg/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCxnjiJbLI1JSXtYNK8qUxr1GVkVA",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/m9mCqZ7tmUg/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBhirVSDkOJPc8X8Ybe0hXCvyj5nA",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "author": {
            "url": "https://www.youtube.com/@mkbhd",
            "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
            "username": "mkbhd",
            "display_name": "Marques Brownlee"
          },
          "url": "https://www.youtube.com/watch?v=86Gy035z_KA&pp=ygURdGVjaG5vbG9neSByZXZpZXc%3D",
          "video_id": "86Gy035z_KA",
          "title": "Apple Vision Pro Review: Tomorrow's Ideas... Today's Tech!",
          "snippet": "Apple Vision Pro is a glimpse into the future... with today'stechnologyActually using Vision Pro: ...",
          "published_time": "2 years ago",
          "duration_seconds": 1488,
          "duration_text": "24:48",
          "view_count": 8422625,
          "badges": [
            "4K",
            "CC",
            {
              "_more_items": 1
            }
          ],
          "thumbnail_url": "https://example.com/image.jpg",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/86Gy035z_KA/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDhQioYOOJmE0jdbgz-dgMbz_Gezw",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/86Gy035z_KA/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLA30oDwu6ljfOAPwnTY2k6Jx9BKnA",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "_more_items": 16
        }
      ]
    },
    "shorts": {
      "count": 25,
      "items": [
        {
          "url": "https://www.youtube.com/shorts/7x0JrWMqjsc",
          "video_id": "7x0JrWMqjsc",
          "title": "This 2016 Tech was SO Good",
          "view_count": 174000,
          "thumbnail_url": "https://example.com/image.jpg",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/7x0JrWMqjsc/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLA_yarKrG6CNziCwjx1SGgP-XflEg&usqp=CCk",
              "width": 405,
              "height": 720
            },
            {
              "url": "https://i.ytimg.com/vi/7x0JrWMqjsc/oardefault.jpg?sqp=-oaymwEgCJUDEOAESFWQAgHyq4qpAw8IARUAAIhCcAHAAQbIAQE=&rs=AOn4CLAT_BxR9wpvatawgp01H4h9FmZeIA&usqp=CCk",
              "width": 405,
              "height": 608
            }
          ]
        },
        {
          "url": "https://www.youtube.com/shorts/KG6Nu72Avqg",
          "video_id": "KG6Nu72Avqg",
          "title": "This Product Shouldn't Exist",
          "view_count": 27000000,
          "thumbnail_url": "https://example.com/image.jpg",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/KG6Nu72Avqg/oar2.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLCf5-tbd6B6q643_eA7BbZdeY50bA&usqp=CCk",
              "width": 405,
              "height": 720
            },
            {
              "url": "https://i.ytimg.com/vi/KG6Nu72Avqg/oar2.jpg?sqp=-oaymwEgCJUDEOAESFWQAgHyq4qpAw8IARUAAIhCcAHAAQbIAQE=&rs=AOn4CLD5W-6PrtVI1pEn88EhiwjPL-8hxQ&usqp=CCk",
              "width": 405,
              "height": 608
            }
          ]
        },
        {
          "_more_items": 23
        }
      ]
    },
    "channels": {
      "count": 1,
      "items": [
        {
          "url": "https://www.youtube.com/@mobiletechreview",
          "channel_id": "UCW6J17hZ_Vgr6cQgd_kHt5A",
          "username": "mobiletechreview",
          "display_name": "MobileTechReview",
          "verified": true,
          "snippet": "Lisa Gade from MobileTechReview brings you videoreviewsof the latest mobiletechnology: smartphones, Android tablets, ...",
          "subscriber_count": 969000,
          "badges": [
            "Verified"
          ],
          "avatar_url": "https://example.com/image.jpg",
          "avatar_urls": "https://example.com/image.jpg"
        }
      ]
    },
    "playlists": {
      "count": 0,
      "items": []
    }
  }
}

Exemple de réponse

V1 JSON de réponse

Exemple vérifié

Cet exemple JSON compact provient de la dernière vérification réussie de V1.

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "query": "technology review",
    "country_code": "US"
  },
  "data": {
    "responseContext": {
      "serviceTrackingParams": [
        {
          "service": "GUIDED_HELP",
          "params": [
            {
              "key": "context",
              "value": "yt_web_search"
            },
            {
              "key": "logged_in",
              "value": "0"
            }
          ]
        },
        {
          "service": "GFEEDBACK",
          "params": [
            {
              "key": "has_unlimited_entitlement",
              "value": "False"
            },
            {
              "key": "has_premium_lite_entitlement",
              "value": "False"
            },
            {
              "_more_items": 2
            }
          ]
        },
        {
          "_more_items": 2
        }
      ],
      "mainAppWebResponseContext": {
        "loggedOut": true,
        "trackingParam": "k5_fmPxhoXZRD8kw1IVjqbQUdK0ycPfvcY33ldVKg7H4b0G7aUMo1HYAqzRMkuMESLBwOcCw59TLtslLKPQGSS"
      },
      "responseId": "IhMIhMj8ktXflQMVtdvOAB3mWg5e",
      "webResponseContextExtensionData": {
        "webResponseContextPreloadData": {
          "preloadMessageNames": [
            "twoColumnSearchResultsRenderer",
            "sectionListRenderer",
            {
              "_more_items": 66
            }
          ]
        },
        "hasDecorated": true
      }
    },
    "estimatedResults": "13109690",
    "contents": {
      "twoColumnSearchResultsRenderer": {
        "primaryContents": {
          "sectionListRenderer": {
            "contents": [
              "…",
              "…"
            ],
            "trackingParams": "CDwQui8iEwiEyPyS1d-VAxW1284AHeZaDl4=",
            "subMenu": {
              "searchSubMenuRenderer": "…"
            },
            "hideBottomSeparator": true,
            "targetId": "search-feed"
          }
        }
      }
    },
    "trackingParams": "CAAQvGkiEwiEyPyS1d-VAxW1284AHeZaDl7KAQRetfVv",
    "header": {
      "searchHeaderRenderer": {
        "chipBar": {
          "chipCloudRenderer": {
            "chips": [
              "…",
              "…",
              {
                "_more_items": 5
              }
            ],
            "trackingParams": "CDIQkVoiEwiEyPyS1d-VAxW1284AHeZaDl4=",
            "nextButton": {
              "buttonRenderer": "…"
            },
            "previousButton": {
              "buttonRenderer": "…"
            }
          }
        },
        "searchFilterButton": {
          "buttonRenderer": {
            "style": "STYLE_TEXT",
            "size": "SIZE_DEFAULT",
            "isDisabled": false,
            "text": {
              "runs": "…"
            },
            "icon": {
              "iconType": "TUNE"
            },
            "tooltip": "Search filters",
            "trackingParams": "CBMQ8FsiEwiEyPyS1d-VAxW1284AHeZaDl4=",
            "accessibilityData": {
              "accessibilityData": "…"
            },
            "command": {
              "clickTrackingParams": "CBMQ8FsiEwiEyPyS1d-VAxW1284AHeZaDl7KAQRetfVv",
              "openPopupAction": "…"
            },
            "iconPosition": "BUTTON_ICON_POSITION_TYPE_RIGHT_OF_TEXT"
          }
        },
        "trackingParams": "CBIQiOoKIhMIhMj8ktXflQMVtdvOAB3mWg5e"
      }
    },
    "topbar": {
      "desktopTopbarRenderer": {
        "logo": {
          "topbarLogoRenderer": {
            "iconImage": {
              "iconType": "YOUTUBE_LOGO"
            },
            "tooltipText": {
              "runs": "…"
            },
            "endpoint": {
              "clickTrackingParams": "CBEQsV4iEwiEyPyS1d-VAxW1284AHeZaDl7KAQRetfVv",
              "commandMetadata": "…",
              "browseEndpoint": "…"
            },
            "trackingParams": "CBEQsV4iEwiEyPyS1d-VAxW1284AHeZaDl4=",
            "overrideEntityKey": "EgZ0b3BiYXIg9QEoAQ%3D%3D"
          }
        },
        "searchbox": {
          "fusionSearchboxRenderer": {
            "icon": {
              "iconType": "SEARCH"
            },
            "placeholderText": {
              "runs": "…"
            },
            "config": {
              "webSearchboxConfig": "…"
            },
            "trackingParams": "CA0Q7VAiEwiEyPyS1d-VAxW1284AHeZaDl4=",
            "searchEndpoint": {
              "clickTrackingParams": "CA0Q7VAiEwiEyPyS1d-VAxW1284AHeZaDl7KAQRetfVv",
              "commandMetadata": "…",
              "searchEndpoint": "…"
            },
            "clearButton": {
              "buttonRenderer": "…"
            },
            "showImageSourceDialog": {
              "clickTrackingParams": "CA0Q7VAiEwiEyPyS1d-VAxW1284AHeZaDl7KAQRetfVv",
              "showDialogCommand": "…"
            },
            "disableAiAppearance": true
          }
        },
        "trackingParams": "CAEQq6wBIhMIhMj8ktXflQMVtdvOAB3mWg5e",
        "topbarButtons": [
          {
            "topbarMenuButtonRenderer": {
              "icon": "…",
              "menuRequest": "…",
              "trackingParams": "CAsQ_qsBGAAiEwiEyPyS1d-VAxW1284AHeZaDl4=",
              "accessibility": "…",
              "tooltip": "Settings",
              "style": "STYLE_DEFAULT"
            }
          },
          {
            "buttonRenderer": {
              "style": "STYLE_SUGGESTIVE",
              "size": "SIZE_SMALL",
              "text": "…",
              "icon": "…",
              "navigationEndpoint": "…",
              "trackingParams": "CAoQ1IAEGAEiEwiEyPyS1d-VAxW1284AHeZaDl4=",
              "targetId": "topbar-signin"
            }
          }
        ],
        "hotkeyDialog": {
          "hotkeyDialogRenderer": {
            "title": {
              "runs": "…"
            },
            "sections": [
              "…",
              "…",
              {
                "_more_items": 2
              }
            ],
            "dismissButton": {
              "buttonRenderer": "…"
            },
            "trackingParams": "CAgQteYDIhMIhMj8ktXflQMVtdvOAB3mWg5e"
          }
        },
        "backButton": {
          "buttonRenderer": {
            "trackingParams": "CAcQvIYDIhMIhMj8ktXflQMVtdvOAB3mWg5e",
            "command": {
              "clickTrackingParams": "CAcQvIYDIhMIhMj8ktXflQMVtdvOAB3mWg5eygEEXrX1bw==",
              "commandMetadata": "…",
              "signalServiceEndpoint": "…"
            }
          }
        },
        "forwardButton": {
          "buttonRenderer": {
            "trackingParams": "CAYQvYYDIhMIhMj8ktXflQMVtdvOAB3mWg5e",
            "command": {
              "clickTrackingParams": "CAYQvYYDIhMIhMj8ktXflQMVtdvOAB3mWg5eygEEXrX1bw==",
              "commandMetadata": "…",
              "signalServiceEndpoint": "…"
            }
          }
        },
        "a11ySkipNavigationButton": {
          "buttonRenderer": {
            "style": "STYLE_DEFAULT",
            "size": "SIZE_DEFAULT",
            "isDisabled": false,
            "text": {
              "runs": "…"
            },
            "trackingParams": "CAUQ8FsiEwiEyPyS1d-VAxW1284AHeZaDl4=",
            "command": {
              "clickTrackingParams": "CAUQ8FsiEwiEyPyS1d-VAxW1284AHeZaDl7KAQRetfVv",
              "commandMetadata": "…",
              "signalServiceEndpoint": "…"
            }
          }
        },
        "voiceSearchButton": {
          "buttonRenderer": {
            "style": "STYLE_DEFAULT",
            "size": "SIZE_DEFAULT",
            "isDisabled": false,
            "serviceEndpoint": {
              "clickTrackingParams": "CAIQ7a8FIhMIhMj8ktXflQMVtdvOAB3mWg5eygEEXrX1bw==",
              "commandMetadata": "…",
              "signalServiceEndpoint": "…"
            },
            "icon": {
              "iconType": "MICROPHONE_ON"
            },
            "tooltip": "Search with your voice",
            "trackingParams": "CAIQ7a8FIhMIhMj8ktXflQMVtdvOAB3mWg5e",
            "accessibilityData": {
              "accessibilityData": "…"
            }
          }
        }
      }
    },
    "targetId": "search-page",
    "frameworkUpdates": {
      "entityBatchUpdate": {
        "mutations": [
          {
            "entityKey": "EhhZa2ZjVEt4QVQzWV9haV9zdW1tYXJpZXMgPigB",
            "type": "ENTITY_MUTATION_TYPE_REPLACE",
            "payload": {
              "likeStatusEntity": "…"
            }
          },
          {
            "entityKey": "EhhfUGk3Z3pDRDBSOF9haV9zdW1tYXJpZXMgPigB",
            "type": "ENTITY_MUTATION_TYPE_REPLACE",
            "payload": {
              "likeStatusEntity": "…"
            }
          },
          {
            "_more_items": 3
          }
        ],
        "timestamp": {
          "seconds": "1784495869",
          "nanos": 479263553
        }
      }
    }
  }
}

Méthodes associées

Continuez avec Recherche

Les méthodes associées résolvent le même objet par un autre identifiant, ouvrent des détails ou passent à une vue agrégée.

Étapes suivantes

Poursuivez l'évaluation

Utilisez cette documentation comme premier point de décision, puis vérifiez les prix, la couverture de la plateforme et les règles d'intégration avant de connecter l'endpoint pour un usage récurrent.

Ouvrez la page de la plateforme YouTube

Comparez les entités associées, les groupes de méthodes d'API et la documentation liée avant l'implémentation.

Ouvrir la page de la plateforme

Comparez les prix des méthodes d'API

Vérifiez la place de cette méthode dans le tableau public des tarifs avant d'augmenter l'utilisation.

Voir les tarifs

Consultez les règles d'intégration

Confirmez l'authentification, les versions, les nouvelles tentatives et les différences entre test et production dans la documentation de démarrage.

Ouvrir la documentation

Questions fréquentes

Les questions que posent les équipes avant l'implémentation

Utilisez ces réponses pour décider si cette méthode d'API convient à votre flux, à votre choix de version et à votre plan de déploiement.

Quelles données renvoie cette méthode de l'API YouTube ?

La méthode exécute « Tout par pays » pour Recherche. L'exemple de réponse compact ci-dessous montre la structure exacte des champs.

Dois-je choisir V1 ou V2 ?

Choisissez V2 pour les nouvelles intégrations, car elle fournit une structure normalisée. N'utilisez V1 que pour la compatibilité avec des clients qui traitent déjà le format natif de la plateforme.

De quoi ai-je besoin pour la première requête ?

Créez une clé API, envoyez-la dans l'en-tête de la requête et renseignez les paramètres obligatoires du tableau. Les exemples de code contiennent déjà le bon chemin et la bonne structure de requête.

YouTube API: Recherche — Tout par pays

Ce que vous pouvez construire avec cette méthode d'API

À quoi sert cet endpoint

Quand l'utiliser

Cas d'usage courants

Recherche dans le produit

Constitution de catalogues

Études de marché

Version de la réponse

Ce qui reste identique

Ce qui change entre les versions

Comment appeler la méthode

Paramètres d'entrée

Chemin de requête par version

Exemples de code

Chemin de requête par version

Exemples de code

Réponse en direct par version

V2 JSON de réponse

V1 JSON de réponse

Continuez avec Recherche

Recherche: Chaînes par pays

Recherche: Vidéos en direct par pays

Recherche: Movies By Country

Recherche: Playlists By Country

Poursuivez l'évaluation

Ouvrez la page de la plateforme YouTube

Comparez les prix des méthodes d'API

Consultez les règles d'intégration

Les questions que posent les équipes avant l'implémentation