SerpApi (versão prévia)

Resultados do mecanismo de pesquisa em tempo real por meio do SerpApi. Raspe Google, Bing, YouTube, Google Scholar e muito mais sem gerenciar proxies, CAPTCHAs ou analisadores. O SerpApi manipula a infraestrutura para que seus fluxos de trabalho recebam JSON limpo e estruturado.

Esse conector está disponível nos seguintes produtos e regiões:

Service	Classe	Regions
Copilot Studio	Premium	Todas as regiões do Power Automate , exceto as seguintes:      – Governo dos EUA (GCC)      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos	Standard	Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:      – Regiões do Azure Governamental      - Regiões do Azure China      - Departamento de Defesa dos EUA (DoD)
Power Apps	Premium	Todas as regiões do Power Apps , exceto as seguintes:      – Governo dos EUA (GCC)      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Power Automate	Premium	Todas as regiões do Power Automate , exceto as seguintes:      – Governo dos EUA (GCC)      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)

Contato
Nome	SerpApi
URL	https://serpapi.com
Email	support@serpapi.com

Metadados do conector
Publicador	SerpApi
Website	https://serpapi.com
Política de privacidade	https://serpapi.com/legal/privacy
Categories	Site; Business Intelligence

SerpApi

SerpApi é uma API de resultados do mecanismo de pesquisa em tempo real. Ele manipula proxies, CAPTCHAs e análise para que seus fluxos Power Apps e Power Automate recebam JSON limpo e estruturado sem gerenciar nenhuma infraestrutura de raspagem.

Publisher: SerpApi

Pré-requisitos

• Uma conta do SerpApi. Inscreva-se no serpapi.com.
• Uma chave de API SerpApi válida. Os planos gratuitos incluem 250 pesquisas por mês. Os planos pagos estão disponíveis para maior volume.

Operações com suporte

Pesquisa no Google (GoogleSearch)

Recupere os resultados estruturados da Pesquisa do Google para uma determinada consulta. Retorna resultados orgânicos, anúncios, entradas de grafo de conhecimento, perguntas relacionadas, resultados locais, principais histórias e muito mais. Os campos exatos retornados dependem da consulta e do que o Google apresenta para ela.

Obter locais (GetLocations)

Retorna uma lista de locais geográficos com suporte que podem ser passados para o location parâmetro de uma pesquisa. Use isso para pesquisar a cadeia de caracteres de localização exata para uma cidade ou região antes de executar uma pesquisa.

Obter informações da conta (GetAccount)

Retorna informações sobre sua conta do SerpApi, incluindo seu plano atual, cota de pesquisa mensal, pesquisas restantes e estatísticas de uso por hora.

Obtendo credenciais

1. Entre em sua conta do SerpApi em serpapi.com.
2. Navegue até serpapi.com/manage-api-key.
3. Copie sua chave de API.
4. Ao criar uma conexão em Power Apps ou Power Automate, cole sua chave de API no campo Chave de API.

Sua chave de API é armazenada com segurança pelo Power Platform e injetada automaticamente em cada solicitação. Você não precisará fornecê-lo novamente depois que a conexão for configurada.

Introdução

Uso Básico

A GoogleSearch ação usa um argumento necessário (a consulta de pesquisa) e um registro opcional de parâmetros adicionais:

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

Para exibir a resposta JSON bruta em um controle de texto HTML para depuração:

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

Passando parâmetros opcionais

Parâmetros opcionais são passados como um registro (o segundo argumento). Inclua apenas os parâmetros que você deseja definir – omitir uma chave não envia nada para esse parâmetro, permitindo que o SerpApi use seu próprio padrão.

No exemplo a seguir, os tipos de entrada e os nomes são recomendações, não obrigatórias.

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
    }
))

Mapeamento de tipo de controle:

Tipo de parâmetro	Controle de Power Apps recomendado	Referência de valor
Texto (cadeia de caracteres)	Entrada de texto	controlName.Text
booleano	Alternar ou caixa de seleção	controlName.Value
Enumeração (opções fixas)	Lista suspensa	controlName.Selected.Value
Número	Entrada de texto	controlName.Text

Acessando dados de resposta

A resposta é um objeto JSON. Acesse as propriedades de nível superior diretamente da variável:

varJsonResponse.search_information.total_results

Para associar uma Galeria aos resultados orgânicos:

