Documentation has been updated: see help center and changelog in one place.

CtrlK

中文

Google

PreviousSERP 爬虫 API Next参数值

Last updated 1 year ago

Was this helpful?

我们可以在 Google 上抓取和解析各种页面类型。您可以向我们提供一个完整的URL 或通过专门建立的页面类型提供一些输入参数（如搜索 ,广告 , 酒店, 和其他），所以我们可以在我们的终端形成 URL。

注意：SERP 爬虫 API 在抓取时可以渲染 JavaScript。这在一些 Google 服务中是有必要的，例如旅行。

总览

以下概述我们通过 Google 支持的所有可用数据source值。

来源

描述

结构化数据

google

提交您喜欢的任意 Google 网址。

取决于 URL。

google_search

SERP。

是。

google_ads

SERP，针对最大广告率进行优化。仅 num=10。

是。

google_hotels

传奇酒店的服务。

是。

google_travel_hotels

旅行：酒店服务。

是。

google_images

反向图像搜索。

是。

google_suggest

自动完成的搜索词建议。

是。

google_msv_v2

每月搜寻流量。

是。

google_trends_explore

趋势。

是。

您可以通过选择菜单右侧的名称跳转至您喜欢的 Google 页面类型。每个页面都包含参数表以及代码示例，可帮助您开始查询。

URL

google 源设计用于检索各种 Google URL 中的内容。这意味着，您可以向我们提供一个转至所需 Google 页面的直接 URL，而不是发送多个参数。我们不会剥离任何参数或以任何其他方式更改您的 URL。

这个数据源也支持解析数据（JSON 格式的结构化数据），只要提交的 URL 用于 Google（SERP 页面）。如果我们不能确认这是一个 SERP 页面请求，我们将返回一个故障信息。

查询参数

参数

描述

默认值

source

数据源。更多信息。

google

url

转到 Google 页面的直接 URL（链接）

user_agent_type

设备类型和浏览器。单击此处查看完整列表。

desktop

render

启用 JavaScript 渲染。更多信息。

callback_url

转至回调端点的 URL。更多信息。

geo_location

这些结果将根据地理位置进行调整。正确使用这个参数对获得准确的数据极为重要。欲了解更多信息，请在此处阅读我们建议的 geo_location 参数结构。

parse

true 将返回结构化数据。

- 必须提供的参数

代码示例

在以下示例中，API 将检索一个 Google Scholar 搜索页面。

{
    "source": "google", 
    "url": "https://scholar.google.com/scholar?hl=en&q=newton&btnG=&as_sdt=1%2C5&as_sdtp="
}

curl --user user:pass1 'https://realtime.oxylabs.io/v1/queries' -H "Content-Type: application/json"
 -d '{"source": "google", "url": "https://scholar.google.com/scholar?hl=en&q=newton&btnG=&as_sdt=1%2C5&as_sdtp="}{"source": "google", "url": "https://scholar.google.com/scholar?hl=en&q=newton&btnG=&as_sdt=1%2C5&as_sdtp="}'

import requests
from pprint import pprint

# Structure payload.
payload = {
    'source': 'google',
    'url': 'https://scholar.google.com/scholar?hl=en&q=newton&btnG=&as_sdt=1%2C5&as_sdtp='
}

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

# Instead of response with job status and results url, this will return the
# JSON response with results.
pprint(response.json())yhon

<?php

$params = array(
    'source' => 'google',
    'url' => 'https://scholar.google.com/scholar?hl=en&q=newton&btnG=&as_sdt=1%2C5&as_sdtp='
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://data.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, "user" . ":" . "pass1");

$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);
?>

# URL has to be encoded to escape `&` and `=` characters:
# URL: https://scholar.google.com/scholar?hl=en&q=newton&btnG=&as_sdt=1%2C5&as_sdtp=
# Encoded URL: https%3A%2F%2Fscholar.google.com%2Fscholar%3Fhl%3Den%26q%3Dnewton%26btnG%3D%26as_sdt%3D1%252C5%26as_sdtp%3D

https://realtime.oxylabs.io/v1/queries?source=google&url=https%3A%2F%2Fscholar.google.com%2Fscholar%3Fhl%3Den%26q%3Dnewton%26btnG%3D%26as_sdt%3D1%252C5%26as_sdtp%3D&access_token=12345abcde

