Búsqueda en YouTube

Aprende cómo obtener datos de búsqueda de YouTube para vídeos, canales y listas de reproducción usando la Web Scraper API. Conoce sus parámetros y ve una solicitud de ejemplo.

Puedes buscar en YouTube videos, canales, listas de reproducción o películas proporcionando una búsqueda query al youtube_search o youtube_search_max .

Elyoutube_search la fuente permite recuperar hasta 20 resultados de búsqueda, mientras que la youtube_search_max fuente puede devolver hasta 700 resultados en una única respuesta.

Esta fuente también se puede combinar con youtube_autocomplete fuente para incluir sugerencias y orientar palabras clave y términos de búsqueda relevantes.

Los siguientes ejemplos muestran cómo utilizar youtube_search fuente para obtener videos de YouTube basados en una búsqueda consulta.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "youtube_search",
        "query": "how to make a website"
    }'

import requests
from pprint import pprint

# Estructurar payload.
payload = {
    'source': 'youtube_search',
    'query': 'how to make a website'
}

# Obtener respuesta.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('user', 'pass1'),
    json=payload,
)

# Imprime la respuesta JSON con el resultado.
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
  source: "youtube_search",
  query: "how to make a website"
};
const options = {
  hostname: "realtime.oxylabs.io",
  path: "/v1/queries",
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization:
      "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
  },
};
const request = https.request(options, (response) => {
  let data = "";
  response.on("data", (chunk) => {
    data += chunk;
  });
  response.on("end", () => {
    const responseData = JSON.parse(data);
    console.log(JSON.stringify(responseData, null, 2));
  });
});
request.on("error", (error) => {
  console.error("Error:", error);
});
request.write(JSON.stringify(body));
request.end();

<?php

$params = array(
    'source' => 'youtube_search',
    'query' => 'how to make a website'
);
   
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");

$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}

curl_close($ch);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	const Username = "USERNAME"
	const Password = "PASSWORD"

	// Define the payload with the new youtube_metadata query.
	payload := map[string]interface{}{
		"source": "youtube_search",
		"query":  "how to make a website
	}

	jsonValue, err := json.Marshal(payload)
	if err != nil {
		fmt.Println("Error marshalling JSON:", err)
		return
	}

	client := &http.Client{}
	request, err := http.NewRequest("POST", "https://realtime.oxylabs.io/v1/queries", bytes.NewBuffer(jsonValue))
	if err != nil {
		fmt.Println("Error creating request:", err)
		return
	}

	request.SetBasicAuth(Username, Password)
	request.Header.Set("Content-Type", "application/json")

	response, err := client.Do(request)
	if err != nil {
		fmt.Println("Error making request:", err)
		return
	}
	defer response.Body.Close()

	responseText, err := ioutil.ReadAll(response.Body)
	if err != nil {
		fmt.Println("Error reading response:", err)
		return
	}

	fmt.Println(string(responseText))
}

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Text;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new
            {
                source = "youtube_search",
                query = "how to make a website",
                context = new[]
                {
                    new { key = "language_code", value = "en" },
                    new { key = "transcript_origin", value = "uploader_provided" }
                }
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(Encoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            try
            {
                var response = await client.SendAsync(requestMessage);
                response.EnsureSuccessStatusCode();

                var contents = await response.Content.ReadAsStringAsync();
                Console.WriteLine(contents);
            }
            catch (HttpRequestException e)
            {
                Console.WriteLine($"Request error: {e.Message}");
            }
        }
    }
}

package org.example;

import okhttp3.*;
import org.json.JSONArray;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        // Construct JSON payload for youtube_metadata request
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "youtube_search");
        jsonObject.put("query", "how to make a website");

        JSONArray contextArray = new JSONArray();
        contextArray.put(new JSONObject().put("key", "language_code").put("value", "en"));
        contextArray.put(new JSONObject().put("key", "transcript_origin").put("value", "uploader_provided"));

        jsonObject.put("context", contextArray);

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}

Usamos el método de integración síncrono Realtime en nuestros ejemplos. Si desea usar el Push-Pull para la integración, consulte los Métodos de integración sección.

848KB

youtube search output sample.json

Abrir

Parámetros de consulta

Parámetro

Descripción

Valor predeterminado

Tipo

source

Establece el scraper.

youtube_search o youtube_search_max

String

query

Término de búsqueda.

String

- parámetro obligatorio

Filtros

Puede personalizar su búsqueda usando todos los filtros disponibles a través de la interfaz de YouTube.

Parámetros de consulta de filtros

Parámetro

Descripción

Valor predeterminado

Tipo

upload_date

Filtra videos por la fecha de subida. Los valores disponibles son: today, last_hour, this_week, this_month, this_year.

String

type

Devuelve resultados por tipo de contenido. Los valores disponibles son: video, channel, playlist, movie.

String

duración

Duración del contenido en minutos. Los valores disponibles son: <4, 4-20, >20.

String

sort_by

Determina cómo se ordenan los resultados de búsqueda. Los valores disponibles son rating, relevance, view_count,upload_date.

relevance

String

360

Devuelve videos en 360 grados en los resultados de búsqueda.

Booleano

3d

Devuelve videos en 3D en los resultados de búsqueda.

Booleano

4k

Devuelve videos en resolución 4K en los resultados de búsqueda.

Booleano

creative_commons

Devuelve solo videos con licencias Creative Commons.

Booleano

hd

Devuelve videos en alta definición en los resultados de búsqueda.

Booleano

hdr

Devuelve videos HDR (High Dynamic Range) en los resultados de búsqueda.

Booleano

live

Devuelve transmisiones en vivo en los resultados de búsqueda.

Booleano

ubicación

Devuelve videos con información de ubicación.

Booleano

purchased

Devuelve contenido comprado en los resultados de búsqueda.

Booleano

subtítulos

Devuelve videos con subtítulos o closed captions.

Booleano

vr180

Devuelve videos en formato VR180 en los resultados de búsqueda.

Booleano

AnteriorGuía de scraping de YouTube para IA SiguienteEntrenabilidad de vídeos de YouTube

Última actualización hace 11 días

¿Te fue útil?

Buenas tardes

Parámetros de consulta

Filtros

Parámetros de consulta de filtros