SerpApi

Résultats du moteur de recherche en temps réel via SerpApi. Scrape Google, Bing, YouTube, Google Scholar, et bien plus encore sans gérer les proxys, CAPTCHAs ou analyseurs. SerpApi gère l’infrastructure afin que vos flux de travail reçoivent un JSON propre et structuré.

Ce connecteur est disponible dans les produits et régions suivants :

Service	Classe	Regions
Copilot Studio	Premium	Toutes les régions Power Automate à l’exception des éléments suivants :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)
Applications logiques	Norme	Toutes les régions Logic Apps , à l’exception des suivantes :      - Régions Azure Government      - Régions Azure Chine      - Us Department of Defense (DoD)
Power Apps	Premium	Toutes les régions Power Apps à l’exception des éléments suivants :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)
Power Automate	Premium	Toutes les régions Power Automate à l’exception des éléments suivants :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)

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

Métadonnées du connecteur
Éditeur	SerpApi
Website	https://serpapi.com
Politique de confidentialité	https://serpapi.com/legal/privacy
Categories	Site internet; Informatique décisionnelle

SerpApi

SerpApi est une API de résultats du moteur de recherche en temps réel. Il gère les proxys, les CAPTCHAs et l’analyse afin que vos flux Power Apps et Power Automate reçoivent des données JSON propres et structurées sans gérer l’infrastructure de récupération.

Publisher : SerpApi

Prerequisites

• Un compte SerpApi. Inscrivez-vous à serpapi.com.
• Clé API SerpApi valide. Les offres gratuites incluent 250 recherches par mois. Les plans payants sont disponibles pour un volume plus élevé.

Opérations prises en charge

Google Search (GoogleSearch)

Récupérez les résultats de recherche Google structurés pour une requête donnée. Retourne des résultats organiques, des annonces, des entrées de graphique de connaissances, des questions connexes, des résultats locaux, des articles principaux, etc. Les champs exacts retournés dépendent de la requête et de la surface de Google pour celle-ci.

Obtenir des emplacements (GetLocations)

Retourne une liste d’emplacements géographiques pris en charge qui peuvent être passés au location paramètre d’une recherche. Utilisez cette option pour rechercher la chaîne d’emplacement exacte d’une ville ou d’une région avant d’exécuter une recherche.

Obtenir des informations sur le compte (GetAccount)

Retourne des informations sur votre compte SerpApi, notamment votre plan actuel, le quota de recherche mensuel, les recherches restantes et les statistiques d’utilisation horaire.

Obtention des informations d’identification

1. Connectez-vous à votre compte SerpApi à serpapi.com.
2. Accédez à serpapi.com/manage-api-key.
3. Copiez votre clé API.
4. Lorsque vous créez une connexion dans Power Apps ou Power Automate, collez votre clé API dans le champ Clé API.

Votre clé API est stockée en toute sécurité par Power Platform et injectée automatiquement dans chaque requête. Vous n’aurez pas besoin de le fournir une fois la connexion configurée.

Getting Started

Utilisation de base

L’action GoogleSearch prend un argument obligatoire (la requête de recherche) et un enregistrement facultatif de paramètres supplémentaires :

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

Pour afficher la réponse JSON brute dans un contrôle de texte HTML pour le débogage :

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

Passage de paramètres facultatifs

Les paramètres facultatifs sont passés en tant qu’enregistrement (le deuxième argument). Incluez uniquement les paramètres que vous souhaitez définir : omettre une clé n’envoie rien pour ce paramètre, ce qui permet à SerpApi d’utiliser sa propre valeur par défaut.

Dans l’exemple suivant, les types d’entrée et les noms sont des recommandations, et non obligatoires.

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

Mappage de type de contrôle :

Type de paramètre	Contrôle Power Apps recommandé	Référence de valeur
Texte (chaîne)	Entrée de texte	controlName.Text
Boolean	Activer ou cocher	controlName.Value
Énumération (options fixes)	Liste déroulante	controlName.Selected.Value
Number	Entrée de texte	controlName.Text

Accès aux données de réponse

La réponse est un objet JSON. Accédez directement aux propriétés de niveau supérieur hors de la variable :

varJsonResponse.search_information.total_results

Pour lier une galerie aux résultats organiques :

varJsonResponse.organic_results

Pour lier une galerie à des résultats d’entreprise locaux :

varJsonResponse.local_results.places

Reportez-vous à la documentation serpApi Google Search pour obtenir la liste complète des champs de réponse.