以上示例使用了 Realtime 集成方法。如果您想在您的查询中使用一些其他集成方法（如推拉或代理端点），请参考集成方法部分。

搜索

google_search 源设计用于检索 Google Search 结果（SERP）。

查询参数

参数

描述

默认值

source

数据源。更多信息。

google_search

domain

域本地化

com

query

UTF 编码的关键字

start_page

起始页数

1

pages

检索的页数

1

limit

每页中要检索的结果数

10

locale

Accept-Language 标头值，它可以更改您的 Google 搜索页面的网页界面语言。更多信息。

geo_location

结果应适应的地理位置。正确使用这个参数对获得正确数据极为重要。欲了解更多信息，请在此处阅读我们建议的 geo_location 参数结构。

user_agent_type

设备类型和浏览器。单击此处查看完整列表。

desktop

render

启用 JavaScript 渲染。更多信息。

callback_url

转至回调端点的 URL。更多信息。

parse

true 将返回解析数据。查看结构化数据了解更多信息。

context: fpstate

设置 fpstate 值为 aig 将使 Google 加载更多应用程序。这个参数只有在与渲染 参数一起使用时才有用。

context: nfpr

true 将关闭拼写自动纠正功能。

false

context:limit_per_page

如果要使用相同的IP地址抓取多个页面，请包含一个JSON数组，并使用 page 键指定页面数量。还必须通过添加 limit 键来指示每个页面上的自动搜索结果数，例如：

"context": [{
        "key": "limit_per_page",
        "value": [
          {"page": 1, "limit": 10},
          {"page": 2, "limit": 90}
        ]
      }]

context: results_language

结果语言。您可以在这里找到一个支持的 Google 语言列表。

context: tbm

待配或 tbm 参数。可接受的值是：app、blg、bks、dsc、isch、nws、pts、plcs、rcp、lcl。

context: tbs

ttbs 参数这个参数就像一个容器，用于存放更多无名 Google 参数，比如按日期限制/排序结果，以及其他过滤器，其中一些取决于 tbm 参数（例如 tbs=app_os:1 只适用于 tbm 值 app).单击此处了解更多相关信息。

- 必须提供的参数

代码示例

在以下示例中，我们请求从 google.nl 域获得 2 个结果页面，从第 11 页到第 12 页，搜索词为 adidas。SERP 将被过滤，只包含法语的结果。

{
    "source": "google_search",
    "domain": "nl",
    "query": "adidas",
    "start_page": 11,
    "pages": 2,
    "parse": true,
    "context": [
        {
            "key": "results_language",
            "value": "fr"
        }]
}

curl --user user:pass1 'https://realtime.oxylabs.io/v1/queries' -H "Content-Type: application/json"
 -d '{"source": "google_search", "domain": "nl", "query": "adidas", "start_page": 11, "pages": 2, "parse": true, "context": [{"key": "results_language", "value": "fr"}]}'

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'google_search',
    'domain': 'nl',
    'query': 'adidas',
    'start_page': 11,
    'pages': 2,
    'context': [
        {'key': 'results_language', 'value': 'fr'},
    ],
}


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

# Print prettified response to stdout.
pprint(response.json())

<?php

$params = array(
    'source' => 'google_search',
    'domain' => 'nl',
    'query' => 'adidas',
    'start_page' => 11,
    'pages' => 2,
    'context' => array(
        'key' => 'results_language',
        'value' => 'fr'
    )
);

$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, "user" . ":" . "pass1");


$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);
?>hp

https://realtime.oxylabs.io/v1/queries?source=google_search&domain=nl&query=adidas&start_page=11&pages=2&context[0][key]=results_language&context[0][value]=fr&access_token=12345abcde

以上示例使用了 Realtime 集成方法。如果您想在您的查询中使用一些其他集成方法（如推拉或代理端点），请参考集成方法部分。

import requests
from pprint import pprinthp


# Structure payload.
payload = {
    'source': 'google_ads',
    'domain': 'nl',
    'query': 'adidas'
}


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

# Print prettified response to stdout.
pprint(response.json())

