SerpApi (предварительная версия)

Результаты поисковой системы в режиме реального времени с помощью SerpApi. Скребите Google, Bing, YouTube, Google Ученый и многое другое без управления прокси-серверами, CAPTCHAs или синтаксического анализа. SerpApi обрабатывает инфраструктуру, чтобы рабочие процессы получали чистый структурированный JSON.

Этот соединитель доступен в следующих продуктах и регионах:

Service	Class	Регионы
Copilot Studio	Premium	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих:      — Регионы Azure для государственных организаций      — Регионы Azure Для Китая      - Министерство обороны США (DoD)
Power Apps	Premium	Все регионы Power Apps , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Power Automate	Premium	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)

Контакт
Name	SerpApi
URL	https://serpapi.com
Эл. почта	support@serpapi.com

Метаданные соединителя
Publisher	SerpApi
Website	https://serpapi.com
Политика конфиденциальности	https://serpapi.com/legal/privacy
Categories	Сайт; Бизнес-аналитика

SerpApi

SerpApi — это API результатов поисковой системы в режиме реального времени. Он обрабатывает прокси-серверы, CAPTCHAs и синтаксический анализ, чтобы Power Apps и Power Automate потоки получали чистый структурированный JSON без управления инфраструктурой очистки.

Publisher: SerpApi

Prerequisites

• Учетная запись SerpApi. Зарегистрируйтесь в serpapi.com.
• Допустимый ключ API SerpApi. Бесплатные планы включают 250 поисковых запросов в месяц. Платные планы доступны для более высокого объема.

Поддерживаемые операции

Поиск Google (GoogleSearch)

Получение структурированных результатов поиска Google для заданного запроса. Возвращает органические результаты, объявления, записи графа знаний, связанные вопросы, локальные результаты, лучшие истории и многое другое. Точные возвращаемые поля зависят от запроса и того, какие поверхности Google для него.

Получение расположений (GetLocations)

Возвращает список поддерживаемых географических расположений, которые можно передать location параметру поиска. Используйте это для поиска точной строки расположения для города или региона перед выполнением поиска.

Получение сведений об учетной записи (GetAccount)

Возвращает сведения о вашей учетной записи SerpApi, включая текущий план, ежемесячную квоту поиска, оставшиеся поиски и почасовую статистику использования.

Получение учетных данных

1. Войдите в учетную запись SerpApi по serpapi.com.
2. Перейдите к serpapi.com/manage-api-key.
3. Скопируйте ключ API.
4. При создании подключения в Power Apps или Power Automate вставьте ключ API в поле "Ключ API".

Ключ API хранится безопасно с помощью Power Platform и автоматически внедряется в каждый запрос. После настройки подключения вам не потребуется снова предоставить его.

Getting Started

Основное использование

Действие GoogleSearch принимает один обязательный аргумент (поисковый запрос) и необязательную запись дополнительных параметров:

Set(varJsonResponse, SerpApi.GoogleSearch("coffee"))

Чтобы отобразить необработанный ответ JSON в элементе управления HTML Text для отладки:

$"<pre>{JSON(varJsonResponse, JSONFormat.IndentFour)}</pre>"

Передача необязательных параметров

Необязательные параметры передаются в виде записи (второй аргумент). Включайте только заданные параметры, не указывая, что ключ отправляет ничего для этого параметра, позволяя SerpApi использовать свой собственный параметр по умолчанию.

В следующем примере входные типы и имена являются рекомендациями, а не обязательными.

Set(varJsonResponse, SerpApi.GoogleSearch(
    searchQueryInput.Text,
    {
        location: locationInput.Text,
        gl: glInput.Text,
        hl: hlInput.Text,
        lat: latInput.Text,
        lon: lonInput.Text,
        radius: radiusInput.Text,
        uule: uuleInput.Text,
        google_domain: googleDomainInput.Text,
        cr: crInput.Text,
        lr: lrInput.Text,
        tbs: tbsInput.Text,
        nfpr: nfprCheckbox.Value,
        filter: filterCheckbox.Value,
        safe: safeDropdown.Selected.Value,
        device: deviceDropdown.Selected.Value,
        tbm: tbmDropdown.Selected.Value,
        start: startInput.Text,
        ludocid: ludocidInput.Text,
        lsig: lsigInput.Text,
        kgmid: kgmidInput.Text,
        si: siInput.Text,
        ibp: ibpInput.Text,
        uds: udsInput.Text,
        no_cache: noCacheCheckbox.Value
    }
))

