seo/
domain-overview

Obtenez les totaux de recherche Google organiques et payants d’un domaine pour un pays et une langue : mots-clés positionnés, trafic mensuel et son coût publicitaire, tranches de positions et évolutions de classement.

Domain Overview API

Totaux organiques et payants
Tranches de positions 1–100
Marché par pays et langue
5 crédits par requête
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
targetObligatoireDomaine ou sous-domaine à analyser, comme notion.so ; https:// et www. sont retirés, et une URL avec un chemin est refusée.
location_codeFacultatifCode numérique du pays de recherche, comme 2840 pour les États-Unis, valeur par défaut. Utilisez ce champ ou location_name.
location_nameFacultatifNom 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_codeFacultatifCode de langue, comme en, valeur par défaut ; il doit faire partie des langues disponibles dans le pays choisi.
languageFacultatifNom 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.

  1. Envoyez {"target": "notion.so", "location_code": 2840, "language_code": "en"} en POST à /v1/seo/domain-overview.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. 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.

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é.

Explorer d’autres plateformes

Combinez les données SEO avec les données publiques d’autres plateformes sociales prises en charge.

Domain Overview API — FAQ

Domain Overview API est une interface programmatique qui lit les totaux de recherche Google d’un domaine pour un pays et une langue choisis. Elle renvoie les nombres de mots-clés organiques et payants, le trafic mensuel estimé et son coût publicitaire, les positions par tranche ainsi que les nombres de mots-clés nouveaux, en hausse, en baisse et perdus.

Elle mesure le trafic issu de la recherche : estimated_traffic est le nombre mensuel de visites qu’un domaine est censé recevoir des résultats Google sur le marché sélectionné, présenté séparément pour les résultats organiques et payants.

Indiquez le pays avec location_code ou location_name et la langue avec language_code ou language ; la langue doit être proposée dans ce pays. Sans ces champs, la requête utilise les États-Unis et l’anglais.

C’est le coût mensuel estimé, en dollars américains, de l’achat du même trafic via Google Ads, ce qui traduit la visibilité organique en un montant comparable.

Chaque requête couvre un domaine. Pour comparer le trafic et le nombre de mots-clés d’une longue liste, Traffic Estimate API accepte jusqu’à 1 000 domaines à la fois.

Un forfait de 5 crédits par requête, pour un domaine sur un marché.