Google Related Questions
Раскрытие дополнительных вопросов из блока People also ask по next_page_token из обычного Google Search ответа.
Вызов через @xylop/api-client-typescript
import { XylopSearchClient, XylopSearchEngines } from "@xylop/api-client-typescript";
interface SearchResponse {
[key: string]: unknown;
}
const client = new XylopSearchClient({
apiKey: "YOUR_API_KEY"
});
const response = await client.search<SearchResponse>(
XylopSearchEngines.GoogleRelatedQuestions,
{
next_page_token: "related_questions.next_page_token",
no_cache: "false",
});
TypeScript SDK написан на TypeScript, генерирует `.d.ts`, поддерживает generic response type и работает через `fetch`.
Вызов через @xylop/api-client
import { XylopSearchClient, XylopSearchEngines } from "@xylop/api-client";
const client = new XylopSearchClient({
apiKey: "YOUR_API_KEY"
});
const response = await client.search(
XylopSearchEngines.GoogleRelatedQuestions,
{
next_page_token: "related_questions.next_page_token",
no_cache: "false",
});
JavaScript SDK работает в Node.js 18+ и современных браузерах через `fetch`; TypeScript declarations входят в npm package.
Вызов через XylopSearchClient
using Xylop.Api.Client;
var client = new XylopSearchClient(new HttpClient(), "YOUR_API_KEY");
using var response = await client.SearchJsonAsync(
XylopSearchEngines.GoogleRelatedQuestions,
new Dictionary<string, string?>
{
["next_page_token"] = "related_questions.next_page_token",
["no_cache"] = "false",
});
Для типизированного режима используйте `SearchAsync<TResponse>` и response-модель из `Xylop.Logic.SerpApiResponses.*`, которая входит в пакет C# SDK.
Вызов через xylop-api-client
from xylop_api_client import XylopSearchClient, XylopSearchEngines
client = XylopSearchClient("YOUR_API_KEY")
response = client.search(
XylopSearchEngines.GOOGLE_RELATED_QUESTIONS,
{
"next_page_token": "related_questions.next_page_token",
"no_cache": "false",
},
)
Python SDK возвращает JSON как обычные `dict`/`list` и не требует runtime-зависимостей.
Вызов через xylop/api-client
<?php
use Xylop\Api\Client\XylopSearchClient;
use Xylop\Api\Client\XylopSearchEngines;
$client = new XylopSearchClient('YOUR_API_KEY');
$response = $client->search(
XylopSearchEngines::GOOGLE_RELATED_QUESTIONS,
[
'next_page_token' => 'related_questions.next_page_token',
'no_cache' => 'false',
]
);
PHP SDK использует стандартные stream wrappers, возвращает decoded JSON array и не требует runtime-зависимостей.
Вызов через xylop-api-client
require "xylop_api_client"
client = XylopApiClient::Client.new(api_key: "YOUR_API_KEY")
response = client.search(
XylopApiClient::Engines::GOOGLE_RELATED_QUESTIONS,
{
"next_page_token" => "related_questions.next_page_token",
"no_cache" => "false",
}
)
Ruby SDK использует стандартные `net/http`, `json` и возвращает JSON как обычные Hash/Array значения.
Вызов через xylop-api-client
import java.util.Map;
import ru.xylop.api.client.XylopSearchClient;
import ru.xylop.api.client.XylopSearchEngines;
var client = new XylopSearchClient("YOUR_API_KEY");
String responseJson = client.searchJson(
XylopSearchEngines.GOOGLE_RELATED_QUESTIONS,
Map.of(
"next_page_token", "related_questions.next_page_token",
"no_cache", "false"
));
Java SDK использует `java.net.http.HttpClient`, возвращает JSON-строку и не требует runtime-зависимостей.
Вызов через xylop-api-kotlin-client
import ru.xylop.api.kotlin.XylopSearchClient
import ru.xylop.api.kotlin.XylopSearchEngines
val client = XylopSearchClient("YOUR_API_KEY")
val responseJson = client.searchJson(
XylopSearchEngines.GOOGLE_RELATED_QUESTIONS,
mapOf(
"next_page_token" to "related_questions.next_page_token",
"no_cache" to "false",
),
)
Kotlin SDK использует JVM `HttpClient`, возвращает JSON-строку и оставляет JSON-маппинг приложению.
Вызов через XylopApiClient
import XylopApiClient
let client = XylopSearchClient(apiKey: "YOUR_API_KEY")
let response = try await client.searchJSON(
engine: XylopSearchEngines.googleRelatedQuestions,
parameters: [
"next_page_token": "related_questions.next_page_token",
"no_cache": "false",
]
)
Swift SDK использует Foundation `URLSession`, поддерживает async/await и возвращает Data, JSONSerialization values или caller-owned Decodable models.
Вызов через xylop_api_client
import 'package:xylop_api_client/xylop_api_client.dart';
Future<void> main() async {
final client = XylopSearchClient('YOUR_API_KEY');
final response = await client.search(
XylopSearchEngines.googleRelatedQuestions,
<String, Object?>{
'next_page_token': 'related_questions.next_page_token',
'no_cache': 'false',
},
);
print(response);
}
Dart SDK использует `dart:io`, возвращает decoded JSON или raw response text и не требует runtime-зависимостей.
Вызов через Xylop.Api.Cpp
#include <xylop/api/client.hpp>
#include <xylop/api/curl_transport.hpp>
int main()
{
xylop::api::search_client client(
"YOUR_API_KEY",
xylop::api::curl_transport);
auto response_json = client.search_text(
xylop::api::engines::google_related_questions,
{
{"next_page_token", "related_questions.next_page_token"},
{"no_cache", "false"},
});
return 0;
}
C++ SDK имеет header-only C++17 core, принимает transport callback и может использовать optional libcurl adapter `xylop::api::curl_transport`.
Вызов через Xylop.Api.Go
package main
import (
"context"
"log"
xylop "github.com/Leonid-Vizel/Xylop.AdminPanel/src/Xylop.Api.Go"
)
func main() {
client, err := xylop.NewClient("YOUR_API_KEY")
if err != nil {
log.Fatal(err)
}
var response map[string]any
err = client.SearchJSON(
context.Background(),
xylop.EngineGoogleRelatedQuestions,
xylop.Params(map[string]string{
"next_page_token": "related_questions.next_page_token",
"no_cache": "false",
}),
&response)
if err != nil {
log.Fatal(err)
}
}
Go SDK возвращает raw JSON bytes или декодирует ответ в пользовательскую структуру, `map[string]any` либо другой target.
HTTP контракт
- URL
https://api.xylop.ru/search- Engine
google_related_questions- API key
- Передается SDK автоматически из настроек клиента.
Параметры запроса
| Параметр | Тип | Обязателен | Значение | Описание |
|---|---|---|---|---|
api_key
SDK
|
string | Да | — | Ключ Xylop API. В SDK задается один раз в настройках или конструкторе клиента. |
engine
SDK
|
string | Да |
google_related_questions
|
Движок Google Related Questions. |
next_page_token
|
string | Да | related_questions.next_page_token | Токен из блока related_questions обычного Google Search ответа. |
no_cache
|
string | Нет |
false
|
Принудительно запросить свежий ответ. |
Поля ответа
| Поле | Тип | Источник | Описание |
|---|---|---|---|
search_metadata |
object | пример ответа | Метаданные запроса: статус, идентификатор, время выполнения и служебная информация провайдера. |
search_parameters |
object | пример ответа | Нормализованные параметры, с которыми upstream-поиск выполнил запрос. |
related_questions |
array | пример ответа | Типизированное поле ответа для этого engine; структура зависит от upstream-провайдера и параметров запроса. |
Пример ответа
{
"search_metadata": {
"status": "Success",
"google_related_questions_url": "https://www.google.com/search?..."
},
"search_parameters": {
"engine": "google_related_questions",
"next_page_token": "..."
},
"related_questions": [
{
"question": "What are negative effects of coffee?",
"type": "featured_snippet",
"snippet": "Caffeine can cause insomnia, nervousness, restlessness, nausea and increased heart rate.",
"title": "Caffeine - Uses, Side Effects, and More",
"link": "https://example.com/caffeine",
"displayed_link": "https://example.com",
"next_page_token": "..."
},
{
"question": "Can I drink coffee every day?",
"type": "ai_overview",
"text_blocks": [
{
"type": "paragraph",
"snippet": "For many adults, moderate coffee intake can fit into a balanced diet.",
"reference_indexes": [
0
]
}
],
"references": [
{
"title": "Coffee and health",
"link": "https://example.com/coffee-health",
"source": "Example Health",
"index": 0
}
],
"page_token": "...",
"next_page_token": "..."
}
]
}