Сопоставление типов элемента управления:

Тип параметра	Рекомендуемый элемент управления Power Apps	Справочник по значению
Текст (строка)	Ввод текста	controlName.Text
Boolean	Переключатель или флажок	controlName.Value
Перечисление (фиксированные параметры)	Раскрывающийся список	controlName.Selected.Value
Number	Ввод текста	controlName.Text

Доступ к данным ответа

Ответ — это объект JSON. Доступ к свойствам верхнего уровня напрямую от переменной:

varJsonResponse.search_information.total_results

Чтобы привязать коллекцию к органическим результатам, выполните следующие действия:

varJsonResponse.organic_results

Чтобы привязать коллекцию к локальным бизнес-результатам:

varJsonResponse.local_results.places

Полный список полей ответа см. в документации по Поиску Google SerpApi .

Поиск допустимой строки расположения

Используется GetLocations для поиска точного имени расположения для передачи GoogleSearch. Параметр q фильтруется по имени города или региона и limit заключит количество возвращаемых результатов.

Set(varLocations, SerpApi.GetLocations("Austin", {limit: 5}))

Чтобы привязать результаты к коллекции, выполните следующие действия.

varLocations

Каждый элемент в коллекции содержит name, canonical_name, country_code, target_type, reachи gps поля. canonical_name Передайте значение в качестве location параметра в последующий GoogleSearch вызов:

Set(varResults, SerpApi.GoogleSearch(
    "coffee shops",
    {location: locationGallery.Selected.canonical_name}
))

Проверка использования учетной записи

Используется GetAccount для получения сведений о текущем плане и использования квот. Это полезно для проверки количества поисковых запросов до достижения ежемесячного ограничения.

Set(varAccount, SerpApi.GetAccount())

Доступ к отдельным полям от ответа:

varAccount.plan_searches_left
varAccount.this_month_usage
varAccount.account_rate_limit_per_hour

Полный список полей ответа см. в документации по API учетной записи SerpApi .

Известные проблемы и ограничения

• Структура ответа переменной: поля, представленные в ответе поиска Google, зависят от запроса и того, что Google возвращает для него. Не все поля отображаются в каждом ответе. Дополнительные сведения о возможных полях ответа см. в документации по Поиску Google SerpApi .
• Ограничения скорости. Запросы распространяются на ежемесячную квоту плана SerpApi и почасовую ставку. Превышение любого из этих значений приведет к возникновению 429 ошибки.
• Кэшированные результаты. По умолчанию SerpApi обслуживает результаты из кэша для повторяющихся запросов, относящихся к каждому пользователю (до 1 часа). no_cache Используйте параметр для принудительного получения нового результата. Обратите внимание, что кэшированные поисковые запросы не учитываются в отношении ежемесячной квоты.

Support

Чтобы получить помощь с этим соединителем или учетной записью SerpApi, обратитесь в службу поддержки SerpApi:

• Email:contact@serpapi.com
• Live chat: Доступно 24/7 в serpapi.com, где вы можете поговорить непосредственно с членом группы поддержки SerpApi.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию	Параметры для создания подключения.	Все регионы	Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Name	Тип	Description	Обязательный
Ключ API	securestring	Ключ API SerpApi. Найдите его в https://serpapi.com/manage-api-key	True

Действия

Поиск Google	Получение структурированных результатов поиска Google для заданного запроса. Возвращает органические результаты, рекламу, граф знаний, связанные вопросы, основные истории, локальные результаты и многое другое.
Получение расположений	Возвращает список поддерживаемых географических расположений, которые можно использовать с параметром расположения в поиске. Полезно найти точную строку расположения для города или региона.
Получение сведений об учетной записи	Возвращает сведения об учетной записи SerpApi с проверкой подлинности, включая сведения о плане, оставшиеся поиски и статистику использования.

Поиск Google

Идентификатор операции:

GoogleSearch

