SerpApi (Pré-visualização)

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

Service	Class	Regiões
Estúdio Copiloto	Premium	Todas as regiões Power Automate exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes:      - Regiões do Azure Government      - Regiões Azure China      - Departamento de Defesa dos EUA (DoD)
Power Apps	Premium	Todas as regiões Power Apps exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Power Automate	Premium	Todas as regiões Power Automate exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)

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

Metadados do conector
Editor	SerpApi
Sítio Web	https://serpapi.com
Política de privacidade	https://serpapi.com/legal/privacy
Categorias	Sítio Web; Inteligência de Negócios

SerpApi

O SerpApi é uma API de resultados para motores de busca em tempo real. Gerem proxies, CAPTCHAs e análise para que os seus fluxos de Power Apps e Power Automate recebam JSON limpo e estruturado sem gerir qualquer infraestrutura de scraping.

Publisher: SerpApi

Pré-requisitos

• Uma conta SerpApi. Inscreva-se em serpapi.com.
• Uma chave válida da API SerpApi. Os planos gratuitos incluem 250 pesquisas por mês. Estão disponíveis planos pagos para volumes mais elevados.

Operações suportadas

Pesquisa Google (GoogleSearch)

Recupere resultados estruturados de pesquisa do Google para uma determinada consulta. Devolve resultados orgânicos, anúncios, entradas em grafos de conhecimento, perguntas relacionadas, resultados locais, principais notícias e muito mais. Os campos exatos devolvidos dependem da consulta e do que o Google mostra para ela.

Obter Localizações (GetLocations)

Devolve uma lista de localizações geográficas suportadas que podem ser passadas ao location parâmetro de uma pesquisa. Use isto para consultar a cadeia de localização exata de uma cidade ou região antes de fazer uma pesquisa.

Obtenha Informações da Conta (GetAccount)

Devolve informações sobre a sua conta SerpApi, incluindo o seu plano atual, quota mensal de pesquisas, pesquisas restantes e estatísticas de utilização horária.

Obtenção de credenciais

1. Inicie sessão na sua conta SerpApi em serpapi.com.
2. Navegue até serpapi.com/manage-api-key.
3. Copia a tua chave API.
4. Ao criar uma ligação no Power Apps ou Power Automate, cole a sua chave API no campo da Chave API.

A sua chave API é armazenada de forma segura pelo Power Platform e injetada automaticamente em cada pedido. Não precisará de a fornecer novamente depois de a ligação estar estabelecida.

Introdução

Utilização básica

A GoogleSearch ação reúne um argumento obrigatório (a consulta de pesquisa) e um registo opcional de parâmetros adicionais:

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

Para mostrar a resposta JSON bruta num controlo de texto HTML para depuração:

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

Aprovação de parâmetros opcionais

Parâmetros opcionais são passados como um registo (o segundo argumento). Inclui apenas os parâmetros que queres definir — omitir uma chave não envia nada para esse parâmetro, permitindo que o SerpApi use o seu próprio padrão.

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

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 do tipo de controlo:

Tipo de parâmetro	Controlo recomendado do Power Apps	Referência de valor
Texto (string)	Entrada de texto	controlName.Text
booleano	Alternar ou Marcar a Caixa	controlName.Value
Enum (opções fixas)	Menu Suspenso	controlName.Selected.Value
Número	Entrada de texto	controlName.Text

Aceder a dados de resposta

A resposta é um objeto JSON. Acede diretamente às propriedades de topo a partir da variável:

varJsonResponse.search_information.total_results

Para ligar uma Galeria aos resultados orgânicos:

varJsonResponse.organic_results

Para ligar uma Galeria aos resultados dos negócios locais:

varJsonResponse.local_results.places

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

Procurar uma cadeia de localização válida

Use GetLocations para encontrar o nome exato do local a passar para GoogleSearch. O q parâmetro filtra por nome da cidade ou região e limit limita o número de resultados devolvidos.

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

Para vincular os resultados a uma Galeria:

varLocations

Cada item da coleção tem name, canonical_name, country_code, target_type, reach, e gps campos. Passe o canonical_name valor como location parâmetro numa chamada subsequente GoogleSearch :

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

Utilização da conta à ordem

Use GetAccount para obter os detalhes do seu plano atual e a utilização da quota. Isto é útil para verificar quantas pesquisas restam antes de atingir o limite mensal.

Set(varAccount, SerpApi.GetAccount())

Aceda a campos individuais da resposta:

varAccount.plan_searches_left
varAccount.this_month_usage
varAccount.account_rate_limit_per_hour

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

Problemas conhecidos e limitações

• Estrutura de resposta variável: Os campos presentes numa resposta do Google Search dependem da consulta e do que o Google devolve para ela. Nem todos os campos aparecem em todas as respostas. Consulte a documentação de pesquisa do Google do SerpApi para uma descrição completa dos possíveis campos de resposta.
• Limites de taxa: Os pedidos estão sujeitos à quota mensal e ao limite de tarifa horária do seu plano SerpApi. Exceder qualquer um deles resultará numa 429 resposta de erro.
• Resultados em cache: Por defeito, o SerpApi fornece resultados da sua cache para pedidos duplicados específicos de cada utilizador (com até 1 hora). Use o no_cache parâmetro para forçar um resultado novo. Note que as pesquisas em cache não contam para a sua quota mensal.

Support

Para obter ajuda com este conector ou com a sua conta SerpApi, contacte a equipa de suporte da SerpApi:

• Email:contact@serpapi.com
• Chat ao vivo: Disponível 24/7 às serpapi.com, onde pode falar diretamente com um membro da equipa de apoio da SerpApi.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição	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.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
Chave de API	securestring	A tua chave API do SerpAPI. Encontre-o em https://serpapi.com/manage-api-key	Verdade

Ações

Obter informações da conta	Devolve informações sobre a conta SerpApi autenticada, incluindo detalhes do plano, pesquisas restantes e estatísticas de utilização.
Obter Localizações	Devolve uma lista de localizações geográficas suportadas que podem ser usadas com o parâmetro de localização numa pesquisa. Útil para encontrar a sequência exata de localização de uma cidade ou região.
Pesquisa Google	Recupere resultados estruturados de pesquisa do Google para uma determinada consulta. Devolve resultados orgânicos, anúncios, gráfico de conhecimento, perguntas relacionadas, notícias principais, resultados locais e muito mais.

Obter informações da conta

Obter Localizações

Pesquisa Google

Definições

Location

Informação da Conta