varJsonResponse.organic_results

Para associar uma Galeria aos resultados de negócios locais:

varJsonResponse.local_results.places

Consulte a documentação do SerpApi Google Search para obter a lista completa de campos de resposta.

Pesquisando uma cadeia de caracteres de localização válida

Use GetLocations para localizar o nome exato do local para o qual GoogleSearchpassar. O q parâmetro filtra por nome de cidade ou região e limit limita o número de resultados retornados.

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

Para associar os resultados a uma Galeria:

varLocations

Cada item da coleção temname, canonical_name, country_code, , target_typee reachgps campos. Passe o canonical_name valor como o location parâmetro em uma chamada subsequente GoogleSearch :

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

Verificando o uso da conta

Use GetAccount para recuperar os detalhes do plano atual e o uso da cota. Isso é útil para verificar quantas pesquisas permanecem antes de atingir o limite mensal.

Set(varAccount, SerpApi.GetAccount())

Acesse campos individuais fora da resposta:

varAccount.plan_searches_left
varAccount.this_month_usage
varAccount.account_rate_limit_per_hour

Consulte a documentação da API da Conta do SerpApi para obter a lista completa de campos de resposta.

Problemas e limitações conhecidos

• Estrutura de resposta variável: os campos presentes em uma resposta do Google Search dependem da consulta e do que o Google retorna para ela. Nem todos os campos aparecem em todas as respostas. Consulte a documentação do SerpApi Google Search para obter uma descrição completa dos possíveis campos de resposta.
• Limites de taxa: as solicitações estão sujeitas à cota mensal do plano SerpApi e ao limite de taxa por hora. Exceder qualquer um resultará em uma 429 resposta de erro.
• Resultados armazenados em cache: por padrão, o SerpApi fornece resultados de seu cache para solicitações duplicadas específicas para cada usuário (até 1 hora de idade). Use o no_cache parâmetro para forçar um novo resultado. Observe que as pesquisas armazenadas em cache não contam para sua cota mensal.

Suporte

Para obter ajuda com esse conector ou sua conta do SerpApi, entre em contato com a equipe de suporte do SerpApi:

• Email:contact@serpapi.com
• Chat ao vivo: Disponível 24/7 em serpapi.com, onde você pode falar diretamente com um membro da equipe de suporte do SerpApi.

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Default	Parâmetros para criar conexão.	Todas as regiões	Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Descrição	Obrigatório
Chave de API	secureString	Sua chave de API serpApi. Localize-o em https://serpapi.com/manage-api-key	Verdade

Ações

Obter informações da conta	Retorna informações sobre a conta autenticada do SerpApi, incluindo detalhes do plano, pesquisas restantes e estatísticas de uso.
Obter locais	Retorna uma lista de locais geográficos com suporte que podem ser usados com o parâmetro de localização em uma pesquisa. Útil para localizar a cadeia de caracteres de localização exata para uma cidade ou região.
Pesquisa do Google	Recupere os resultados estruturados da Pesquisa do Google para uma determinada consulta. Retorna resultados orgânicos, anúncios, grafo de conhecimento, perguntas relacionadas, principais histórias, resultados locais e muito mais.

Obter informações da conta

ID da operação:

GetAccount

Retorna informações sobre a conta autenticada do SerpApi, incluindo detalhes do plano, pesquisas restantes e estatísticas de uso.

Retornos

Informações sobre a conta autenticada do SerpApi.

Corpo

AccountInfo

Obter locais

ID da operação:

GetLocations

Retorna uma lista de locais geográficos com suporte que podem ser usados com o parâmetro de localização em uma pesquisa. Útil para localizar a cadeia de caracteres de localização exata para uma cidade ou região.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Termo de pesquisa	q		string	Um nome de cidade ou região para filtrar a lista de locais disponíveis (por exemplo, Austin).
Limit	limit		integer	Número máximo de locais a serem retornados.

Retornos

response

array of Location

Pesquisa do Google

ID da operação:

GoogleSearch