Recherche d’une chaîne d’emplacement valide

Permet GetLocations de trouver le nom exact de l’emplacement à passer à GoogleSearch. Le q paramètre filtre par nom de ville ou de région et limit limite le nombre de résultats retournés.

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

Pour lier les résultats à une galerie :

varLocations

Chaque élément de la collection a name, , canonical_namecountry_code, target_type, reachet gps les champs. Transmettez la canonical_name valeur en tant que location paramètre dans un appel suivant GoogleSearch :

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

Vérification de l’utilisation du compte

Permet GetAccount de récupérer les détails de votre plan actuel et l’utilisation du quota. Cela est utile pour vérifier le nombre de recherches qui restent avant d’atteindre votre limite mensuelle.

Set(varAccount, SerpApi.GetAccount())

Accédez aux champs individuels hors de la réponse :

varAccount.plan_searches_left
varAccount.this_month_usage
varAccount.account_rate_limit_per_hour

Reportez-vous à la documentation de l’API compte SerpApi pour obtenir la liste complète des champs de réponse.

Problèmes connus et limitations

• Structure de réponse variable : les champs présents dans une réponse Google Search dépendent de la requête et de ce que Google retourne pour lui. Tous les champs n’apparaissent pas dans chaque réponse. Reportez-vous à la documentation serpApi Google Search pour obtenir une description complète des champs de réponse possibles.
• Limites de débit : les demandes sont soumises au quota mensuel et à la limite horaire de votre plan SerpApi. Le dépassement de l’une ou l’autre entraîne une 429 réponse d’erreur.
• Résultats mis en cache : Par défaut, SerpApi fournit les résultats de son cache pour les requêtes en double spécifiques à chaque utilisateur (jusqu’à 1 heure). Utilisez le no_cache paramètre pour forcer un nouveau résultat. Notez que les recherches mises en cache ne comptent pas vers votre quota mensuel.

Support

Pour obtenir de l’aide sur ce connecteur ou votre compte SerpApi, contactez l’équipe du support technique SerpApi :

• Email :contact@serpapi.com
• Conversation en direct : Disponible 24/7 à serpapi.com, où vous pouvez parler directement avec un membre de l’équipe du support technique SerpApi.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut	Paramètres de création de connexion.	Toutes les régions	Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom	Catégorie	Description	Obligatoire
Clé API	securestring	Votre clé API SerpApi. Trouvez-le à https://serpapi.com/manage-api-key	True

Actions

Obtenir des emplacements	Retourne une liste d’emplacements géographiques pris en charge qui peuvent être utilisés avec le paramètre d’emplacement dans une recherche. Utile pour trouver la chaîne d’emplacement exacte d’une ville ou d’une région.
Obtenir des informations sur le compte	Retourne des informations sur le compte SerpApi authentifié, notamment les détails du plan, les recherches restantes et les statistiques d’utilisation.
Recherche Google	Récupérez les résultats de recherche Google structurés pour une requête donnée. Retourne des résultats organiques, des publicités, un graphique de connaissances, des questions connexes, des articles principaux, des résultats locaux, etc.

Obtenir des emplacements

ID d’opération :

GetLocations

Retourne une liste d’emplacements géographiques pris en charge qui peuvent être utilisés avec le paramètre d’emplacement dans une recherche. Utile pour trouver la chaîne d’emplacement exacte d’une ville ou d’une région.

Paramètres

Nom	Clé	Obligatoire	Type	Description
Terme de recherche	q		string	Nom de la ville ou de la région pour filtrer la liste des emplacements disponibles (par exemple Austin).
Limit	limit		integer	Nombre maximal d’emplacements à retourner.

Retours

response

array of Location

Obtenir des informations sur le compte

ID d’opération :

GetAccount

Retourne des informations sur le compte SerpApi authentifié, notamment les détails du plan, les recherches restantes et les statistiques d’utilisation.

Retours

Informations sur le compte SerpApi authentifié.

Corps

AccountInfo

Recherche Google

ID d’opération :

GoogleSearch

Récupérez les résultats de recherche Google structurés pour une requête donnée. Retourne des résultats organiques, des publicités, un graphique de connaissances, des questions connexes, des articles principaux, des résultats locaux, etc.

Paramètres

