SerpApi

Este conector está disponible en los siguientes productos y regiones:

Service	Class	Regions
Copilot Studio	Premium	Todas las regiones de Power Automate excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps excepto las siguientes:      - Regiones de Azure Government      - Regiones de Azure China      - Departamento de Defensa de EE. UU. (DoD)
Power Apps	Premium	Todas las regiones de Power Apps excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)
Power Automate	Premium	Todas las regiones de Power Automate excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)

Contacto
Nombre	SerpApi
URL	https://serpapi.com
Email	support@serpapi.com

Metadatos del conector
Publicador	SerpApi
Sitio web	https://serpapi.com
Directiva de privacidad	https://serpapi.com/legal/privacy
Categorías	Sitio web; Business Intelligence

SerpApi

SerpApi es una API de resultados del motor de búsqueda en tiempo real. Controla servidores proxy, CAPTCHAs y análisis para que los flujos de Power Apps y Power Automate reciban JSON limpios y estructurados sin administrar ninguna infraestructura de extracción.

Publisher: SerpApi

Prerequisites

• Una cuenta de SerpApi. Regístrese en serpapi.com.
• Clave de API de SerpApi válida. Los planes gratuitos incluyen 250 búsquedas al mes. Los planes de pago están disponibles para un mayor volumen.

Operaciones admitidas

Google Search (GoogleSearch)

Recupere los resultados estructurados de Google Search para una consulta determinada. Devuelve resultados orgánicos, anuncios, entradas de gráfico de conocimiento, preguntas relacionadas, resultados locales, historias principales, etc. Los campos exactos devueltos dependen de la consulta y de las superficies de Google.

Obtener ubicaciones (GetLocations)

Devuelve una lista de ubicaciones geográficas admitidas que se pueden pasar al location parámetro de una búsqueda. Úselo para buscar la cadena de ubicación exacta de una ciudad o región antes de ejecutar una búsqueda.

Obtener información de la cuenta (GetAccount)

Devuelve información sobre la cuenta de SerpApi, incluido el plan actual, la cuota de búsqueda mensual, las búsquedas restantes y las estadísticas de uso por hora.

Obtención de credenciales

1. Inicie sesión en su cuenta de SerpApi en serpapi.com.
2. Vaya a serpapi.com/manage-api-key.
3. Copie la clave de API.
4. Al crear una conexión en Power Apps o Power Automate, pegue la clave de API en el campo Clave de API.

Power Platform almacena la clave de API de forma segura e inserta automáticamente en cada solicitud. No tendrá que volver a proporcionarlo después de configurar la conexión.

Getting Started

Uso básico

La GoogleSearch acción realiza un argumento necesario (la consulta de búsqueda) y un registro opcional de parámetros adicionales:

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

Para mostrar la respuesta JSON sin formato en un control de texto HTML para la depuración:

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

Pasar parámetros opcionales

Los parámetros opcionales se pasan como un registro (el segundo argumento). Incluya solo los parámetros que desea establecer; si se omite una clave, no se envía nada para ese parámetro, lo que permite que SerpApi use su propio valor predeterminado.

En el ejemplo siguiente, los tipos y nombres de entrada son recomendaciones, no obligatorias.

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

Asignación de tipos de control:

Tipo de parámetro	Control de Power Apps recomendado	Referencia de valor
Texto (cadena)	Entrada de texto	controlName.Text
Boolean	Alternar o casilla	controlName.Value
Enumeración (opciones fijas)	Lista desplegable	controlName.Selected.Value
Number	Entrada de texto	controlName.Text

Acceso a datos de respuesta

La respuesta es un objeto JSON. Acceda directamente a las propiedades de nivel superior de la variable:

varJsonResponse.search_information.total_results

Para enlazar una galería a los resultados orgánicos:

varJsonResponse.organic_results

Para enlazar una galería a los resultados empresariales locales:

varJsonResponse.local_results.places

Consulte la documentación de SerpApi Google Search para obtener la lista completa de campos de respuesta.

Búsqueda de una cadena de ubicación válida

Use GetLocations para buscar el nombre exacto de la ubicación que se va a pasar a GoogleSearch. El q parámetro filtra por nombre de ciudad o región y limit limita el número de resultados devueltos.

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

Para enlazar los resultados a una Galería:

varLocations

Cada elemento de la colección tiene namecampos , canonical_name, country_code, target_type, reachy gps . Pase el canonical_name valor como parámetro location en una llamada posterior GoogleSearch :

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

Comprobación del uso de la cuenta

Use GetAccount para recuperar los detalles del plan actual y el uso de cuota. Esto resulta útil para comprobar cuántas búsquedas permanecen antes de alcanzar el límite mensual.

Set(varAccount, SerpApi.GetAccount())

Acceda a campos individuales fuera de la respuesta:

varAccount.plan_searches_left
varAccount.this_month_usage
varAccount.account_rate_limit_per_hour

Consulte la documentación de api de cuenta de SerpApi para obtener la lista completa de campos de respuesta.

Problemas conocidos y limitaciones

• Estructura de respuesta variable: los campos presentes en una respuesta de Google Search dependen de la consulta y de lo que Google devuelve para ella. No todos los campos aparecen en todas las respuestas. Consulte la documentación de SerpApi Google Search para obtener una descripción completa de los posibles campos de respuesta.
• Límites de frecuencia: las solicitudes están sujetas a la cuota mensual y el límite de tarifas por hora del plan SerpApi. Si se supera cualquiera de ellas, se producirá una 429 respuesta de error.
• Resultados almacenados en caché: De forma predeterminada, SerpApi proporciona resultados de su caché para solicitudes duplicadas específicas de cada usuario (hasta 1 hora de antigüedad). Use el no_cache parámetro para forzar un resultado nuevo. Tenga en cuenta que las búsquedas almacenadas en caché no cuentan para la cuota mensual.

Support

Para obtener ayuda con este conector o su cuenta de SerpApi, póngase en contacto con el equipo de soporte técnico de SerpApi:

• Email:contact@serpapi.com
• Chat en directo: disponible el 24/7 en serpapi.com, donde puede hablar directamente con un miembro del equipo de soporte técnico de SerpApi.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado	Parámetros para crear una conexión.	Todas las regiones	No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre	Tipo	Description	Required
Clave de API	securestring	Clave de API de SerpApi. Físelo en https://serpapi.com/manage-api-key	True

Acciones

Búsqueda de Google	Recupere los resultados estructurados de Google Search para una consulta determinada. Devuelve resultados orgánicos, anuncios, gráfico de conocimiento, preguntas relacionadas, historias principales, resultados locales, etc.
Obtener información de la cuenta	Devuelve información sobre la cuenta de SerpApi autenticada, incluidos los detalles del plan, las búsquedas restantes y las estadísticas de uso.
Obtener ubicaciones	Devuelve una lista de ubicaciones geográficas admitidas que se pueden usar con el parámetro location en una búsqueda. Resulta útil para encontrar la cadena de ubicación exacta de una ciudad o región.

Búsqueda de Google

Obtener información de la cuenta

Obtener ubicaciones

Definiciones

Location

Información de la cuenta