<?php

$params = array(
    'source' => 'google_ads',
    'domain' => 'nl',
    'query' => 'adidas'
);

$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, "user" . ":" . "pass1");


$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);
?>

https://realtime.oxylabs.io/v1/queries?source=google_ads&domain=nl&query=adidas

以上示例使用了 Realtime 集成方法。如果您想在您的查询中使用一些其他集成方法（如推拉或代理端点），请参考集成方法部分。

酒店

google_hotels 数据源设计用于检索 Google Hotel 搜索结果。

查询参数

参数

描述

默认值

source

数据源。更多信息。

google_hotels

domain

域本地化

com

query

UTF 编码的关键字

start_page

起始页数。

1

pages

检索的页数。

1

limit

每页中要检索的结果数。

10

locale

Accept-Language 标头值，它可以更改您的 Google 搜索页面的网页界面语言。更多信息。

results_language

结果语言。您可以在这里找到一个支持的 Google 语言列表。

geo_location

结果应适应的地理位置。正确使用这个参数对获得正确数据极为重要。欲了解更多信息，请在此处阅读我们建议的 geo_location 参数结构。

user_agent_type

设备类型和浏览器。单击此处查看完整列表。

desktop

render

启用 JavaScript 渲染。更多信息。

callback_url

转至回调端点的 URL。更多信息。

context: nfpr

true 将关闭拼写自动纠正功能。

false

context: hotel_occupancy

宾客人数。

2

context: hotel_dates

入住酒店时长，入住日期 - 离开日期。示例：2023-07-12,2023-07-13。

- 必须提供的参数

注意：使用 Google hotel，您始终需要发送一个包含“酒店”一词的关键词 例如，“洛杉矶的酒店”，“法国巴黎的酒店”，等等。“宾馆”和“酒店”都可以。Google 还支持当地语言，为赫尔辛基的酒店发送“Hotelli Helsingissä”，为维尔纽斯的酒店发送“viešbučiai Vilnius”。

代码示例

在这个示例中，我们请求从 google.com.sons. 检索前 3 页页面，以查询2023-10-01 至 2023-10-10期间在巴黎是否有可容纳1名客人的酒店。

{
    "source": "google_hotels", 
    "domain": "com", 
    "pages": 3, 
    "query": "hotels in Paris", 
    "context": [
        {
            "key": "hotel_occupancy", 
            "value": 1
        }, 
        {
            "key": "hotel_dates", 
            "value": "2023-10-01,2023-10-10"
            }]
}

curl --user user:pass1 'https://realtime.oxylabs.io/v1/queries' -H "Content-Type: application/json"
 -d '{"source": "google_hotels", "domain": "com", "pages": 3, "query": "hotels in Paris", "context": [{"key": "hotel_occupancy", "value": 1}, {"key": "hotel_dates", "value": "2023-10-01,2023-10-10"}]}'

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'google_hotels',
    'domain': 'com',
    'query': 'hotels in Paris',
    'pages': 3,
    'context': [
        {'key': 'hotel_occupancy', 'value': 1},
        {'key': 'hotel_dates', 'value': '2023-10-01,2023-10-10'},
    ],
}

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

# Print prettified response to stdout.
pprint(response.json())

<?php

$params = array(
    'source' => 'google_hotels',
    'domain' => 'com',
    'query' => 'hotels in Paris',
    'pages' => 3,
    'context' => [
       [
        'key' => 'hotel_occupancy',
        'value' => 1,
       ],
       [
        'key' => 'hotel_dates',
        'value': '2023-10-01,2023-10-10',
        ]
     ]
);

$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, "user" . ":" . "pass1");


$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);
?>

https://realtime.oxylabs.io/v1/queries?source=google_hotels&domain=com&query=hotels+in+Paris&pages=3&context[0][key]=hotel_occupancy&context[0][value]=1&context[1][key]=hotel_dates&context[1][value]=2023-10-01,2023-10-10&access_token=12345abcde

以上示例使用了 Realtime 集成方法。如果您想在您的查询中使用一些其他集成方法（如推拉或代理端点），请参考集成方法部分。

旅行：酒店

Google_travel_hotels 数据源设计用于检索 Google Travel 服务的酒店搜索结果。