Nom	Clé	Obligatoire	Type	Description
Requête de recherche	q	True	string	Requête de recherche. Prend en charge tous les opérateurs standard (par exemple, site :, inurl :, intitle :) et les paramètres avancés tels que as_dt et as_eq.
Location	location		string	Emplacement à partir duquel la recherche provient. Spécifiez au niveau de la ville une meilleure précision (par exemple Austin, Texas). Impossible d’utiliser avec des paramètres uule, lat ou lon. https://serpapi.com/locations-api Consultez les emplacements pris en charge.
Emplacement encodé (UULE)	uule		string	Chaîne d’emplacement encodée de Google. Utilisez comme alternative au paramètre d’emplacement pour la géolocalisation précise. Impossible d’utiliser avec l’emplacement, le lat, le lon ou le rayon.
Latitude	lat		number	Latitude GPS pour l’origine de la recherche. Obligatoire lors de l’utilisation du paramètre lon. Impossible d’utiliser avec l’emplacement ou l’uule.
Longitude	lon		number	Longitude GPS pour l’origine de la recherche. Obligatoire lors de l’utilisation du paramètre lat. Impossible d’utiliser avec l’emplacement ou l’uule.
Rayon (mètres)	radius		integer	Distance en mètres à l’intérieur de laquelle biaiser les résultats de la recherche. Les résultats de cette région sont classés plus hauts. Peut être utilisé en même temps que l’emplacement ou lat/lon. Rayon maximal : 199 m sur bureau ; 1000 m sur tablette ou mobile. Impossible d’utiliser avec uule.
Domaine Google	google_domain		string	Domaine Google à utiliser (par exemple, google.com, google.co.uk, google.fr). La valeur par défaut est google.com. Consultez https://serpapi.com/google-domains la liste complète.
Country	gl		string	Code pays à deux lettres pour la recherche (par exemple, nous, gb, fr, de). Consultez https://serpapi.com/google-countries la liste complète.
Language	hl		string	Code de langue d’interface à deux lettres (par exemple, en, es, fr, de). Consultez https://serpapi.com/google-languages la liste complète.
Restriction du pays	cr		string	Restreindre les résultats aux documents provenant de pays spécifiques. Utiliser le format country{CODE} avec | en tant que délimiteur (par exemple, countryFR|countryDE).
Restriction de langue	lr		string	Limitez les résultats à des langues spécifiques. Utiliser le format lang_{code} avec | comme délimiteur (par exemple, lang_fr|lang_de).
Filtre de recherche avancée	tbs		string	Filtre de recherche avancé (à rechercher). Active le filtrage par plage de dates, type de contenu et bien plus (par exemple, qdr :d pour le jour passé, qdr :w pour la semaine précédente).
Filtre adulte	safe		string	Niveau de filtrage de contenu pour adultes. Définissez la valeur active pour activer le filtrage ou désactivez-le pour le désactiver.
Exclure les résultats corrigés automatiquement	nfpr		integer	Définissez la valeur 1 pour exclure les résultats des requêtes corrigées automatiquement lorsque la requête d’origine est mal orthographié. Définissez la valeur 0 pour les inclure (par défaut).
Filtre de contenu en double	filter		integer	Contrôle les filtres résultats similaires et les filtres de résultats omis. Définissez la valeur 1 pour activer (par défaut) ou 0 pour désactiver.
Type de recherche	tbm		string	Type de recherche Google à effectuer (à mettre en correspondance). Omettez une recherche web régulière.
Décalage de résultat	start		integer	Décalage de pagination. Ignore le nombre de résultats donné. 0 retourne la première page, 10 retourne la deuxième page, etc.
Appareil	device		string	Type d’appareil à simuler. Utilisez le bureau (par défaut), la tablette ou le mobile.
Ignorer le cache	no_cache		boolean	Définissez la valeur true pour forcer un nouveau résultat, en contournant le cache de 1 heure de SerpApi. Les recherches mises en cache sont gratuites et ne comptent pas vers votre quota mensuel. N’utilisez pas avec async.
Mode asynchrone	async		boolean	Définissez la valeur true pour envoyer la recherche et récupérer les résultats ultérieurement via l’API Archive de recherche, plutôt que d’attendre les résultats de manière synchrone. N’utilisez pas avec no_cache.
Format de sortie	output		string	Format de sortie. Définissez sur json (valeur par défaut) pour json structuré ou html pour le code HTML brut. Utilisez html pour le débogage ou pour les types de résultats non encore entièrement pris en charge.
Placer CID	ludocid		string	Google CID (identificateur de client) d’un emplacement spécifique. Trouvé dans les résultats locaux en tant que place_id. Permet de récupérer le graphe de connaissances d’un lieu.
ID du graphe de connaissances	kgmid		string	KGMID d’une entité Google Knowledge Graph. Peut remplacer d’autres paramètres de recherche à l’exception du démarrage.
Signature locale (lsig)	lsig		string	Utilisé pour forcer l’affichage de la carte des graphiques de connaissances pour un emplacement local. Obtenez via l’API Local Pack ou l’API Locale Google.
Paramètres de recherche mis en cache (si)	si		string	Paramètres de recherche chiffrés mis en cache pour les onglets Knowledge Graph. Peut remplacer d’autres paramètres de recherche à l’exception du démarrage.
Extension de disposition (ibp)	ibp		string	Contrôle les expansions de disposition dans les résultats Google (par exemple, gwp ; 0,7).
Filter String (uds)	uds		string	Chaîne de filtre fournie par Google pour le filtrage des résultats.
Zéro trace	zero_trace		boolean	Comptes d’entreprise uniquement. Définissez la valeur true pour ignorer le stockage côté serveur des paramètres de recherche et des métadonnées.