Получение структурированных результатов поиска Google для заданного запроса. Возвращает органические результаты, рекламу, граф знаний, связанные вопросы, основные истории, локальные результаты и многое другое.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Поисковый запрос	q	True	string	Поисковый запрос. Поддерживает все стандартные операторы (например, site:, inurl:, intitle:) и дополнительные параметры, такие как as_dt и as_eq.
Местоположение	location		string	Расположение, из которого выполняется поиск. Укажите на уровне города лучшую точность (например, Остин, Техас). Нельзя использовать вместе с параметрами uule, lat или lon. См. сведения https://serpapi.com/locations-api о поддерживаемых расположениях.
Закодированное расположение (UULE)	uule		string	Строка расположения в кодировке Google. Используйте в качестве альтернативы параметру расположения для точного географического расположения. Нельзя использовать вместе с расположением, латом, лоном или радиусом.
Широта	lat		number	Широта GPS для источника поиска. Обязательный при использовании параметра lon. Нельзя использовать вместе с расположением или uule.
Долгота	lon		number	Gps долготы для источника поиска. Обязательный при использовании параметра lat. Нельзя использовать вместе с расположением или uule.
Radius (метров)	radius		integer	Расстояние в метрах, в пределах которого следует предвзять результаты поиска. Результаты внутри этого региона ранжируются выше. Можно использовать вместе с расположением или lat/lon. Максимальный радиус: 199 м на рабочем столе; 1000 м на планшете или мобильном устройстве. Нельзя использовать вместе с uule.
Домен Google	google_domain		string	Домен Google, используемый (например, google.com, google.co.uk, google.fr). По умолчанию используется google.com. Полный список см https://serpapi.com/google-domains . в списке.
Страна	gl		string	Двухбуквенный код страны для поиска (например, us, gb, fr, de). Полный список см https://serpapi.com/google-countries . в списке.
Language	hl		string	Двухбуквенный код языка интерфейса (например, en, es, fr, de). Полный список см https://serpapi.com/google-languages . в списке.
Ограничение страны	cr		string	Ограничить результаты документами, поступающими в определенных странах. Использование формата country{CODE} с | как разделитель (например, countryFR|countryDE).
Ограничение языка	lr		string	Ограничить результаты определенными языками. Использование формата lang_{code} с | как разделитель (например, lang_fr|lang_de).
Расширенный фильтр поиска	tbs		string	Расширенный фильтр поиска (для поиска). Включает фильтрацию по диапазону дат, типу контента и многому другому (например, qdr:d за прошлый день, qdr:w за прошлую неделю).
Безопасный поиск	safe		string	Уровень фильтрации содержимого для взрослых. Установите значение "Активный", чтобы включить фильтрацию или отключить ее.
Исключить автоматически исправленные результаты	nfpr		integer	Установите значение 1, чтобы исключить результаты из автоматически исправленных запросов при неправильном выполнении исходного запроса. Установите значение 0, чтобы включить их (по умолчанию).
Фильтр повторяющегося содержимого	filter		integer	Управляет аналогичными результатами и опущенными фильтрами результатов. Установите значение 1, чтобы включить (по умолчанию) или 0, чтобы отключить.
Тип поиска	tbm		string	Тип выполняемого поиска Google (для сопоставления). Опущен для обычного веб-поиска.
Смещение результата	start		integer	Смещение разбиения на страницы. Пропускает заданное количество результатов. 0 возвращает первую страницу, 10 возвращает вторую страницу и т. д.
Device	device		string	Тип устройства для имитации. Используйте настольный компьютер (по умолчанию), планшет или мобильное устройство.
Обход кэша	no_cache		boolean	Задайте значение true, чтобы принудительно получить свежий результат, обходя кэш SerpApi в течение 1 часа. Кэшированные поисковые запросы бесплатны и не учитываются в отношении ежемесячной квоты. Не используйте асинхронное использование.
Асинхронный режим	async		boolean	Задайте значение true, чтобы отправить поиск и получить результаты позже через API архива поиска, а не ожидать синхронно. Не используйте вместе с no_cache.
Формат выходных данных	output		string	Формат вывода. Задайте значение json (по умолчанию) для структурированного JSON или HTML для необработанного HTML- кода. Используйте html для отладки или для типов результатов, которые еще не полностью поддерживаются.
Размещение CID	ludocid		string	Google CID (идентификатор клиента) определенного места. Найдено в локальных результатах как place_id. Используется для извлечения графа знаний места.
Идентификатор Графа знаний	kgmid		string	КГМИД сущности Google Knowledge Graph. Может переопределить другие параметры поиска, кроме запуска.
Локальная подпись (lsig)	lsig		string	Используется для принудительного представления карты графа знаний для локального места. Получите через API локального пакета или Локальный API Google.
Параметры кэшированного поиска (si)	si		string	Кэшированные параметры поиска для вкладок "Граф знаний". Может переопределить другие параметры поиска, кроме запуска.
Расширение макета (ibp)	ibp		string	Элементы управления расширениями макета в результатах Google (например, gwp; 0,7).
Строка фильтра (uds)	uds		string	Строка фильтра Google для фильтрации результатов.
Нулевая трассировка	zero_trace		boolean	Только корпоративные учетные записи. Установите значение true, чтобы пропустить серверное хранилище параметров поиска и метаданных.