24KB

google_travel_hotels-bad_geo_locations.csv

查询参数

参数

描述

默认值

source

数据源。更多信息。

google_travel_hotels

domain

域本地化

com

query

UTF 编码的关键字

start_page

起始页数

1

locale

Accept-Language 标头值，它可以更改您的 Google 搜索页面的网页界面语言。更多信息。

geo_location

结果应适应的地理位置。正确使用这个参数对获得正确数据极为重要。请注意，这个来源可以接受数量有限的 geo_location 值 - 请检查本节来查看不产生准确结果的geo_location 值。

user_agent_type

设备类型和浏览器。单击此处查看完整列表。

desktop

render

启用 JavaScript 渲染。更多信息。

callback_url

转至回调端点的 URL。更多信息。

context: hotel_occupancy

宾客人数

2

context: hotel_classes

按酒店星级过滤结果。您可以指定一个或多个介于2 和 5之间的值.例如：[3,4]

context: hotel_dates

住在酒店的日期，入住日期 - 离开日期。示例：2023-07-12,2023-07-13

- 必须提供的参数

注意：请注意，使用 Google Hotels，您的关键词必须始终包括“酒店”，例如，“洛杉矶的酒店”、“法国巴黎的酒店”等。“宾馆”和“酒店”都可以。Google 还支持当地语言，为赫尔辛基的酒店发送“Hotelli Helsingissä”，为维尔纽斯的酒店发送“viešbučiai Vilnius”。

代码示例

在这个示例中，我们请求从 google.com 检索第 2 页结果页面，以查询 2023-10-01 至 2023-10-10期间在巴黎是否有可容纳2名客人的2 至 4-星级酒店。

{
    "source": "google_travel_hotels",
    "domain": "com", 
    "start_page": 2, 
    "query": "hotels in Paris", 
    "context": [
        {
            "key": "hotel_occupancy", 
            "value": 2
        }, 
        {
            "key": "hotel_dates", 
            "value": "2023-10-01,2023-10-10"
        },
        {
            "key": "hotel_classes", 
            "value": [2,4]
        }]
}

curl --user user:pass1 'https://realtime.oxylabs.io/v1/queries' -H "Content-Type: application/json"
 -d '{"source": "google_travel_hotels", "domain": "com", "start_page": 2, "query": "hotels in Paris", "context": [{"key": "hotel_occupancy", "value": 2}, {"key": "hotel_dates", "value": "2023-10-01,2023-10-10"}, {"key": "hotel_classes", "value": [2,4]}]}'

ythimport requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'google_travel_hotels',
    'domain': 'com',
    'query': 'hotels in Paris',
    'start_page': 2,
    'context': [
        {'key': 'hotel_occupancy', 'value': 1},
        {'key': 'hotel_dates', 'value': '2023-10-01,2023-10-10'},
        {'key': 'hotel_classes', 'value': [2,4]},
    ],
}

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

# Print prettified response to stdout.
pprint(response.json())

<?php

$params = array(
    'source' => 'google_travel_hotels',
    'domain' => 'com',
    'query' => 'hotels in Paris',
    'start_page' => 2,
    'context' => [
       [
        'key' => 'hotel_occupancy',
        'value' => 1,
       ],
       [
        'key' => 'hotel_dates',
        'value': '2023-10-01,2023-10-10',
        ],
        [
        'key' => 'hotel_classes',
        'value' => [2,4],
        ]
     ]
);

$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, "user" . ":" . "pass1");


$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);
?>php

https://realtime.oxylabs.io/v1/queries?source=google_travel_hotels&domain=com&query=hotels+in+Paris&start_page=3&context[0][key]=hotel_occupancy&context[0][value]=1&context[1][key]=hotel_dates&context[1][value]=2023-10-01,2023-10-10&context[2][key]=hotel_classes&context[2][value]=[2,4]&access_token=12345abcde

以上示例使用了 Realtime 集成方法。如果您想在您的查询中使用一些其他集成方法（如推拉或代理端点），请参考集成方法部分。

图片

google_images 源设计用于检索图像搜索页面以查找与提供query参数和包含这些图像的网站的图像相似的图像。