Retours

Nom	Chemin d’accès	Type	Description
search_metadata	search_metadata	object	Métadonnées relatives à la demande de recherche, y compris l’état, le minutage et les identificateurs SerpApi.
search_parameters	search_parameters	object	Les paramètres utilisés pour cette recherche ont fait écho à la requête.
search_information	search_information	object	Informations générales sur la recherche, telles que le nombre total de résultats et le temps nécessaire.
organic_results	organic_results	array of object	Résultats web organiques standard retournés par Google.
items	organic_results	object
Annonces	ads	array of object	Annonces payantes affichées ci-dessus ou inférieures aux résultats organiques.
items	ads	object
knowledge_graph	knowledge_graph	object	Données du panneau Google Knowledge Graph, le cas échéant pour la requête.
related_questions	related_questions	array of object	Les personnes posent également des questions relatives à la requête.
items	related_questions	object
related_searches	related_searches	array of object	Suggestions de recherche associées affichées en bas de la page de résultats.
items	related_searches	object
local_results	local_results	object	Résultats du pack local, présents lorsque la requête a une intention locale.
top_stories	top_stories	array of object	Principales actualités liées à la requête.
items	top_stories	object
pagination	pagination	object	Liens vers les pages suivantes et précédentes des résultats.

Définitions

Location

Emplacement géographique pris en charge à utiliser avec le paramètre de recherche d’emplacement.

Nom	Chemin d’accès	Type	Description
id	id	string	Identificateur unique pour cet emplacement.
nom	name	string	Nom complet de l’emplacement (par exemple Austin, Texas, États-Unis).
canonical_name	canonical_name	string	Nom canonique utilisé dans le paramètre d’emplacement.
country_code	country_code	string	Code de pays ISO à deux lettres.
target_type	target_type	string	Type d’emplacement (par exemple, Ville, Région DMA, Pays).
Atteindre	reach	integer	Estimation du volume de recherche mensuel pour cet emplacement.
Gps	gps	array of number	Coordonnées GPS en tant que [latitude, longitude].

Infos sur le compte

Informations sur le compte SerpApi authentifié.

Nom	Chemin d’accès	Type	Description
account_id	account_id	string	Identificateur unique pour ce compte.
Clé API	api_key	string	Clé API pour ce compte.
account_email	account_email	string	Adresse e-mail associée au compte.
plan_name	plan_name	string	Nom du plan d’abonnement actuel.
plan_monthly_price	plan_monthly_price	number	Prix mensuel du plan actuel en USD.
searches_per_month	searches_per_month	integer	Nombre total de recherches incluses par mois sur le plan actuel.
plan_searches_left	plan_searches_left	integer	Nombre de recherches restantes dans la période de facturation actuelle.
extra_credits	extra_credits	integer	Crédits de recherche supplémentaires achetés en dehors du plan.
account_rate_limit_per_hour	account_rate_limit_per_hour	integer	Nombre maximal de demandes d’API autorisées par heure.
this_month_usage	this_month_usage	integer	Nombre de recherches utilisées jusqu’à présent dans cette période de facturation.
this_hour_searches	this_hour_searches	integer	Nombre de recherches effectuées dans l’heure actuelle.
last_hour_searches	last_hour_searches	integer	Nombre de recherches effectuées à l’heure précédente.