# 自动补全
使用 `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:", 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 'Error:' . 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("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))
}
```
{% 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($"Request error: {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("Error: " + 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](https://developers.oxylabs.io/scraping-solutions/web-scraper-api/integration-methods/realtime) 集成方法。如果您想使用 [Proxy Endpoint](https://developers.oxylabs.io/scraping-solutions/web-scraper-api/integration-methods/proxy-endpoint)或异步 [Push-Pull](https://developers.oxylabs.io/scraping-solutions/web-scraper-api/integration-methods/push-pull) 集成，请参阅 [Integration Methods](https://developers.oxylabs.io/scraping-solutions/web-scraper-api/integration-methods) 部分。
### 输出示例
```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 | 墨西哥 |
| 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 | 南非荷兰语（Afrikaans） |
| 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 | 加语（Ga） |
| gd | 苏格兰盖尔语 |
| gl | 加利西亚语 |
| gn | 瓜拉尼语 |
| gu | 古吉拉特语 |
| ha | 豪萨语 |
| haw | 夏威夷语 |
| he | 希伯来语 |
| hi | 印地语 |
| hr | 克罗地亚语 |
| ht | 海地克里奥尔语 |
| hu | 匈牙利语 |
| hy | 亚美尼亚语 |
| ia | 国际语（Interlingua） |
| id | 印尼语 |
| ig | 伊博语 |
| is | 冰岛语 |
| it | 意大利语 |
| iw | 希伯来语 |
| ja | 日语 |
| jw | 爪哇语 |
| ka | 格鲁吉亚语 |
| kg | Kongo |
| kk | 哈萨克语 |
| kl | 格陵兰语 |
| km | 高棉语 |
| kn | 卡纳达语 |
| ko | 韩语 |
| kri | 克里奥语（塞拉利昂） |
| ku | 库尔德语 |
| ky | 吉尔吉斯语 |
| la | 拉丁语 |
| lg | 卢干达语 |
| ln | 林加拉语 |
| lo | 老挝语 |
| loz | 洛兹语 |
| lt | 立陶宛语 |
| lua | 奇卢巴语（Tshiluba） |
| lv | 拉脱维亚语 |
| mfe | 毛里求斯克里奥尔语 |
| mg | 马尔加什语 |
| mi | 毛利语 |
| mk | 马其顿语 |
| ml | 马拉雅拉姆语 |
| mn | 蒙古语 |
| mo | 摩尔多瓦语 |
| mr | 马拉地语 |
| ms | 马来语 |
| mt | 马耳他语 |
| mv | 马尔代夫 |
| my | 缅甸 |
| ne | 尼泊尔语 |
| nl | 荷兰语 |
| nn | 挪威语（新挪威语） |
| no | 挪威语 |
| nso | 北索托语 |
| ny | 齐切瓦语 |
| nyn | 鲁尼亚基塔拉语（Runyakitara） |
| oc | 奥克语 |
| om | 奥罗莫语 |
| or | 奥里亚语 |
| 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 | 祖鲁语 |