Domain Overview
L’empreinte de recherche d’un domaine correspond à sa présence dans les résultats Google pour un pays et une langue, résumée par le nombre de mots-clés sur lesquels il se classe, les visites mensuelles que ces positions sont censées lui apporter et ce que ce trafic coûterait en publicité, le tout réparti entre organique et payant et ventilé en tranches de positions de 1 à 100, avec les nombres de classements nouveaux, en hausse, en baisse et perdus. Une seule ligne de ces totaux permet de mesurer un concurrent, de qualifier un prospect selon sa présence dans la recherche et, conservée mois après mois, de suivre l’évolution de la visibilité de votre propre site.
Fonctionnalités de la Domain Overview API
- Un domaine sur un marché Googletarget reçoit un domaine, et les paramètres de pays et de langue choisissent le marché des résultats de recherche, États-Unis et anglais par défaut ; la ligne reprend location_code et language_code pour que les relevés stockés restent identifiés.
- Organique et payant sous la même formeorganic et paid portent chacun le même ensemble de totaux, ce qui permet de comparer champ par champ les positions non payantes et les annonces sur le Réseau de Recherche.
- Le trafic avec sa valeur publicitairekeywords_count compte les mots-clés positionnés, estimated_traffic donne les visites mensuelles qu’ils apportent et estimated_traffic_cost chiffre ce trafic en dollars américains aux tarifs de Google Ads.
- Douze tranches de positionspositions répartit les mots-clés positionnés entre pos_1, pos_2_3, pos_4_10 et d’autres tranches jusqu’à pos_91_100, pour voir si un domaine occupe la première page ou se situe plus loin dans les résultats.
- Évolution des positions depuis la dernière mise à journew_count, up_count, down_count et lost_count indiquent combien de mots-clés sont entrés dans le classement, y ont progressé, reculé ou en sont sortis depuis la mise à jour précédente des données.
Paramètres de la Domain Overview API
| Paramètres | Obligatoire | Description |
|---|---|---|
target | Obligatoire | Domaine ou sous-domaine à analyser, comme notion.so ; https:// et www. sont retirés, et une URL avec un chemin est refusée. |
location_code | Facultatif | Code numérique du pays de recherche, comme 2840 pour les États-Unis, valeur par défaut. Utilisez ce champ ou location_name. |
location_name | Facultatif | Nom du pays, comme United States, à la place de location_code ; si les deux sont envoyés, ils doivent désigner le même pays. |
language_code | Facultatif | Code de langue, comme en, valeur par défaut ; il doit faire partie des langues disponibles dans le pays choisi. |
language | Facultatif | Nom de la langue, comme English, à la place de language_code ; si les deux sont envoyés, ils doivent concorder. |
Comment utiliser la Domain Overview API
Envoyez un domaine avec son marché et lisez la ligne de synthèse à la fin de la tâche.
- Envoyez {"target": "notion.so", "location_code": 2840, "language_code": "en"} en POST à /v1/seo/domain-overview.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez l’unique ligne de synthèse dans results.items ; results.next_cursor ne compte que lorsque has_more vaut true.
curl -X POST "https://api.socq.ai/v1/seo/domain-overview" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"notion.so","location_code":2840,"language_code":"en"}'
# One market per request, 5 credits.Cas d’usage de la Domain Overview API
- Mesurer la présence d’un concurrent dans la recherche : Lisez organic.keywords_count et organic.estimated_traffic pour voir quelle part d’un marché un rival atteint déjà via Google.
- Suivre votre propre visibilité mois par mois : Enregistrez chaque mois les tranches de positions et les nombres new, up, down et lost pour voir si vos positions progressent vers la première page.
- Qualifier les prospects d’une agence : Utilisez organic.estimated_traffic_cost comme montant en dollars de la valeur du trafic de recherche d’un prospect pour décider quels comptes démarcher.
- Vérifier si un site achète des annonces de recherche : paid.keywords_count et paid.estimated_traffic montrent si un domaine diffuse des annonces sur le Réseau de Recherche de Google dans ce marché, et combien de trafic elles lui apportent.
- Comparer un même site d’un pays à l’autre : Envoyez le même domaine avec différents réglages de pays et de langue pour voir sur quels marchés il est le plus fort.
Conseils d’expert pour la Domain Overview API
- Pour un pays où l’anglais n’est pas proposé, renseignez vous-même language_code ou language, car la valeur par défaut en n’est acceptée que là où le pays propose l’anglais.
- Additionnez pos_1, pos_2_3 et pos_4_10 pour obtenir le nombre de mots-clés en première page, puisque les tranches sont des intervalles distincts qui ne se chevauchent pas.
- Lisez les nombres new, up, down et lost comme des évolutions depuis la mise à jour précédente des données, et non depuis votre dernière requête, et stockez chaque ligne avec collected_at pour constituer votre propre historique.
- Envoyez le domaine nu ; pour des chiffres sur les pages individuelles du site, utilisez Relevant Pages API, qui donne la répartition des positions page par page.
API associées
En complément de la Domain Overview API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques SEO.
- Google Organic SERP API — Récupérez une page de résultats Google en direct par requête et marché, avec destinations, positions, types d’éléments et détail complet des résultats normalisés.
- Keyword Difficulty API — Comparez la difficulté de classement organique d’un lot de mots-clés soumis et obtenez chaque mot-clé disponible avec son score normalisé.
- Keyword Overview API — Enrichissez un lot de mots-clés soumis avec la demande, la concurrence payante, la difficulté, les recherches mensuelles et l’intention de recherche disponibles.
- Ranked Keywords API — Trouvez les mots-clés sur lesquels se classe un domaine, un sous-domaine ou une page, avec URL correspondantes, positions, mesures de recherche, intention et éléments sources complets.
- Competitor Domains API — Trouvez les domaines classés sur les mêmes mots-clés Google qu’un site dans un marché, avec nombre de mots-clés communs, position moyenne, trafic sur ce recoupement et totaux de recherche complets.
- Traffic Estimate API — Estimez les visites mensuelles de recherche Google organiques et payantes et le nombre de mots-clés de jusqu’à 1 000 domaines sur un marché.
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API