Возвращаемое значение

Имя	Путь	Тип	Описание
search_metadata	search_metadata	object	Метаданные запроса поиска, включая состояние, время и идентификаторы SerpApi.
search_parameters	search_parameters	object	Параметры, используемые для этого поиска, отступили обратно из запроса.
search_information	search_information	object	Высокоуровневые сведения о поиске, такие как общее количество результатов и время.
organic_results	organic_results	array of object	Стандартные органические веб-результаты, возвращаемые Google.
items	organic_results	object
Объявления	ads	array of object	Платные объявления, показанные выше или ниже органических результатов.
items	ads	object
knowledge_graph	knowledge_graph	object	Данные панели мониторинга Google Knowledge Graph, если они присутствуют для запроса.
related_questions	related_questions	array of object	Люди также задают вопросы, связанные с запросом.
items	related_questions	object
related_searches	related_searches	array of object	Связанные предложения поиска отображаются в нижней части страницы результатов.
items	related_searches	object
local_results	local_results	object	Результаты локального пакета, присутствующих при наличии локального намерения запроса.
top_stories	top_stories	array of object	Основные новости, связанные с запросом.
items	top_stories	object
Разбивка на страницы	pagination	object	Ссылки на следующие и предыдущие страницы результатов.

Получение расположений

Идентификатор операции:

GetLocations

Возвращает список поддерживаемых географических расположений, которые можно использовать с параметром расположения в поиске. Полезно найти точную строку расположения для города или региона.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Условие поиска	q		string	Имя города или региона для фильтрации списка доступных расположений (например, Остин).
Лимит	limit		integer	Максимальное количество возвращаемых расположений.

Возвращаемое значение

response

array of Location

Получение сведений об учетной записи

Идентификатор операции:

GetAccount

Возвращает сведения об учетной записи SerpApi с проверкой подлинности, включая сведения о плане, оставшиеся поиски и статистику использования.

Возвращаемое значение

Сведения о учетной записи SerpApi, прошедшей проверку подлинности.

Тело

AccountInfo

Определения

Местоположение

Поддерживаемое географическое расположение для использования с параметром поиска расположения.

Имя	Путь	Тип	Описание
id	id	string	Уникальный идентификатор для этого расположения.
имя	name	string	Полное имя расположения (например, Остин, Техас, США).
canonical_name	canonical_name	string	Каноническое имя, используемое в параметре расположения.
country_code	country_code	string	Двухбуквенный код страны ISO.
target_type	target_type	string	Тип расположения (например, город, регион DMA, страна).
Достичь	reach	integer	Предполагаемый ежемесячный объем поиска для этого расположения.
Gps	gps	array of number	КООРДИНАТы GPS в виде [широты, долготы].

Информация об учетной записи

Сведения о учетной записи SerpApi, прошедшей проверку подлинности.

Имя	Путь	Тип	Описание
account_id	account_id	string	Уникальный идентификатор для учетной записи.
ключ API	api_key	string	Ключ API для этой учетной записи.
account_email	account_email	string	Адрес электронной почты, связанный с учетной записью.
plan_name	plan_name	string	Имя текущего плана подписки.
plan_monthly_price	plan_monthly_price	number	Ежемесячная цена текущего плана в долларах США.
searches_per_month	searches_per_month	integer	Общее количество поисковых запросов, включенных в месяц по текущему плану.
plan_searches_left	plan_searches_left	integer	Количество поисковых запросов, оставшихся в текущем периоде выставления счетов.
extra_credits	extra_credits	integer	Дополнительные кредиты поиска, приобретенные за пределами плана.
account_rate_limit_per_hour	account_rate_limit_per_hour	integer	Максимальное количество запросов API, разрешенных в час.
this_month_usage	this_month_usage	integer	Количество поисковых запросов, используемых до сих пор в этот период выставления счетов.
this_hour_searches	this_hour_searches	integer	Количество поисковых запросов, выполненных в текущий час.
last_hour_searches	last_hour_searches	integer	Количество поисковых запросов, выполненных за предыдущий час.