查询参数

参数

描述

默认值

source

数据源。更多信息。

google_images

domain

域本地化

com

query

图像 URL

start_page

起始页数

1

pages

检索的页数

1

locale

Accept-Language 标头值，它可以更改您的 Google 搜索页面的网页界面语言。更多信息。

geo_location

结果应适应的地理位置。正确使用这个参数对获得正确数据极为重要。欲了解更多信息，请在此处阅读我们建议的 geo_location 参数结构。

user_agent_type

设备类型和浏览器。单击此处查看完整列表。

desktop

render

启用 JavaScript 渲染。更多信息。

callback_url

转至回调端点的 URL。更多信息。

context: nfpr

true 将关闭拼写自动纠正功能。

false

context: results_language

结果语言。您可以在这里找到一个支持 Google 语言的列表。

- 必须提供的参数

代码示例

在这个示例中，我们请求获得这个图像的反向图像搜索结果： 来自 google.com 的https://newsneakernews-wpengine.netdna-ssl.com/wp-content/uploads/2017/03/adidas-boost-march-25-2017.jpg。

{
    "source": "google_images", 
    "domain": "com", 
    "query": "https://newsneakernews-wpengine.netdna-ssl.com/wp-content/uploads/2017/03/adidas-boost-march-25-2017.jpg", 
    "context": [
        {
            "key": "search_operators",
            "value": [
                {"key": "site", "value": "example.com"}, 
                {"key": "filetype", "value": "html"}, 
                {"key": "inurl", "value": "image"}
        }], 
    "callback_url": "https://your.callback.url"
}

curl --user user:pass1 'https://data.oxylabs.io/v1/queries'\
-H "Content-Type: application/json" \
-d '{"source": "google_images", "domain": "com", "query": "https://newsneakernews-wpengine.netdna-ssl.com/wp-content/uploads/2017/03/adidas-boost-march-25-2017.jpg", "context": [{"key": "search_operators","value": [{"key": "site", "value": "example.com"}, {"key": "filetype", "value": "html"}, {"key": "inurl", "value": "image"}}], "callback_url": "https://your.callback.url"}'

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'google_images',
    'domain': 'com',
    'query': 'https://newsneakernews-wpengine.netdna-ssl.com/wp-content/uploads/2017/03/adidas-boost-march-25-2017.jpg',
    'context': [
    {
      'key': 'search_operators',
      'value': [ 
        {'key': 'site', 'value': 'example.com'}, 
        {'key': 'filetype', 'value': 'html'},
        {'key': 'inurl', 'value': 'image'}
      ]
    }
  ]
}

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

# Print prettified response to stdout.
pprint(response.json())

<?php

$params = array(
    'source' => 'google_images',
    'domain' => 'com',
    'query' => 'https://newsneakernews-wpengine.netdna-ssl.com/wp-content/uploads/2017/03/adidas-boost-march-25-2017.jpg',
    'context' => [
       [
        'key' => 'hotel_occupancy',
        'value' => [
            ['key' => 'site', 'value' => 'example.com'],
            ['key' => 'filetype', 'value' => 'html'],
            ['key' => 'inurl', 'value' => 'image']
        ]
     ]
)

$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, "user" . ":" . "pass1");


$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);
?>

https://realtime.oxylabs.io/v1/queries?source=google_images&domain=com&query=https://www.example.com/img/image.jpg&access_token=12345abcde

以上示例使用了 Realtime 集成方法。如果您想在您的查询中使用一些其他集成方法（如推拉或代理端点），请参考集成方法部分。

建议

google_suggest 源设计用于检索 Google 的搜索术语建议。

查询参数

参数

描述

默认值

source

数据源。更多信息。

google_suggest

query

UTF 编码的关键字

locale

Accept-Language 标头值，它可以更改您的 Google 搜索页面的网页界面语言。更多信息。

geo_location

结果应适应的地理位置。正确使用这个参数对获得正确数据极为重要。欲了解更多信息，请在此处阅读我们建议的 geo_location 参数结构。

user_agent_type

设备类型和浏览器。单击此处查看完整列表。

desktop

render

启用 JavaScript 渲染。更多信息。

callback_url

转至回调端点的 URL。更多信息。