Recupere os resultados estruturados da Pesquisa do Google para uma determinada consulta. Retorna resultados orgânicos, anúncios, grafo de conhecimento, perguntas relacionadas, principais histórias, resultados locais e muito mais.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Consulta de pesquisa	q	True	string	A consulta de pesquisa. Dá suporte a todos os operadores padrão (por exemplo, site:, inurl:, intitle:) e parâmetros avançados, como as_dt e as_eq.
Localidade	location		string	O local do qual a pesquisa se origina. Especifique no nível da cidade para obter a melhor precisão (por exemplo, Austin, Texas). Não pode ser usado junto com parâmetros uule, lat ou lon. https://serpapi.com/locations-api Consulte os locais com suporte.
Local codificado (UULE)	uule		string	A cadeia de caracteres de localização codificada do Google. Use como alternativa ao parâmetro de localização para localização geográfica precisa. Não pode ser usado junto com localização, lat, lon ou raio.
Latitude	lat		number	Latitude gps para a origem da pesquisa. Necessário ao usar o parâmetro de lon. Não pode ser usado junto com a localização ou uule.
longitude	lon		number	Longitude de GPS para a origem da pesquisa. Necessário ao usar o parâmetro lat. Não pode ser usado junto com a localização ou uule.
Raio (metros)	radius		integer	Distância em metros nos quais os resultados da pesquisa serão tendenciosos. Os resultados dentro dessa região são classificados mais alto. Pode ser usado junto com o local ou lat/lon. Raio máximo: 199 m na área de trabalho; 1000 m em tablet ou celular. Não pode ser usado junto com uule.
Domínio do Google	google_domain		string	O domínio do Google a ser usado (por exemplo, google.com, google.co.uk, google.fr). O padrão é google.com. Confira https://serpapi.com/google-domains a lista completa.
Country	gl		string	Código de país de duas letras para a pesquisa (por exemplo, us, gb, fr, de). Confira https://serpapi.com/google-countries a lista completa.
Linguagem	hl		string	Código de linguagem de interface de duas letras (por exemplo, en, es, fr, de). Confira https://serpapi.com/google-languages a lista completa.
Restrição de país	cr		string	Restrinja os resultados a documentos originários de países específicos. Usar o formato country{CODE} com | como delimitador (por exemplo, countryFR|countryDE).
Restrição de idioma	lr		string	Restrinja os resultados a idiomas específicos. Use o formato lang_{code} com | como delimitador (por exemplo, lang_fr|lang_de).
Filtro de Pesquisa Avançado	tbs		string	Filtro de pesquisa avançado (a ser pesquisado). Habilita a filtragem por intervalo de datas, tipo de conteúdo e muito mais (por exemplo, qdr:d para o dia anterior, qdr:w para a semana passada).
SafeSearch	safe		string	Nível de filtragem de conteúdo adulto. Defina como ativo para habilitar a filtragem ou desabilitá-la.
Excluir resultados corrigidos automaticamente	nfpr		integer	Defina como 1 para excluir resultados de consultas corrigidas automaticamente quando a consulta original for incorreta. Defina como 0 para incluí-los (padrão).
Filtro de conteúdo duplicado	filter		integer	Controla resultados semelhantes e filtros de resultados omitidos. Defina como 1 para habilitar (padrão) ou 0 para desabilitar.
Tipo de pesquisa	tbm		string	O tipo de pesquisa do Google a ser executada (a ser correspondida). Omita uma pesquisa regular na Web.
Deslocamento de resultados	start		integer	Deslocamento de paginação. Ignora o número determinado de resultados. 0 retorna a primeira página, 10 retorna a segunda página, etc.
Dispositivo	device		string	O tipo de dispositivo a ser simulado. Use a área de trabalho (padrão), tablet ou dispositivo móvel.
Ignorar cache	no_cache		boolean	Definido como true para forçar um novo resultado, ignorando o cache de 1 hora do SerpApi. As pesquisas armazenadas em cache são gratuitas e não contam para sua cota mensal. Não use junto com assíncrono.
Modo assíncrono	async		boolean	Defina como true para enviar a pesquisa e recuperar resultados posteriormente por meio da API de Arquivo Morto de Pesquisa, em vez de aguardar resultados de forma síncrona. Não use junto com no_cache.
Formato de saída	output		string	Formato de saída. Defina como json (padrão) para JSON estruturado ou html para HTML bruto. Use html para depuração ou para tipos de resultados ainda não totalmente compatíveis.
Colocar CID	ludocid		string	CID do Google (identificador de cliente) de um local específico. Encontrado em resultados locais como place_id. Usado para recuperar o grafo de conhecimento de um local.
ID do Gráfico de Conhecimento	kgmid		string	O KGMID de uma entidade do Google Knowledge Graph. Pode substituir outros parâmetros de pesquisa, exceto iniciar.
Assinatura Local (lsig)	lsig		string	Usado para forçar a exibição do mapa do gráfico de conhecimento para um local. Obtenha por meio da API do Pacote Local ou da API Local do Google.
Parâmetros de pesquisa armazenados em cache (si)	si		string	Parâmetros de pesquisa criptografados em cache para guias do Gráfico de Conhecimento. Pode substituir outros parâmetros de pesquisa, exceto iniciar.
Expansão de layout (ibp)	ibp		string	Controla expansões de layout nos resultados do Google (por exemplo, gwp; 0,7).
Cadeia de caracteres de filtro (uds)	uds		string	Cadeia de caracteres de filtro fornecida pelo Google para filtragem de resultados.
Rastreamento zero	zero_trace		boolean	Somente contas corporativas. Defina como true para ignorar o armazenamento do lado do servidor de parâmetros e metadados de pesquisa.

