自动完成功能

为任意搜索词检索 YouTube 自动完成关键词建议，支持配置语言和位置。

使用 youtube_autocomplete 源，用户可以为任意搜索词获取相关关键词建议。这些建议可以与 youtube_search 源一起使用以发现更多相关视频并扩展您的 YouTube 数据工作流程。

请求示例

以下示例演示如何为给定查询检索搜索词建议。

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "youtube_autocomplete",
        "query": "what is",
        "language": "en",
        "location": "US"
    }'

import requests
from pprint import pprint

# 组织有效负载。
payload = {
    "source": "youtube_autocomplete",
    "query": "what is",
    "language": "en",
    "location": "US"
}

# 获取响应。
response = requests.request(
    "POST",
    "https://realtime.oxylabs.io/v1/queries",
    auth=("USERNAME", "PASSWORD"),
    json=payload,
)

# 打印包含结果的 JSON 响应。
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "youtube_autocomplete",
    query: "what is",
    language: "en",
    location: "US"
};

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_autocomplete',
    'query' => 'what is',
    'language' => 'en',
    'location' => 'US'
);

$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"

	// 定义有效负载
	payload := map[string]interface{}{
		"source":   "youtube_autocomplete",
		"query":    "what is",
		"language": "en",
		"location": "US",
	}

	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.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_autocomplete",
                query = "what is",
                language = "en",
                location = "US"
            };

            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.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() {
        // 构建 JSON 有效负载
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "youtube_autocomplete");
        jsonObject.put("query", "what is");
        jsonObject.put("language", "en");
        jsonObject.put("location", "US");

        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();
    }
}

我们的示例使用同步 Realtime 集成方法。如果您想使用 Proxy Endpoint或异步 Push-Pull 集成，请参阅 Integration Methods 部分。

输出示例

