Résultats de recherche Google
Donnez un mot-clé et des filtres de recherche optionnels pour obtenir les listes Google publiques avec rang, extrait, liens et fonctionnalités de page.
Traduit · fr-FRVoir le texte original
Aperçu
La recherche Google est l’endroit où l’on décide quelle page ouvrir : le titre, l’extrait, l’URL visible et la place sur la page. Cette application transforme un mot-clé de recherche public en tableau structuré de ces listes, pour que le SEO, la marque et la veille concurrentielle partent des mêmes résultats qu’un internaute.
Chaque ligne garde le mot-clé à côté de la liste, afin que les comparaisons restent liées à la requête. Annonces, aperçus IA, questions associées et sitelinks restent dans le même tableau lorsque Google les affiche. C’est un classeur de résultats de recherche, pas une copie d’une page de destination.
Notes sur les données
Chaque ligne est une liste Google publique pour le mot-clé soumis. Résultats organiques, annonces, blocs d’aperçu IA, questions associées et requêtes associées peuvent apparaître en lignes distinctes, distinguées par Type de résultat. Titre du résultat, Extrait, URL affichée, Rang et URL du résultat sont le texte de la page de résultats au moment de la collecte, pas un crawl ultérieur de la page de destination. Collecté le, Nettoyé le et Mis à jour le sont renvoyés sans fuseau horaire. Mot-clé, Mots obligatoires, Région et colonnes similaires répètent les réglages de recherche sur les lignes de la même requête.
La collecte ne couvre pas les résultats connectés, les pages privées ni le corps complet d’une page de destination. Les champs produit payant, aperçu IA, questions associées, requêtes associées et sitelinks sont souvent vides sur les lignes organiques ordinaires.
À quoi ressemble un résultat
Chaque ligne est une liste Google publique.
| Titre du résultat | Extrait | URL du résultat | Mot-clé | Type de résultat | Rang |
|---|---|---|---|---|---|
| Cartier | Movement, fluidity, and color: the new Clash de Cartier creations amplify this distinctive jewelry collection. Shop the collection · Clash de Cartier ring, ... Bracelets Cartier watch collections Rings Necklaces Luxury Sunglasses Collection Luxury Watches for him | https://www.cartier.com/en-us/home | cartier | organic | 1 |
| Clash de Cartier | Discover the Clash de Cartier jewelry collection, where spheres, beads, and clean lines meet in rings, bracelets, and necklaces. | https://www.cartier.com/en-us/jewelry/collections/clash-de-cartier/ | cartier | organic | 2 |
URL affichée, Titre de sitelink 1 et Langue de l’interface sont aussi disponibles lorsque la liste les affiche.
Cas d’usage
- Pour le suivi de rang, groupez les lignes par Mot-clé et lisez Rang, Titre du résultat et URL du résultat pour voir quelles pages occupent les premiers résultats.
- Pour revoir les fonctionnalités SERP, filtrez Type de résultat et comparez Titre de l’annonce, Aperçu IA et Question associée avec le Titre du résultat organique.
- Pour la veille de marque, gardez Mot-clé à côté de URL affichée et Titre du résultat pour voir quels domaines la requête fait réellement apparaître.
- Pour les pages d’atterrissage, ouvrez URL du résultat avec Titre de sitelink 1 et Titre de sitelink 2 afin de reconstruire les cartes publiques que voient les internautes.
Périmètre et limites
Un mot-clé Google par tâche, avec un nombre attendu de 1 à 200. Les résultats reviennent par pages complètes de 10 et peuvent être arrondis. Collecte limitée à 20 pages de résultats Google de 10 résultats. Listings Google publics uniquement.
- Adapté pour
- Lorsque vous avez besoin des listes Google publiques pour un mot-clé, avec titres, extraits, liens et rangs.
- Lorsque vous voulez observer annonces, aperçus IA, questions associées et sitelinks à côté des résultats organiques.
- À ne pas utiliser pour
- Lorsque vous voulez quelques résultats instantanés — cette App s’exécute comme une tâche de collecte en arrière-plan.
- Lorsque vous avez besoin de contenu connecté, privé, ou du corps complet de la page de destination — les résultats couvrent uniquement les listes publiques.
Gestion des échecs
Comportement en cas d'échec et de nouvelle tentative déclaré par le développeur. Nous vous recommandons de l'inclure dans votre prompt système lors de l'intégration.
- 1Si aucune liste n’est renvoyée, raccourcissez le mot-clé ou retirez les limites de date, région, langue et site, puis réessayez.
- 2Réessayez plus tard après une limitation de débit, une indisponibilité temporaire ou un délai dépassé. En cas d’échec d’authentification, vérifiez la clé API configurée dans l’environnement d’exécution.
- 3Renvoyez la même saisie après une tâche échouée ou expirée. Conservez les enregistrements déjà collectés après un succès partiel.
Entrée
Paramètres requis pour appeler cette App, générés à partir de l'input.schema du manifest.json.
- Mot-clé de recherche
keywordRequisstringMot-clé Google à collecter. Chaque tâche accepte un mot-clé de 1 à 512 caractères.Exemplecartier - Nombre attendu de résultats
crawl_numRequisintegerNombre attendu de résultats de recherche, de 1 à 200. Les résultats reviennent par pages complètes de 10, le nombre réel peut donc être arrondi. Une page partielle est tout de même facturée comme 10 résultats.Plage1–200Exemple1 - Mots obligatoires
all_these_wordsFacultatifstringMots qui doivent tous apparaître dans le résultat. Séparez plusieurs mots par des espaces. Laissez vide pour omettre ce filtre. - L’un de ces mots
any_of_these_wordsFacultatifstringMots candidats dont au moins un doit apparaître. Séparez plusieurs mots par des espaces. Laissez vide pour omettre ce filtre. - Mots exclus
none_of_these_wordsFacultatifstringMots qui ne doivent pas apparaître dans le résultat. Séparez plusieurs mots par des espaces. Laissez vide pour omettre ce filtre. - Expression exacte
this_exact_word_or_phraseFacultatifstringMot ou expression qui doit apparaître tel quel. Laissez vide pour omettre ce filtre. - Plage numérique
numbers_ranging_fromFacultatifstringPlage numérique à conserver dans les résultats, par exemple 2024..2026. Laissez vide pour omettre ce filtre. - Type de fichier
file_typeFacultatifstringNe conserver que les résultats de ce type de fichier, par exemple Adobe Acrobat PDF (.pdf). Laissez vide pour omettre ce filtre. - Langue de l’interface
interface_languageFacultatifstringLangue de l’interface Google, par exemple English. Laissez vide pour omettre ce filtre. - Langue des résultats
search_languageFacultatifstringLangue des résultats de recherche, par exemple English. Laissez vide pour omettre ce filtre. - Dernière mise à jour
last_updateFacultatifstringValeur de filtre de dernière mise à jour, par exemple w. Laissez vide pour omettre ce filtre. - Type de recherche
order_typeFacultatifstringValeur du type de recherche, par exemple ALL. Laissez vide pour omettre ce filtre. - Région
regionFacultatifstringRégion à laquelle limiter les résultats, par exemple United States. Laissez vide pour omettre ce filtre. - Site ou domaine
site_or_domainFacultatifstringSite ou domaine auquel limiter la recherche, par exemple instagram.com. Laissez vide pour omettre ce filtre. - Date de début
start_dateFacultatifstringDébut de la plage de dates au format YYYY-MM-DD. Laissez vide pour omettre ce filtre. - Date de fin
end_dateFacultatifstringFin de la plage de dates au format YYYY-MM-DD. Laissez vide pour omettre ce filtre. - Emplacement du mot-clé
terms_appearingFacultatifstringOù le mot-clé doit apparaître, par exemple anywhere in the page. Laissez vide pour omettre ce filtre. - Droits d’usage
usage_rightsFacultatifstringFiltre de droits d’usage, par exemple not filtered by license. Laissez vide pour omettre ce filtre.
Sortie
Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.
- Aperçu IA
aio_contentstringCorps de l’aperçu IA affiché sur la page de résultats - Titre source IA
aio_source_titlestringTitre d’une source citée par l’aperçu IA - Extrait source IA
aio_source_title_descriptionstringExtrait d’une source citée par l’aperçu IA - URL source IA
aio_source_title_urlstringLien de page d’une source citée par l’aperçu IA
Exemple de données
Généré à partir d'output.schema. Les champs sans valeur d'exemple utilisent des espaces réservés structurels.
{
"aio_content": "<aio_content>",
"aio_source_title": "<aio_source_title>",
"aio_source_title_description": "<aio_source_title_description>",
"aio_source_title_url": "<aio_source_title_url>",
"all_these_words": "cartier",
"any_of_these_words": "<any_of_these_words>",
"average_rating": "<average_rating>",
"biz_id": "cartier",
"clean_update_time": "2026-08-25T16:23:21",
"crawl_time": "2026-08-25T16:23:18",
"current_page": "1",
"detail_url": "https://www.cartier.com/en-us/home",
"displayed_url": "www.cartier.com",
"end_date": "<end_date>",
"file_type": "any format",
"has_next_page": "true",
"interface_language": "English",
"keyword": "cartier",
"last_update": "<last_update>",
"none_of_these_words": "<none_of_these_words>",
"numbers_ranging_from": "<numbers_ranging_from>",
"order_type": "all",
"pagination_times": "10",
"paid_product_price": "<paid_product_price>",
"paid_product_provider": "<paid_product_provider>",
"paid_product_title": "<paid_product_title>",
"paid_title_url": "<paid_title_url>",
"partition_day": "2026-08-25",
"people_also_ask_answer": "<people_also_ask_answer>",
"people_also_ask_date": "<people_also_ask_date>",
"people_also_ask_question": "<people_also_ask_question>",
"people_also_ask_title": "<people_also_ask_title>",
"people_also_ask_url": "<people_also_ask_url>",
"rating_count": "<rating_count>",
"region": "any region",
"related_queries_title": "<related_queries_title>",
"related_queries_url": "<related_queries_url>",
"result_description": "Movement, fluidity, and color: the new Clash de Cartier creations amplify this distinctive jewelry collection. Shop the collection · Clash de Cartier ring, ... Bracelets Cartier watch collections Rings Necklaces Luxury Sunglasses Collection Luxury Watches for him",
"result_position": "1",
"result_title": "Cartier",
"result_type": "organic",
"results_per_page": "10",
"search_language": "any language",
"site_link_title_1": "Bracelets",
"site_link_title_2": "Cartier watch collections",
"site_link_title_3": "Rings",
"site_link_title_4": "Necklaces",
"site_link_url_1": "https://www.cartier.com/en-us/jewelry/bracelets/",
"site_link_url_2": "https://www.cartier.com/en-us/watches/collections/",
"site_link_url_3": "https://www.cartier.com/en-us/jewelry/rings/",
"site_link_url_4": "https://www.cartier.com/en-us/jewelry/necklaces/",
"site_or_domain": "<site_or_domain>",
"sr_updated_time": "2026-08-25T16:23:22",
"start_date": "<start_date>",
"task_item": "cartier",
"terms_appearing": "anywhere in the page",
"this_exact_word_or_phrase": "<this_exact_word_or_phrase>",
"usage_rights": "not filtered by license",
"view_count": "<view_count>",
"task_no_data": false
}Intégration
Cette App peut être intégrée via MCP, API, SDK ou export de fichiers — tous les canaux partagent les mêmes capacités et la même tarification. Chaque requête s'authentifie avec l'en-tête Authorization: Bearer à l'aide d'une API Key (longue durée, créée dans la console Data Hub) ; les clients MCP peuvent aussi se connecter via OAuth, sans clé. D'autres options comme la CLI et Skill arrivent bientôt. Cette App s'exécute de manière asynchrone et peut être annulée en cours de route : Après l'annulation, l'exécution s'arrête. Les enregistrements déjà livrés sont conservés et facturés.
Avec MCP (Model Context Protocol), vous pouvez appeler cette App directement depuis des clients IA comme Claude et Cursor. Choisissez votre client et votre mode d'authentification, puis copiez la config ci-dessous.
Config du client
Remplacez la valeur après Bearer par votre API Key longue durée. Fonctionne dans n'importe quel client, en CI ou en environnement sans navigateur.
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/google-search-results",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Laissez l'IA tout configurer pour vous
Vous ne voulez pas modifier les configs à la main ? Copiez le prompt d'installation et collez-le dans n'importe quel client IA — il effectuera la configuration à sa manière. (Le prompt demande à l'IA de vous réclamer votre API Key, afin que les identifiants ne finissent jamais dans l'historique de conversation ni dans des configs partagées.)
detail.access.mcp.composeHint
Tarifs
Facturé selon le nombre d'enregistrements renvoyés avec succès. Les exécutions échouées ne sont pas facturées. Facturé par unités de 10 enregistrements ; toute unité incomplète est arrondie à 10 enregistrements.
Facturé une fois par exécution soumise, quel que soit le nombre d'enregistrements renvoyés.
Plusieurs événements de facturation se cumulent indépendamment. Voir chaque élément pour les détails. Les exécutions échouées ne sont pas facturées.
Voir les créditsEssayer maintenant
Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.