seo/
relevant-pages

Dressez l’inventaire des pages indexées d’un domaine, avec URL des pages, répartition des classements, trafic de recherche modélisé et contexte de coût de la recherche payante dans des enregistrements normalisés.

Relevant Pages API

Visibilité des pages
Répartition des classements
Estimations de trafic
0,15 crédit par résultat
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

Relevant Pages

Les pages pertinentes sont des URL indexées dotées d’une visibilité mesurable dans la recherche organique ou payante, avec leur nombre de mots-clés, leurs tranches de positions, leur trafic modélisé, leurs coûts estimés et leurs signaux d’évolution. Ces mesures au niveau de la page servent à dresser des inventaires de visibilité, à comparer des empreintes, à examiner la valeur du trafic et à analyser des instantanés répétés.

Fonctionnalités de la Relevant Pages API

  • Inventaire des pages au niveau du domaineRenvoie les URL absolues des pages d’un domaine qui ont une pertinence organique ou payante mesurable dans l’index de recherche choisi.
  • Répartition des classements organiquesConserve les nombres de mots-clés organiques par tranche de position, avec les nombres de classements nouveaux, en hausse, en baisse et perdus lorsqu’ils sont exposés.
  • Empreinte dans la recherche payanteExpose pour chaque page les nombres de mots-clés payants, les plages de positions, le trafic modélisé et le coût estimé du trafic payant, lorsqu’ils sont disponibles.
  • Objets de métriques de page completsGarde dans extra les mesures imbriquées organiques, payantes et autres mesures variables au niveau de la page, tout en normalisant l’URL de la page pour une identification stable.

Paramètres de la Relevant Pages API

ParamètresObligatoireDescription
targetObligatoireDomaine obligatoire, sans https:// ni www., par exemple example.com.
location_codeFacultatifCode numérique positif du marché de recherche. Le Playground utilise 2840 par défaut.
location_nameFacultatifNom du marché de recherche, facultatif, en alternative à location_code. Lorsqu’il est renseigné, il prévaut sur location_code.
language_codeFacultatifCode de langue de recherche de 2 à 10 caractères. Le Playground utilise en par défaut.
languageFacultatifNom de la langue de recherche, facultatif, en alternative à language_code. Lorsqu’il est renseigné, il prévaut sur language_code.
results_limitFacultatifMaximum demandé de 1 à 1 000 enregistrements de pages indexées. Il peut y avoir moins de lignes renvoyées.
offsetFacultatifNombre de lignes source à ignorer, en comptant à partir de zéro, avant de collecter la fenêtre de résultats demandée.

Comment utiliser la Relevant Pages API

Envoyez un domaine correctement formaté avec les réglages de marché et une fenêtre source bornée, puis lisez chaque page pertinente dans la tâche asynchrone terminée.

  1. Choisissez un domaine sans https:// ni www., un location_code, un language_code, un results_limit de 1 à 1 000 et un offset supérieur ou égal à 0.
  2. Envoyez la charge utile en POST à /v1/seo/relevant-pages et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. Lisez data.results.items, puis demandez le next_cursor renvoyé tant que has_more reste à true.
curl -X POST "https://api.socq.ai/v1/seo/relevant-pages" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la Relevant Pages API

  • Inventaire des pages visibles dans la recherche : Servez-vous des URL de pages renvoyées pour bâtir un inventaire du domaine limité aux pages ayant une pertinence mesurable dans l’index de recherche.
  • Comparaison d’empreintes organiques : Comparez les nombres de mots-clés organiques, les tranches de classement et les champs d’évolution pour voir comment la visibilité se répartit entre les pages.
  • Examen des pages dans la recherche payante : Utilisez les nombres de mots-clés payants, les plages de positions, le trafic modélisé et le coût estimé pour comparer l’empreinte payante des pages renvoyées.
  • Instantanés de visibilité des pages : Stockez les enregistrements répétés par page_address et par marché pour comparer les répartitions de classement et le trafic modélisé d’une collecte à l’autre.

Conseils d’expert pour la Relevant Pages API

  • Retirez https:// et www. de target avant l’envoi, car cet endpoint attend un domaine et non l’URL complète d’une page.
  • Utilisez l’url renvoyée comme identifiant de la page : text reprend la même URL par défaut et ne contient pas le corps de la page.
  • Gardez target, location_code, language_code, results_limit et offset fixes quand vous comparez des fenêtres de résultats répétées.
  • Voyez dans offset un nombre de lignes source et non un numéro de page, et stockez-le séparément du next_cursor du résultat de tâche.
  • Lisez les mesures organiques et payantes dans extra.metrics, et admettez que des groupes de métriques imbriqués ou des champs isolés puissent être absents.
  • Interprétez etv et estimated_paid_traffic_cost comme des estimations de recherche modélisées, et non comme des statistiques privées ni des revenus observés.

En complément de la Relevant Pages 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.
  • Keyword Search Volume API — Mesurez des mots-clés connus avec le volume de recherche, le CPC, la concurrence payante et l’historique mensuel des recherches disponibles.
  • Keywords for Site API — Générez des mots-clés pertinents pour un site web avec les mesures de demande disponibles, l’historique mensuel, le contexte de marché et les lignes sources complètes.
  • 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.

Explorer d’autres plateformes

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

Relevant Pages API — FAQ

Relevant Pages API est une interface programmatique qui trouve les pages indexées présentant une pertinence de recherche mesurable pour un domaine, sans protocole ni www. Elle renvoie les URL des pages, les répartitions de classement organiques et payantes, le trafic modélisé, les coûts estimés, les nombres d’évolution et les lignes source complètes.

Envoyez un seul domaine, par exemple example.com, sans https:// et sans www. N’envoyez pas l’URL complète d’une page pour cet inventaire de domaine au niveau des pages.

Non. Il renvoie les pages connues de l’index de recherche qui ont une pertinence organique ou payante mesurable ; les pages non indexées et celles sans visibilité mesurable peuvent donc ne pas apparaître.

La ligne source peut inclure les nombres de mots-clés organiques et payants, les tranches de positions, le trafic modélisé, le coût estimé du trafic payant et les nombres d’évolution des classements. Ces valeurs imbriquées restent dans extra.metrics et non dans l’objet metrics normalisé de premier niveau.

Non. etv et les valeurs de coût du trafic sont des estimations de recherche modélisées, et non des statistiques privées, des visites observées ni des mesures de revenus.

Chaque page renvoyée coûte 0,15 crédit SocQ. Un ensemble de résultats vide n’entraîne aucun frais de résultat, et results_limit fournit l’estimation avant requête, non un nombre final garanti.