Discover Search data on YouTube from a user query and connect the results to search, catalog, or research interfaces.
Use “All by country” when an exact object ID is not known and relevant candidates must be found first.
Review the result and common workflows first, then move to parameters and a working request example.
The response includes matching Search, public context, and pagination data when more results are available.
Use “All by country” when an exact object ID is not known and relevant candidates must be found first.
Add YouTube data search to customer-facing and internal interfaces.
Find candidates by query and save relevant objects for later enrichment.
Collect result sets for topic, creator, and competitive analysis.
Both versions solve the same job and accept the same parameters. Use the switch to compare the response structure and choose the version your client expects.
Switch versions on this page to compare response structures while keeping the same documentation URL.
Authentication, required parameters, and the request shape stay the same across V1 and V2. In practice, you choose the version when you build the endpoint path and when you parse the response.
The main difference is the response envelope. Use V2 for new integrations and keep V1 only when you need compatibility with an existing client contract.
Use the same API key header and the same query parameters for both versions. This documentation shows the shared parameter set first, then version-specific endpoint paths and code snippets.
| Parameter | Required | Type | Example | Description |
|---|---|---|---|---|
country_code |
Yes | str |
US |
Two-letter ISO 3166-1 alpha-2 country code used for YouTube localization. Example: US. |
query |
Yes | str |
technology review |
User-entered search query. |
cursor |
No | str | None |
cursor-next-page |
Next-page cursor returned by the previous response. Omit it for the first page. |
Choose a version when you copy the exact endpoint path, example URL, and code snippet. The parameter list above stays the same.
GET /api/v2/youtube.com/search/all-by-countrycurl --request GET \
--url "https://www.scrapestorm.net/api/v2/youtube.com/search/all-by-country" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'country_code=US' \
--get --data-urlencode 'query=technology review' \
# Optional parameters:
# --data-urlencode 'cursor=cursor-next-page'from urllib.parse import urljoin
import requests
BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/youtube.com/search/all-by-country"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"country_code": "US",
"query": "technology review",
}
# Optional parameters
# params["cursor"] = "cursor-next-page"
with requests.Session() as session:
response = session.request(
method="GET",
url=urljoin(BASE_URL, ENDPOINT),
headers=HEADERS,
params=params,
timeout=30,
)
response.raise_for_status()
payload = response.json()
print(payload)const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v2/youtube.com/search/all-by-country";
const params = new URLSearchParams({
country_code: "US",
query: "technology review",
});
// Optional parameters
// params.set("cursor", "cursor-next-page");
const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
method: "GET",
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
if (!response.ok) {
throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}
const payload = await response.json();
console.log(payload);import axios from "axios";
const client = axios.create({
baseURL: "https://www.scrapestorm.net",
timeout: 30000,
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
const params = {
country_code: "US",
query: "technology review",
};
// Optional parameters
// params.cursor = "cursor-next-page";
const { data: payload } = await client.request({
method: "GET",
url: endpoint,
params,
});
console.log(payload);<?php
declare(strict_types=1);
use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;
$client = new Client([
'base_uri' => "https://www.scrapestorm.net",
'timeout' => 30.0,
'headers' => [
'Accept' => 'application/json',
'X-API-Key' => "00000000-0000-4000-8000-000000000000",
],
]);
$query = [
"country_code" => "US",
"query" => "technology review",
];
// Optional parameters
// $query["cursor"] = "cursor-next-page";
try {
$response = $client->request("GET", "/api/v2/youtube.com/search/all-by-country", [
'query' => $query,
]);
$payload = json_decode(
(string) $response->getBody(),
true,
512,
JSON_THROW_ON_ERROR
);
var_dump($payload);
} catch (GuzzleException $e) {
throw $e;
}package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
"time"
)
func main() {
baseURL := "https://www.scrapestorm.net"
endpoint := "/api/v2/youtube.com/search/all-by-country"
params := url.Values{}
params.Set("country_code", "US")
params.Set("query", "technology review")
// Optional parameters
// params.Set("cursor", "cursor-next-page")
req, err := http.NewRequest(
"GET",
fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
nil,
)
if err != nil {
panic(err)
}
req.Header.Set("Accept", "application/json")
req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")
client := &http.Client{Timeout: 30 * time.Second}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var payload any
if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
panic(err)
}
fmt.Printf("%+v\n", payload)
}Choose a version when you copy the exact endpoint path, example URL, and code snippet. The parameter list above stays the same.
GET /api/v1/youtube.com/search/all-by-countrycurl --request GET \
--url "https://www.scrapestorm.net/api/v1/youtube.com/search/all-by-country" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'country_code=US' \
--get --data-urlencode 'query=technology review' \
# Optional parameters:
# --data-urlencode 'cursor=cursor-next-page'from urllib.parse import urljoin
import requests
BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v1/youtube.com/search/all-by-country"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"country_code": "US",
"query": "technology review",
}
# Optional parameters
# params["cursor"] = "cursor-next-page"
with requests.Session() as session:
response = session.request(
method="GET",
url=urljoin(BASE_URL, ENDPOINT),
headers=HEADERS,
params=params,
timeout=30,
)
response.raise_for_status()
payload = response.json()
print(payload)const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v1/youtube.com/search/all-by-country";
const params = new URLSearchParams({
country_code: "US",
query: "technology review",
});
// Optional parameters
// params.set("cursor", "cursor-next-page");
const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
method: "GET",
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
if (!response.ok) {
throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}
const payload = await response.json();
console.log(payload);import axios from "axios";
const client = axios.create({
baseURL: "https://www.scrapestorm.net",
timeout: 30000,
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
const params = {
country_code: "US",
query: "technology review",
};
// Optional parameters
// params.cursor = "cursor-next-page";
const { data: payload } = await client.request({
method: "GET",
url: endpoint,
params,
});
console.log(payload);<?php
declare(strict_types=1);
use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;
$client = new Client([
'base_uri' => "https://www.scrapestorm.net",
'timeout' => 30.0,
'headers' => [
'Accept' => 'application/json',
'X-API-Key' => "00000000-0000-4000-8000-000000000000",
],
]);
$query = [
"country_code" => "US",
"query" => "technology review",
];
// Optional parameters
// $query["cursor"] = "cursor-next-page";
try {
$response = $client->request("GET", "/api/v1/youtube.com/search/all-by-country", [
'query' => $query,
]);
$payload = json_decode(
(string) $response->getBody(),
true,
512,
JSON_THROW_ON_ERROR
);
var_dump($payload);
} catch (GuzzleException $e) {
throw $e;
}package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
"time"
)
func main() {
baseURL := "https://www.scrapestorm.net"
endpoint := "/api/v1/youtube.com/search/all-by-country"
params := url.Values{}
params.Set("country_code", "US")
params.Set("query", "technology review")
// Optional parameters
// params.Set("cursor", "cursor-next-page")
req, err := http.NewRequest(
"GET",
fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
nil,
)
if err != nil {
panic(err)
}
req.Header.Set("Accept", "application/json")
req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")
client := &http.Client{Timeout: 30 * time.Second}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var payload any
if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
panic(err)
}
fmt.Printf("%+v\n", payload)
}The preview keeps key fields and the first collection items so you can scan the response shape quickly. Switching versions changes the JSON format.
This compact JSON example comes from the latest successful verification run for V2.
{
"success": true,
"status": "ok",
"pagination": {
"cursor": "QVFB...",
"has_more": true
},
"search_context": {
"query": "technology review",
"country_code": "US"
},
"data": {
"estimated_results": 12085736,
"videos": {
"count": 16,
"items": [
{
"author": {
"url": "https://www.youtube.com/@MicrosoftResearch",
"channel_id": "UCCb9_Kn8F_Opb3UCGm-lILQ",
"username": "MicrosoftResearch",
"display_name": "Microsoft Research"
},
"url": "https://www.youtube.com/watch?v=ZOpLvwtYhP4&pp=ygURdGVjaG5vbG9neSByZXZpZXc%3D",
"video_id": "ZOpLvwtYhP4",
"title": "MIT Technology Review’s EmTech Conference: What’s Next?",
"snippet": "Peter Lee, President, Microsoft Research The future of AI is full of untapped opportunities that lie just beyond the horizon.",
"published_time": "1 year ago",
"duration_seconds": 1867,
"duration_text": "31:07",
"view_count": 5215,
"badges": [
"CC",
"Verified"
],
"thumbnail_url": "https://example.com/image.jpg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/ZOpLvwtYhP4/hq720.jpg?sqp=-oaymwE2COgCEMoBSFXyq4qpAygIARUAAIhCGAFwAcABBvABAfgB_gmAAtAFigIMCAAQARhQIFcoZTAP&rs=AOn4CLAJPii6DeZ0RiuUY6MjRAmd4W8cYw",
"width": 360,
"height": 202
},
{
"url": "https://i.ytimg.com/vi/ZOpLvwtYhP4/hq720.jpg?sqp=-oaymwE2CNAFEJQDSFXyq4qpAygIARUAAIhCGAFwAcABBvABAfgB_gmAAtAFigIMCAAQARhQIFcoZTAP&rs=AOn4CLA6diKdNgKinfj2Y2spgnOH8_BHYg",
"width": 720,
"height": 404
}
]
},
{
"author": {
"url": "https://www.youtube.com/@LinusTechTips",
"channel_id": "UCXuqSBlHAE6Xw-yeJA0Tunw",
"username": "LinusTechTips",
"display_name": "Linus Tech Tips"
},
"url": "https://www.youtube.com/watch?v=TD74a5g5rp0&pp=ygURdGVjaG5vbG9neSByZXZpZXc%3D",
"video_id": "TD74a5g5rp0",
"title": "Everything Apple announced in under 10 mins - Welcome Home 2026",
"snippet": "Meter is funding the next generation of network engineers with grants of up to $2000 for courses, certifications, and tools.",
"published_time": "13 hours ago",
"duration_seconds": 597,
"duration_text": "9:57",
"view_count": 593751,
"badges": [
"New",
"4K",
{
"_more_items": 1
}
],
"thumbnail_url": "https://example.com/image.jpg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/TD74a5g5rp0/hq720_custom_2.jpg?sqp=COSyv9YG-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLANEBbeJ0a1PRGvI5mBGyVoEHgKiQ",
"width": 360,
"height": 202
},
{
"url": "https://i.ytimg.com/vi/TD74a5g5rp0/hq720_custom_2.jpg?sqp=COSyv9YG-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAmd0CXC1vCImu9fHxMhUzcjw3qfw",
"width": 720,
"height": 404
}
]
},
{
"_more_items": 14
}
]
},
"shorts": {
"count": 25,
"items": [
{
"url": "https://www.youtube.com/shorts/K1fqyV6IL9U",
"video_id": "K1fqyV6IL9U",
"title": "iPhone 18 Pro Max review in one minute: Should you buy the latest iPhone?",
"view_count": 1000,
"thumbnail_url": "https://example.com/image.jpg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/K1fqyV6IL9U/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLCBP1BPtplk1Ab6ZclCJuedtdEzjg&usqp=CCk",
"width": 405,
"height": 720
},
{
"url": "https://i.ytimg.com/vi/K1fqyV6IL9U/oardefault.jpg?sqp=-oaymwEgCJUDEOAESFWQAgHyq4qpAw8IARUAAIhCcAHAAQbIAQE=&rs=AOn4CLAV29qmY8CARnLjNLBW8Sj1Uy76cA&usqp=CCk",
"width": 405,
"height": 608
}
]
},
{
"url": "https://www.youtube.com/shorts/7i8lMSCGxe0",
"video_id": "7i8lMSCGxe0",
"title": "Apple HomeView REVIEW - Is It Worth It?",
"view_count": 53000,
"thumbnail_url": "https://example.com/image.jpg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/7i8lMSCGxe0/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLDc0YuaQExR4RnSFsM3aGea4Mz-ww&usqp=CCk",
"width": 405,
"height": 720
},
{
"url": "https://i.ytimg.com/vi/7i8lMSCGxe0/oardefault.jpg?sqp=-oaymwEgCJUDEOAESFWQAgHyq4qpAw8IARUAAIhCcAHAAQbIAQE=&rs=AOn4CLCMeSEvil4AyvAp_k6c7nyqvV0REQ&usqp=CCk",
"width": 405,
"height": 608
}
]
},
{
"_more_items": 23
}
]
},
"channels": {
"count": 4,
"items": [
{
"url": "https://www.youtube.com/@SulitTechReviews",
"channel_id": "UCa8g_5cRhATCMNMI7xlLJzQ",
"username": "SulitTechReviews",
"display_name": "Sulit Tech Reviews",
"verified": true,
"snippet": "Unboxing, impression,review, and tutorial videos! New video(s) every week! If you guys want to request a specific item for me to ...",
"subscriber_count": 815000,
"badges": [
"Verified"
],
"avatar_url": "https://example.com/image.jpg",
"avatar_urls": "https://example.com/image.jpg"
},
{
"url": "https://www.youtube.com/@technologyreview",
"channel_id": "UCgy4Mf_tlZGqesYNqPNxjPw",
"username": "technologyreview",
"display_name": "MIT Technology Review",
"verified": null,
"snippet": "Our in-depth reporting reveals what's going on now to prepare you for what's coming next. Founded at the Massachusetts Institute ...",
"subscriber_count": 102000,
"badges": null,
"avatar_url": "https://example.com/image.jpg",
"avatar_urls": "https://example.com/image.jpg"
},
{
"_more_items": 2
}
]
},
"playlists": {
"count": 0,
"items": []
}
}
}This compact JSON example comes from the latest successful verification run for V1.
{
"success": true,
"status": "ok",
"pagination": {
"cursor": "QVFB...",
"has_more": true
},
"search_context": {
"query": "technology review",
"country_code": "US"
},
"data": {
"responseContext": {
"serviceTrackingParams": [
{
"service": "GUIDED_HELP",
"params": [
{
"key": "context",
"value": "yt_web_search"
},
{
"key": "logged_in",
"value": "0"
}
]
},
{
"service": "GFEEDBACK",
"params": [
{
"key": "has_unlimited_entitlement",
"value": "False"
},
{
"key": "has_premium_lite_entitlement",
"value": "False"
},
{
"_more_items": 2
}
]
},
{
"_more_items": 2
}
],
"mainAppWebResponseContext": {
"loggedOut": true,
"trackingParam": "k5_fmPxhoXZROHUr3wmL_Ug8g7K3Y33oSehkwdBURzmcN5sAhjJUOL60rzRMkuMESLBwOcCw59TLtslLKPQGSS"
},
"responseId": "IhMIl5Ggz6C6lwMV1mJPBB1HwRt-",
"webResponseContextExtensionData": {
"webResponseContextPreloadData": {
"preloadMessageNames": [
"twoColumnSearchResultsRenderer",
"sectionListRenderer",
{
"_more_items": 57
}
]
},
"hasDecorated": true
}
},
"estimatedResults": "12085258",
"contents": {
"twoColumnSearchResultsRenderer": {
"primaryContents": {
"sectionListRenderer": {
"contents": [
"…",
"…"
],
"trackingParams": "CDwQui8iEwiXkaDPoLqXAxXWYk8EHUfBG34=",
"subMenu": {
"searchSubMenuRenderer": "…"
},
"hideBottomSeparator": true,
"targetId": "search-feed"
}
}
}
},
"trackingParams": "CAAQvGkiEwiXkaDPoLqXAxXWYk8EHUfBG37KAQQx6Lo1",
"header": {
"searchHeaderRenderer": {
"chipBar": {
"chipCloudRenderer": {
"chips": [
"…",
"…",
{
"_more_items": 4
}
],
"trackingParams": "CDMQkVoiEwiXkaDPoLqXAxXWYk8EHUfBG34=",
"nextButton": {
"buttonRenderer": "…"
},
"previousButton": {
"buttonRenderer": "…"
}
}
},
"searchFilterButton": {
"buttonRenderer": {
"style": "STYLE_TEXT",
"size": "SIZE_DEFAULT",
"isDisabled": false,
"text": {
"runs": "…"
},
"icon": {
"iconType": "TUNE"
},
"tooltip": "Search filters",
"trackingParams": "CBQQ8FsiEwiXkaDPoLqXAxXWYk8EHUfBG34=",
"accessibilityData": {
"accessibilityData": "…"
},
"command": {
"clickTrackingParams": "CBQQ8FsiEwiXkaDPoLqXAxXWYk8EHUfBG37KAQQx6Lo1",
"openPopupAction": "…"
},
"iconPosition": "BUTTON_ICON_POSITION_TYPE_RIGHT_OF_TEXT"
}
},
"trackingParams": "CBIQiOoKIhMIl5Ggz6C6lwMV1mJPBB1HwRt-",
"aboutTheseResultsButton": {
"buttonRenderer": {
"style": "STYLE_TEXT",
"size": "SIZE_DEFAULT",
"isDisabled": false,
"text": {
"runs": "…"
},
"icon": {
"iconType": "INFO"
},
"trackingParams": "CBMQ8FsiEwiXkaDPoLqXAxXWYk8EHUfBG34=",
"command": {
"clickTrackingParams": "CBMQ8FsiEwiXkaDPoLqXAxXWYk8EHUfBG37KAQQx6Lo1",
"commandMetadata": "…",
"urlEndpoint": "…"
},
"iconPosition": "BUTTON_ICON_POSITION_TYPE_RIGHT_OF_TEXT"
}
}
}
},
"topbar": {
"desktopTopbarRenderer": {
"logo": {
"topbarLogoRenderer": {
"iconImage": {
"iconType": "YOUTUBE_LOGO"
},
"tooltipText": {
"runs": "…"
},
"endpoint": {
"clickTrackingParams": "CBEQsV4iEwiXkaDPoLqXAxXWYk8EHUfBG37KAQQx6Lo1",
"commandMetadata": "…",
"browseEndpoint": "…"
},
"trackingParams": "CBEQsV4iEwiXkaDPoLqXAxXWYk8EHUfBG34=",
"overrideEntityKey": "EgZ0b3BiYXIg9QEoAQ%3D%3D"
}
},
"searchbox": {
"fusionSearchboxRenderer": {
"icon": {
"iconType": "SEARCH"
},
"placeholderText": {
"runs": "…"
},
"config": {
"webSearchboxConfig": "…"
},
"trackingParams": "CA0Q7VAiEwiXkaDPoLqXAxXWYk8EHUfBG34=",
"searchEndpoint": {
"clickTrackingParams": "CA0Q7VAiEwiXkaDPoLqXAxXWYk8EHUfBG37KAQQx6Lo1",
"commandMetadata": "…",
"searchEndpoint": "…"
},
"clearButton": {
"buttonRenderer": "…"
},
"showImageSourceDialog": {
"clickTrackingParams": "CA0Q7VAiEwiXkaDPoLqXAxXWYk8EHUfBG37KAQQx6Lo1",
"showDialogCommand": "…"
},
"disableAiAppearance": true
}
},
"trackingParams": "CAEQq6wBIhMIl5Ggz6C6lwMV1mJPBB1HwRt-",
"topbarButtons": [
{
"topbarMenuButtonRenderer": {
"icon": "…",
"menuRequest": "…",
"trackingParams": "CAsQ_qsBGAAiEwiXkaDPoLqXAxXWYk8EHUfBG34=",
"accessibility": "…",
"tooltip": "Settings",
"style": "STYLE_DEFAULT"
}
},
{
"buttonRenderer": {
"style": "STYLE_SUGGESTIVE",
"size": "SIZE_SMALL",
"text": "…",
"icon": "…",
"navigationEndpoint": "…",
"trackingParams": "CAoQ1IAEGAEiEwiXkaDPoLqXAxXWYk8EHUfBG34=",
"targetId": "topbar-signin"
}
}
],
"hotkeyDialog": {
"hotkeyDialogRenderer": {
"title": {
"runs": "…"
},
"sections": [
"…",
"…",
{
"_more_items": 2
}
],
"dismissButton": {
"buttonRenderer": "…"
},
"trackingParams": "CAgQteYDIhMIl5Ggz6C6lwMV1mJPBB1HwRt-"
}
},
"backButton": {
"buttonRenderer": {
"trackingParams": "CAcQvIYDIhMIl5Ggz6C6lwMV1mJPBB1HwRt-",
"command": {
"clickTrackingParams": "CAcQvIYDIhMIl5Ggz6C6lwMV1mJPBB1HwRt-ygEEMei6NQ==",
"commandMetadata": "…",
"signalServiceEndpoint": "…"
}
}
},
"forwardButton": {
"buttonRenderer": {
"trackingParams": "CAYQvYYDIhMIl5Ggz6C6lwMV1mJPBB1HwRt-",
"command": {
"clickTrackingParams": "CAYQvYYDIhMIl5Ggz6C6lwMV1mJPBB1HwRt-ygEEMei6NQ==",
"commandMetadata": "…",
"signalServiceEndpoint": "…"
}
}
},
"a11ySkipNavigationButton": {
"buttonRenderer": {
"style": "STYLE_DEFAULT",
"size": "SIZE_DEFAULT",
"isDisabled": false,
"text": {
"runs": "…"
},
"trackingParams": "CAUQ8FsiEwiXkaDPoLqXAxXWYk8EHUfBG34=",
"command": {
"clickTrackingParams": "CAUQ8FsiEwiXkaDPoLqXAxXWYk8EHUfBG37KAQQx6Lo1",
"commandMetadata": "…",
"signalServiceEndpoint": "…"
}
}
},
"voiceSearchButton": {
"buttonRenderer": {
"style": "STYLE_DEFAULT",
"size": "SIZE_DEFAULT",
"isDisabled": false,
"serviceEndpoint": {
"clickTrackingParams": "CAIQ7a8FIhMIl5Ggz6C6lwMV1mJPBB1HwRt-ygEEMei6NQ==",
"commandMetadata": "…",
"signalServiceEndpoint": "…"
},
"icon": {
"iconType": "MICROPHONE_ON"
},
"tooltip": "Search with your voice",
"trackingParams": "CAIQ7a8FIhMIl5Ggz6C6lwMV1mJPBB1HwRt-",
"accessibilityData": {
"accessibilityData": "…"
}
}
}
}
},
"targetId": "search-page",
"frameworkUpdates": {
"entityBatchUpdate": {
"mutations": [
{
"entityKey": "Ehh6VDhNMEJzQk81a19haV9zdW1tYXJpZXMgPigB",
"type": "ENTITY_MUTATION_TYPE_REPLACE",
"payload": {
"likeStatusEntity": "…"
}
},
{
"entityKey": "EhhuUWRYcDZIS0tpa19haV9zdW1tYXJpZXMgPigB",
"type": "ENTITY_MUTATION_TYPE_REPLACE",
"payload": {
"likeStatusEntity": "…"
}
},
{
"_more_items": 6
}
],
"timestamp": {
"seconds": "1792006551",
"nanos": 562795720
}
}
}
}
}Use this documentation as the first decision point, then move into pricing, platform coverage, and integration rules before you connect the endpoint for recurring use.
Use these answers to decide whether this API method fits your workflow, versioning choice, and rollout plan.
The method performs “All by country” for Search. The compact response example below shows the exact field structure.
Choose V2 for new integrations because it provides a normalized structure. Use V1 only for compatibility with clients that already consume the platform-native format.
Create an API key, send it in the request header, and provide the required parameters from the table. The code samples already contain the correct path and request structure.