- 必须提供的参数

代码示例

API 请求 Google Suggestions 页面检索关键词 adidas 的建议。

 {
    "source": "google_suggest",  
    "query": "what is"
}

curl --user user:pass1 'https://realtime.oxylabs.io/v1/queries' -H "Content-Type: application/json"
 -d '{"source": "google_suggest", "query": "what is"}'

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'google_suggest',
    'query': 'what is'
}

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

# Print prettified response to stdout.
pprint(response.json())

<?php

$params = array(
    'source' => 'google_suggest',
    'query' => 'what is'
);

$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, "user" . ":" . "pass1");


$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);
?>

https://realtime.oxylabs.io/v1/queries?source=google_suggest&query=what%20is&access_token=12345abcde

以上示例使用了 Realtime 集成方法。如果您想在您的查询中使用一些其他集成方法（如推拉或代理端点），请参考集成方法部分。

关键字

google_msv_v2 数据源将检索指定关键字和建议关键字的 Google 关键字数据（除非在上下文中传递 idea=False）。

查询参数

参数

描述

默认值

source

数据源。更多信息。

google_msv_v2

query

UTF 编码的关键词，用逗号分隔。

geo_location

结果应适应的地理位置。正确使用这个参数对获得正确数据极为重要。欲了解更多信息，请在此处阅读我们建议的 geo_location 参数结构。

context: language

语言，例如，英语 或 法文.没有参数或空值将返回所有语言的结果。

context: currency

3 个符号的货币代码。

EUR

context: ideas

如果是true，返回关键字的意思，如果是false，将只返回所请求关键字的数据。

true

context: ideas_limit

当获取意思时，将检索意思关键字的数量限制为已有限制，四舍五入到最接近的 50 倍数（例如：20 -> 50, 123 -> 150).0 表示没有限制。

0

context: min_amsv

在获取意思时，将过滤掉月平均搜索量低于所提供数字的意思关键词。0 表示没有过滤器。

0

context: max_amsv

在获取意思时，将过滤掉月平均搜索量高于所提供数字的意思关键词。0 表示没有过滤器。

0

context: category

在获取意思时，将过滤掉不属于所提供类别的意思关键词。此处提供了 .csv 格式的可用类别。

null

callback_url

转至回调端点的 URL。更多信息。

- 必须提供的参数

代码示例

在这个示例中，API 将检索优秀的 餐厅的关键词数据和所有建议的关键词。关键词语言是法文，地理位置为Paris,Ile-de-France,France 和货币是 EUR。

N/A

curl --user user:pass1 'https://data.oxylabs.io/v1/queries' -H "Content-Type: application/json"
-d '{"source": "google_msv_v2", "query": "meilleur restaurant", "geo_location": "Paris,Ile-de-France,France", "context": [{"key": "language", "value": "french"},{"key": "currency", "value": "EUR"}, {"key": "ideas", "value": true}]}'

# OR if you don't want ideas:

curl --user user:pass1 'https://data.oxylabs.io/v1/queries' -H "Content-Type: application/json"
-d '{"source": "google_msv_v2", "query": "meilleur restaurant", "geo_location": "Paris,Ile-de-France,France", "context": [{"key": "language", "value": "french"},{"key": "currency", "value": "EUR"}, {"key": "ideas", "value": false}]}'

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'google_msv_v2',
    'query': 'meilleur restaurant',
    'geo_location': 'Paris,Ile-de-France,France',
    'context': [
        {'key': 'language', 'value': 'french'},
        {'key': 'currency', 'value': 'EUR'},
        {'key': 'ideas', 'value': True},  # OR False if you don't want ideas.
    ],
}

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

# Print prettified response to stdout.
pprint(response.json())

<?php

$params = array(
    'source' => 'google_msv_v2',
    'query' => 'meilleur restaurant',
    'geo_location' => 'Paris,Ile-de-France,France',
    'context' => array(
        array('key' => 'language', 'value' => 'french'),
        array('key' => 'currency', 'value' => 'EUR'),
        array('key' => 'ideas', 'value' => true) // or 'value' => false if you don't want ideas
    )
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://data.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, "user" . ":" . "pass1");


$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);
?>