{
    "results": [
        {
            "content": "window.google.ac.h([\"what is\",[[\"what is love\",0,[512,433]],[\"what is this feeling wicked\",0,[512,433,131]],[\"what is love baby dont hurt me no\",0,[512,433]],[\"what is 67\",0,[512,433,131]],[\"what is\",0,[512]],[\"what is you nba youngboy\",0,[512,433,131]],[\"what is love haddaway\",0,[512,433]],[\"what is this feeling wicked karaoke\",0,[512,433]],[\"what is love twice\",0,[512,433,131]],[\"what is you\",0,[512,433,131,650]],[\"what is sounds like\",0,[512,433]],[\"what is scientology\",0,[512]],[\"what is the big beautiful bill\",0,[512]],[\"what is a woman\",0,[512,433]]],{\"j\":\"5\",\"k\":1,\"q\":\"fxuDygqjaW7TVwu4-jEjTrWp6b8\"}])",
            "type": "raw",
            ...
}

请求参数值

参数

描述

默认值

source

设置爬虫。

youtube_autocomplete

query

应返回关键词建议的搜索词。

–

location

搜索位置（2 位国家代码）。

US

language

搜索语言代码。

en

callback_url

您的回调端点的 URL。 更多信息.

–

– 必填参数

本地化

有关可用的 location 和 language 参数值，请参阅下表。

可用位置（用于） youtube_autocomplete

参数值

国家/地区

阿富汗

阿尔巴尼亚

阿尔及利亚

美属萨摩亚

安道尔

安哥拉

安圭拉

南极洲

安提瓜和巴布达

阿根廷

亚美尼亚

阿鲁巴

澳大利亚

奥地利

阿塞拜疆

巴哈马

巴林

孟加拉国

巴巴多斯

白俄罗斯

比利时

伯利兹

贝宁

百慕大

不丹

玻利维亚

波斯尼亚和黑塞哥维那

博茨瓦纳

布韦岛

巴西

英属印度洋领地

文莱达鲁萨兰国

保加利亚

布基纳法索

布隆迪

柬埔寨

喀麦隆

加拿大

佛得角

开曼群岛

中非共和国

乍得

智利

中国

圣诞岛

科科斯（基林）群岛

哥伦比亚

科摩罗

刚果

刚果民主共和国

库克群岛

哥斯达黎加

科特迪瓦

克罗地亚

古巴

塞浦路斯

捷克共和国

丹麦

吉布提

多米尼加（多米尼克）

多米尼加共和国

厄瓜多尔

埃及

萨尔瓦多

赤道几内亚

厄立特里亚

爱沙尼亚

埃塞俄比亚

福克兰群岛（马尔维纳斯）

法罗群岛

斐济

芬兰

法国

法属圭亚那

法属波利尼西亚

法属南部领地

加蓬

冈比亚

格鲁吉亚

德国

加纳

直布罗陀

希腊

格陵兰

格林纳达

瓜德罗普

关岛

危地马拉

几内亚

几内亚比绍

圭亚那

海地

赫德岛和麦克唐纳群岛

罗马教廷（梵蒂冈城国）

洪都拉斯

香港

匈牙利

冰岛

印度

印度尼西亚

伊朗（伊斯兰共和国）

伊拉克

爱尔兰

以色列

意大利

牙买加

日本

约旦

哈萨克斯坦

肯尼亚

基里巴斯

朝鲜

韩国

科威特

吉尔吉斯斯坦

老挝人民民主共和国

拉脱维亚

黎巴嫩

莱索托

利比里亚

利比亚

列支敦士登

立陶宛

卢森堡

澳门

北马其顿

马达加斯加

马拉维

马来西亚

马尔代夫

马里

马耳他

马绍尔群岛

马提尼克

毛里塔尼亚

毛里求斯

马约特

墨西哥

密克罗尼西亚联邦

摩尔多瓦共和国

摩纳哥

蒙古

蒙特塞拉特

摩洛哥

莫桑比克

缅甸

纳米比亚

瑙鲁

尼泊尔

荷兰

新喀里多尼亚

新西兰

尼加拉瓜

尼日尔

尼日利亚

纽埃

诺福克岛

北马里亚纳群岛

挪威

阿曼

巴基斯坦

帕劳

被占巴勒斯坦领土

巴拿马

巴布亚新几内亚

巴拉圭

秘鲁

菲律宾

皮特凯恩群岛

波兰

葡萄牙

波多黎各

卡塔尔

留尼汪

罗马尼亚

俄罗斯联邦

卢旺达

圣赫勒拿

圣基茨和尼维斯

圣卢西亚

圣皮埃尔和密克隆

圣文森特和格林纳丁斯

萨摩亚

圣马力诺

圣多美和普林西比

沙特阿拉伯

塞内加尔

塞尔维亚和黑山

塞舌尔

塞拉利昂

新加坡

斯洛伐克

斯洛文尼亚

所罗门群岛

索马里

南非

南乔治亚岛和南桑威奇群岛

西班牙

斯里兰卡

苏丹

苏里南

斯瓦尔巴和扬马延

斯威士兰

瑞典

瑞士

阿拉伯叙利亚共和国

台湾

塔吉克斯坦

坦桑尼亚联合共和国

泰国

东帝汶

多哥

托克劳

汤加

特立尼达和多巴哥

突尼斯

土耳其

土库曼斯坦

特克斯和凯科斯群岛

图瓦卢

乌干达

乌克兰

阿拉伯联合酋长国

英国

美国

美国本土外小岛屿

乌拉圭

乌兹别克斯坦

瓦努阿图

委内瑞拉

越南

英属维尔京群岛

美属维尔京群岛

瓦利斯和富图纳

西撒哈拉

也门

赞比亚

津巴布韦

根西岛

泽西岛

马恩岛

黑山共和国

可用语言（针对） youtube_autocomplete

参数值

语言

ach

卢奥语

南非荷兰语（Afrikaans）

阿肯语

阿姆哈拉语

阿拉伯语

阿塞拜疆语

白俄罗斯语

bem

本巴语

保加利亚语

比哈尔语

孟加拉语

布列塔尼语

波斯尼亚语

不丹语

加泰罗尼亚语

chr

切罗基语

ckb

库尔德语（索拉尼）

科西嘉语

crs

塞舌尔克里奥尔语

捷克语

威尔士语

丹麦语

德语

埃维语

希腊语

英语

世界语

西班牙语

es-419

西班牙语（拉丁美洲）

爱沙尼亚语

巴斯克语

波斯语

芬兰语

法罗语

法语

弗里斯兰语

爱尔兰语

gaa

加语（Ga）

苏格兰盖尔语

加利西亚语

瓜拉尼语

古吉拉特语

豪萨语

haw

夏威夷语

希伯来语

印地语

克罗地亚语

海地克里奥尔语

匈牙利语

亚美尼亚语

国际语（Interlingua）

印尼语

伊博语

冰岛语

意大利语

希伯来语

日语

爪哇语

格鲁吉亚语

Kongo

哈萨克语

格陵兰语

高棉语

卡纳达语

韩语

kri

克里奥语（塞拉利昂）

库尔德语

吉尔吉斯语

拉丁语

卢干达语

林加拉语

老挝语

loz

洛兹语

立陶宛语

lua

奇卢巴语（Tshiluba）

拉脱维亚语

mfe

毛里求斯克里奥尔语

马尔加什语

毛利语

马其顿语

马拉雅拉姆语

蒙古语

摩尔多瓦语

马拉地语

马来语

马耳他语

马尔代夫

缅甸

尼泊尔语

荷兰语

挪威语（新挪威语）

挪威语

nso

北索托语

齐切瓦语

nyn

鲁尼亚基塔拉语（Runyakitara）

奥克语

奥罗莫语

奥里亚语

旁遮普语

pcm

尼日利亚皮钦语

波兰语

普什图语

葡萄牙语

pt-br

葡萄牙语（巴西）

pt-pt

葡萄牙语（葡萄牙）

克丘亚语

罗曼什语

基隆迪语

罗马尼亚语

俄语

基尼亚卢旺达语

信德语

塞尔维亚-克罗地亚语

僧伽罗语

斯洛伐克语

斯洛文尼亚语

绍纳语

索马里语

阿尔巴尼亚语

塞尔维亚语

sr-me

黑山语

塞索托语

巽他语

瑞典语

斯瓦希里语

泰米尔语

泰卢固语

塔吉克语

泰语

提格里尼亚语

土库曼语

菲律宾语

塞茨瓦纳语（茨瓦纳语）

汤加

土耳其语

鞑靼语

tum

通布卡语

特威语

维吾尔语

乌克兰语

乌尔都语

乌兹别克语

越南语

瓦努阿图

沃洛夫语

萨摩亚

科萨语

意第绪语

约鲁巴语

zh-cn

中文（简体）

zh-tw

中文（繁体）

祖鲁语

最后更新于1天前

这有帮助吗？

下午好

hashtag请求示例

hashtag输出示例

hashtag请求参数值

hashtag本地化

请求示例

输出示例

请求参数值

本地化