Retornos

Nome	Caminho	Tipo	Description
search_metadata	search_metadata	object	Metadados sobre a solicitação de pesquisa, incluindo status, tempo e identificadores SerpApi.
search_parameters	search_parameters	object	Os parâmetros usados para essa pesquisa ecoaram de volta da solicitação.
search_information	search_information	object	Informações de alto nível sobre a pesquisa, como contagem total de resultados e tempo gasto.
organic_results	organic_results	array of object	Resultados orgânicos padrão da Web retornados pelo Google.
items	organic_results	object
Anúncios	ads	array of object	Anúncios pagos mostrados acima ou abaixo de resultados orgânicos.
items	ads	object
knowledge_graph	knowledge_graph	object	Dados do painel do Google Knowledge Graph, se presentes para a consulta.
related_questions	related_questions	array of object	As pessoas também fazem perguntas relacionadas à consulta.
items	related_questions	object
related_searches	related_searches	array of object	Sugestões de pesquisa relacionadas mostradas na parte inferior da página de resultados.
items	related_searches	object
local_results	local_results	object	Resultados do pacote local, presentes quando a consulta tiver intenção local.
top_stories	top_stories	array of object	Principais notícias relacionadas à consulta.
items	top_stories	object
paginação	pagination	object	Links para as páginas seguintes e anteriores dos resultados.

Definições

Localidade

Uma localização geográfica com suporte para uso com o parâmetro de pesquisa de localização.

Nome	Caminho	Tipo	Description
id	id	string	Identificador exclusivo para esse local.
name	name	string	Nome completo do local (por exemplo, Austin, Texas, Estados Unidos).
canonical_name	canonical_name	string	Nome canônico usado no parâmetro de localização.
country_code	country_code	string	Código de país ISO de duas letras.
target_type	target_type	string	Tipo de local (por exemplo, Cidade, Região do DMA, País).
alcance	reach	integer	Alcance estimado do volume de pesquisa mensal para esse local.
Gps	gps	array of number	Coordenadas GPS como [latitude, longitude].

Informações da conta

Informações sobre a conta autenticada do SerpApi.

Nome	Caminho	Tipo	Description
account_id	account_id	string	Identificador exclusivo da conta.
chave_de_api	api_key	string	A chave de API dessa conta.
account_email	account_email	string	Endereço de email associado à conta.
plan_name	plan_name	string	Nome do plano de assinatura atual.
plan_monthly_price	plan_monthly_price	number	Preço mensal do plano atual em USD.
searches_per_month	searches_per_month	integer	Número total de pesquisas incluídas por mês no plano atual.
plan_searches_left	plan_searches_left	integer	Número de pesquisas restantes no período de cobrança atual.
extra_credits	extra_credits	integer	Créditos de pesquisa adicionais comprados fora do plano.
account_rate_limit_per_hour	account_rate_limit_per_hour	integer	Número máximo de solicitações de API permitidas por hora.
this_month_usage	this_month_usage	integer	Número de pesquisas usadas até agora neste período de cobrança.
this_hour_searches	this_hour_searches	integer	Número de pesquisas feitas na hora atual.
last_hour_searches	last_hour_searches	integer	Número de pesquisas feitas na hora anterior.