样本输出（历史搜索量条目和意思条目将被剪切）：

{
    "results": [
    {
        "content":
        {
            "ideas": [
            {
                "cpc": 4.712038,
                "keyword": "meilleur restaurant a paris",
                "currency": "EUR",
                "competition": 0.3385383889238515,
                "averageSearchVolume": 1900,
                "historicalSearchVolume": [
                {
                    "date": "201803",
                    "searchVolume": 1600
                },
                {
                    "date": "201802",
                    "searchVolume": 1900
                }]
            }],
            "seeds": [
            {
                "cpc": 4.05351,
                "keyword": "meilleur restaurant",
                "currency": "EUR",
                "competition": 0.3385341239238515,
                "averageSearchVolume": 2900,
                "historicalSearchVolume": [
                {
                    "date": "201803",
                    "searchVolume": 3600
                },
                {
                    "date": "201802",
                    "searchVolume": 2900
                }]
            }]
        }
    }]
}

搜寻趋势：探索

google_trends_explore 来源旨在检索 Google 搜寻趋势的结果。

注意：这个服务能够不断提供结构化数据 - 因此没有必要利用这个来源的解析参数。

查询参数

参数

描述

默认值

source

数据源。更多信息。

google_trends_explore

query

UTF 编码的关键词，用逗号分隔。

geo_location

其结果应符合其地理位置。Google 搜寻趋势：探索，我们接受 2 个字母的 ISO 国家代码作为 geo_location 参数值。我们也允许使用 worldwide 作为 geo_location 的参数值。

context:search_type

让您设置搜索类型（Google Trends GUI 的其中一个选项）。可用值： web_search, image_search, google_shopping, youtube_search。

web_search

context:date_from

日期下限。格式： 年-月-日。最早的可能日期： 2004-01-01。

context:date_to

日期上限。格式：年-月-日。最早的可能日期： 2004-01-01。

context:category_id

类别 ID。请参考此文件获取有效值的列表。

user_agent_type

设备类型和浏览器。单击此处查看完整列表。

desktop

callback_url

转至回调端点的 URL。更多信息。

- 必须提供的参数

代码示例

在这个示例中，我们请求获得 2021 年 1 月 1 日至 2022 年 2 月 2 日之间adidas搜索词的趋势结果，并将类别设置为“艺术与娱乐”（类别 id：3）。

{
    "source": "google_trends_explore", 
    "query": "adidas", 
    "context": [
        {"key": "date_from", "value": "2021-01-01"}, 
        {"key": "date_to", "value": "2022-02-02"}, 
        {"key": "category_id", "value": 3}
        ]
}

curl --user user:pass1 'https://realtime.oxylabs.io/v1/queries' \
-H "Content-Type: application/json" \
-d '{"source": "google_trends_explore", "query": "adidas", "context": [{"key": "date_from", "value": "2021-01-01"}, {"key": "date_to", "value": "2022-02-02"}, {"key": "category_id", "value": 3}]}'

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'google_trends_explore',
    'query': 'adidas',
    'callback_url': 'https://your.callback.url',
    'context': [
        {'key': 'date_from', 'value': '2021-01-01'},
        {'key': 'date_to', 'value': '2022-02-02'},
        {'key': 'category_id', 'value': 3},
    ],
}


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

# Print prettified response to stdout.
pprint(response.json())

<?php

$params = array(
    'source' => 'google_search',
    'query' => 'adidas',
    'context' => [
        [
            'key' => 'date_from',
            'value' => '2021-01-01'
        ],
                [
            'key' => 'date_to',
            'value' => '2022-02-02'
        ],
                [
            'key' => 'category_id',
            'value' => 3
        ],
    ]
);

$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, "user" . ":" . "pass1");


$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);
?>

https://realtime.oxylabs.io/v1/queries?source=google_trends_explore&query=adidas&context[0][key]=date_from&context[0][value]=2021-01-01&&context[1][key]=date_to&context[1][value]=2022-02-02&context[2][key]=category_id&context[0][value]=3&access_token=12345abcde

以上示例使用了 Realtime 集成方法。如果您想在您的查询中使用一些其他集成方法（如推拉或代理端点），请参考集成方法部分。