# 自动补全
使用 `youtube_autocomplete` 来源，用户可以获取他们选择的任何搜索词的相关关键词建议。这些建议可与 `youtube_search` 来源一起使用，以发现更相关的视频并扩展你的 YouTube 数据工作流。
### 请求样本
以下示例演示如何为给定查询检索搜索词建议。
{% tabs %}
{% tab title="cURL" %}
```shell
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"
}'
```
{% endtab %}
{% tab title="Python" %}
```python
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())
```
{% endtab %}
{% tab title="Node.js" %}
```javascript
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);
});
request.write(JSON.stringify(body));
request.end();
```
{% endtab %}
{% tab title="HTTP" %}
```http
# 你提交的整个字符串必须进行 URL 编码。
https://realtime.oxylabs.io/v1/queries?source=youtube_autocomplete&query=what%20is&language=en&location=US&access_token=12345abcde
```
{% endtab %}
{% tab title="PHP" %}
```php
'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 '错误:' . curl_error($ch);
}
curl_close($ch);
```
{% endtab %}
{% tab title="Golang" %}
```go
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("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("创建请求出错：", err)
return
}
request.SetBasicAuth(Username, Password)
request.Header.Set("Content-Type", "application/json")
response, err := client.Do(request)
if err != nil {
fmt.Println("发送请求出错：", err)
return
}
defer response.Body.Close()
responseText, err := ioutil.ReadAll(response.Body)
if err != nil {
fmt.Println("读取响应出错：", err)
return
}
fmt.Println(string(responseText))
}
```
{% endtab %}
{% tab title="C#" %}
```csharp
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($"请求错误：{e.Message}");
}
}
}
}
```
{% endtab %}
{% tab title="Java" %}
```java
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("错误： " + exception.getMessage());
}
System.exit(0);
}
public static void main(String[] args) {
new Thread(new Main()).start();
}
}
```
{% endtab %}
{% tab title="JSON" %}
```json
{
"source": "youtube_autocomplete",
"query": "what is",
"language": "en",
"location": "US"
}
```
{% endtab %}
{% endtabs %}
我们在示例中使用同步 [**Realtime**](/products/cn/web-scraper-api/integration-methods/realtime.md) 集成方法。如果您想使用 [**Proxy Endpoint**](/products/cn/web-scraper-api/integration-methods/proxy-endpoint.md) 或异步 [**Push-Pull**](/products/cn/web-scraper-api/integration-methods/push-pull.md) 集成，请参阅 [**集成方法**](/products/cn/web-scraper-api/integration-methods.md) 部分。
### 输出示例
```json
{
"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
| 参数值 | 国家 |
| --- | -------------- |
| af | 阿富汗 |
| al | 阿尔巴尼亚 |
| dz | 阿尔及利亚 |
| as | 美属萨摩亚 |
| ad | 安道尔 |
| ao | 安哥拉 |
| ai | 安圭拉 |
| aq | 南极洲 |
| ag | 安提瓜和巴布达 |
| ar | 阿根廷 |
| am | 亚美尼亚 |
| aw | 阿鲁巴 |
| au | 澳大利亚 |
| at | 奥地利 |
| az | 阿塞拜疆 |
| bs | 巴哈马 |
| bh | 巴林 |
| bd | 孟加拉国 |
| bb | 巴巴多斯 |
| by | 白俄罗斯 |
| be | 比利时 |
| bz | 伯利兹 |
| bj | 贝宁 |
| bm | 百慕大 |
| bt | 不丹 |
| bo | 玻利维亚 |
| ba | 波斯尼亚和黑塞哥维那 |
| bw | 博茨瓦纳 |
| bv | 布韦岛 |
| br | 巴西 |
| io | 英属印度洋领地 |
| bn | 文莱达鲁萨兰国 |
| bg | 保加利亚 |
| bf | 布基纳法索 |
| bi | 布隆迪 |
| kh | 柬埔寨 |
| cm | 喀麦隆 |
| ca | 加拿大 |
| cv | 佛得角 |
| ky | 开曼群岛 |
| cf | 中非共和国 |
| td | 乍得 |
| cl | 智利 |
| cn | 中国 |
| cx | 圣诞岛 |
| cc | 科科斯（基林）群岛 |
| co | 哥伦比亚 |
| km | 科摩罗 |
| cg | 刚果 |
| cd | 刚果民主共和国 |
| ck | 库克群岛 |
| cr | 哥斯达黎加 |
| ci | 科特迪瓦 |
| hr | 克罗地亚 |
| cu | 古巴 |
| cy | 塞浦路斯 |
| cz | 捷克共和国 |
| dk | 丹麦 |
| dj | 吉布提 |
| dm | 多米尼克 |
| do | 多米尼加共和国 |
| ec | 厄瓜多尔 |
| eg | 埃及 |
| sv | 萨尔瓦多 |
| gq | 赤道几内亚 |
| er | 厄立特里亚 |
| ee | 爱沙尼亚 |
| et | 埃塞俄比亚 |
| fk | 福克兰群岛（马尔维纳斯群岛） |
| fo | 法罗群岛 |
| fj | 斐济 |
| fi | 芬兰 |
| fr | 法国 |
| gf | 法属圭亚那 |
| pf | 法属波利尼西亚 |
| tf | 法属南部领地 |
| ga | 加蓬 |
| gm | 冈比亚 |
| ge | 格鲁吉亚 |
| de | 德国 |
| gh | 加纳 |
| gi | 直布罗陀 |
| gr | 希腊 |
| gl | 格陵兰 |
| gd | 格林纳达 |
| gp | 瓜德罗普 |
| gu | 关岛 |
| gt | 危地马拉 |
| gn | 几内亚 |
| gw | 几内亚比绍 |
| gy | 圭亚那 |
| ht | 海地 |
| hm | 赫德岛和麦克唐纳群岛 |
| va | 圣座（梵蒂冈城国） |
| hn | 洪都拉斯 |
| hk | 香港 |
| hu | 匈牙利 |
| is | 冰岛 |
| in | 印度 |
| id | 印度尼西亚 |
| ir | 伊朗伊斯兰共和国 |
| iq | 伊拉克 |
| ie | 爱尔兰 |
| il | 以色列 |
| it | 意大利 |
| jm | 牙买加 |
| jp | 日本 |
| jo | 约旦 |
| kz | 哈萨克斯坦 |
| ke | 肯尼亚 |
| ki | 基里巴斯 |
| kp | 朝鲜 |
| kr | 韩国 |
| kw | 科威特 |
| kg | 吉尔吉斯斯坦 |
| la | 老挝人民民主共和国 |
| lv | 拉脱维亚 |
| lb | 黎巴嫩 |
| ls | 莱索托 |
| lr | 利比里亚 |
| ly | 利比亚 |
| li | 列支敦士登 |
| lt | 立陶宛 |
| lu | 卢森堡 |
| mo | 澳门 |
| mk | 北马其顿 |
| mg | 马达加斯加 |
| mw | 马拉维 |
| my | 马来西亚 |
| mv | 马尔代夫 |
| ml | 马里 |
| mt | 马耳他 |
| mh | 马绍尔群岛 |
| mq | 马提尼克 |
| mr | 毛里塔尼亚 |
| mu | 毛里求斯 |
| yt | 马约特 |
| mx | Mexico |
| fm | 密克罗尼西亚联邦 |
| md | 摩尔多瓦共和国 |
| mc | 摩纳哥 |
| mn | 蒙古 |
| ms | 蒙特塞拉特 |
| ma | 摩洛哥 |
| mz | 莫桑比克 |
| mm | 缅甸 |
| na | 纳米比亚 |
| nr | 瑙鲁 |
| np | 尼泊尔 |
| nl | 荷兰 |
| nc | 新喀里多尼亚 |
| nz | 新西兰 |
| ni | 尼加拉瓜 |
| ne | 尼日尔 |
| ng | 尼日利亚 |
| nu | 纽埃 |
| nf | 诺福克岛 |
| mp | 北马里亚纳群岛 |
| no | 挪威 |
| om | 阿曼 |
| pk | 巴基斯坦 |
| pw | 帕劳 |
| ps | 巴勒斯坦领土，被占领 |
| pa | 巴拿马 |
| pg | 巴布亚新几内亚 |
| py | 巴拉圭 |
| pe | 秘鲁 |
| ph | 菲律宾 |
| pn | 皮特凯恩群岛 |
| pl | 波兰 |
| pt | 葡萄牙 |
| pr | 波多黎各 |
| qa | 卡塔尔 |
| re | 留尼汪 |
| ro | 罗马尼亚 |
| ru | 俄罗斯联邦 |
| rw | 卢旺达 |
| sh | 圣赫勒拿 |
| kn | 圣基茨和尼维斯 |
| lc | 圣卢西亚 |
| pm | 圣皮埃尔和密克隆 |
| vc | 圣文森特和格林纳丁斯 |
| ws | 萨摩亚 |
| sm | 圣马力诺 |
| st | 圣多美和普林西比 |
| sa | 沙特阿拉伯 |
| sn | 塞内加尔 |
| rs | 塞尔维亚和黑山 |
| sc | 塞舌尔 |
| sl | 塞拉利昂 |
| sg | 新加坡 |
| sk | 斯洛伐克 |
| si | 斯洛文尼亚 |
| sb | 所罗门群岛 |
| so | 索马里 |
| za | 南非 |
| gs | 南乔治亚和南桑威奇群岛 |
| es | 西班牙 |
| lk | 斯里兰卡 |
| sd | 苏丹 |
| sr | 苏里南 |
| sj | 斯瓦尔巴和扬马延 |
| sz | 斯威士兰 |
| se | 瑞典 |
| ch | 瑞士 |
| sy | 阿拉伯叙利亚共和国 |
| tw | 台湾 |
| tj | 塔吉克斯坦 |
| tz | 坦桑尼亚联合共和国 |
| th | 泰国 |
| tl | 东帝汶 |
| tg | 多哥 |
| tk | 托克劳 |
| to | 汤加 |
| tt | 特立尼达和多巴哥 |
| tn | 突尼斯 |
| tr | 土耳其 |
| tm | 土库曼斯坦 |
| tc | 特克斯和凯科斯群岛 |
| tv | 图瓦卢 |
| ug | 乌干达 |
| ua | 乌克兰 |
| ae | 阿拉伯联合酋长国 |
| uk | 英国 |
| gb | 英国 |
| us | 美国 |
| um | 美国本土外小岛屿 |
| uy | 乌拉圭 |
| uz | 乌兹别克斯坦 |
| vu | 瓦努阿图 |
| ve | 委内瑞拉 |
| vn | 越南 |
| vg | 英属维尔京群岛 |
| vi | 美属维尔京群岛 |
| wf | 瓦利斯和富图纳 |
| eh | 西撒哈拉 |
| ye | 也门 |
| zm | 赞比亚 |
| zw | 津巴布韦 |
| gg | 根西岛 |
| je | 泽西岛 |
| im | 马恩岛 |
| me | 黑山 |
可用语言： youtube_autocomplete
| 参数值 | 语言 |
| ------ | ----------- |
| ach | 卢奥语 |
| af | 南非荷兰语 |
| ak | 阿坎语 |
| am | 阿姆哈拉语 |
| ar | 阿拉伯语 |
| az | 阿塞拜疆语 |
| be | 白俄罗斯语 |
| bem | 本巴语 |
| bg | 保加利亚语 |
| bh | 比哈尔语 |
| bn | 孟加拉语 |
| br | 布列塔尼语 |
| bs | 波斯尼亚语 |
| bt | 不丹语 |
| ca | 加泰罗尼亚语 |
| chr | 切罗基语 |
| ckb | 库尔德语（索拉尼） |
| co | 科西嘉语 |
| crs | 塞舌尔克里奥尔语 |
| cs | 捷克语 |
| cy | 威尔士语 |
| da | 丹麦语 |
| de | 德语 |
| ee | 埃维语 |
| el | 希腊语 |
| en | 英语 |
| eo | 世界语 |
| es | 西班牙语 |
| es-419 | 西班牙语（拉丁美洲） |
| et | 爱沙尼亚语 |
| eu | 巴斯克语 |
| fa | 波斯语 |
| fi | 芬兰语 |
| fo | 法罗语 |
| fr | 法语 |
| fy | 弗里斯语 |
| ga | 爱尔兰语 |
| gaa | 加语 |
| gd | 苏格兰盖尔语 |
| gl | 加利西亚语 |
| gn | 瓜拉尼语 |
| gu | 古吉拉特语 |
| ha | 豪萨语 |
| haw | 夏威夷语 |
| he | 希伯来语 |
| hi | 印地语 |
| hr | 克罗地亚语 |
| ht | 海地克里奥尔语 |
| hu | 匈牙利语 |
| hy | 亚美尼亚语 |
| ia | 国际语 |
| id | 印度尼西亚语 |
| ig | 伊博语 |
| is | 冰岛语 |
| it | 意大利语 |
| iw | 希伯来语 |
| ja | 日语 |
| jw | 爪哇语 |
| ka | 格鲁吉亚语 |
| kg | 刚果语 |
| kk | 哈萨克语 |
| kl | 格陵兰语 |
| km | 高棉语 |
| kn | 卡纳达语 |
| ko | 韩语 |
| kri | 克里奥尔语（塞拉利昂） |
| ku | 库尔德语 |
| ky | 吉尔吉斯语 |
| la | 拉丁语 |
| lg | 卢干达语 |
| ln | 林加拉语 |
| lo | 老挝语 |
| loz | 洛齐语 |
| lt | 立陶宛语 |
| lua | 奇卢巴语 |
| lv | 拉脱维亚语 |
| mfe | 毛里求斯克里奥尔语 |
| mg | 马尔加什语 |
| mi | 毛利语 |
| mk | 马其顿语 |
| ml | 马拉雅拉姆语 |
| mn | 蒙古语 |
| mo | 摩尔多瓦语 |
| mr | 马拉地语 |
| ms | 马来语 |
| mt | 马耳他语 |
| mv | 马尔代夫 |
| my | 缅甸 |
| ne | 尼泊尔语 |
| nl | 荷兰语 |
| nn | 挪威语（新挪威语） |
| no | 挪威语 |
| nso | 北索托语 |
| ny | 齐切瓦语 |
| nyn | 卢尼亚基塔拉语 |
| oc | 奥克语 |
| om | 奥罗莫语 |
| 或 | 奥里亚语 |
| pa | 旁遮普语 |
| pcm | 尼日利亚皮钦语 |
| pl | 波兰语 |
| ps | 普什图语 |
| pt | 葡萄牙语 |
| pt-br | 葡萄牙语（巴西） |
| pt-pt | 葡萄牙语（葡萄牙） |
| qu | 克丘亚语 |
| rm | 罗曼什语 |
| rn | 基隆迪语 |
| ro | 罗马尼亚语 |
| ru | 俄语 |
| rw | 基尼亚卢旺达语 |
| sd | 信德语 |
| sh | 塞尔维亚-克罗地亚语 |
| si | 僧伽罗语 |
| sk | 斯洛伐克语 |
| sl | 斯洛文尼亚语 |
| sn | 绍纳语 |
| so | 索马里语 |
| sq | 阿尔巴尼亚语 |
| sr | 塞尔维亚语 |
| sr-me | 黑山语 |
| st | 塞索托语 |
| su | 巽他语 |
| sv | 瑞典语 |
| sw | 斯瓦希里语 |
| ta | 泰米尔语 |
| te | 泰卢固语 |
| tg | 塔吉克语 |
| th | 泰语 |
| ti | 提格雷尼亚语 |
| tk | 土库曼语 |
| tl | 菲律宾语 |
| tn | 茨瓦纳语 |
| to | 汤加 |
| tr | 土耳其语 |
| tt | 鞑靼语 |
| tum | 通布卡语 |
| tw | 契维语 |
| ug | 维吾尔语 |
| uk | 乌克兰语 |
| ur | 乌尔都语 |
| uz | 乌兹别克语 |
| vi | 越南语 |
| vu | 瓦努阿图 |
| wo | 沃洛夫语 |
| ws | 萨摩亚 |
| xh | 科萨语 |
| yi | 意第绪语 |
| yo | 约鲁巴语 |
| zh-cn | 中文（简体） |
| zh-tw | 中文（繁体） |
| zu | 祖鲁语 |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://developers.oxylabs.io/api-targets/cn/shi-pin-yu-she-jiao-mei-ti/youtube/autocomplete.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.