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ètres | Obligatoire | Description |
|---|---|---|
target | Obligatoire | Domaine obligatoire, sans https:// ni www., par exemple example.com. |
location_code | Facultatif | Code numérique positif du marché de recherche. Le Playground utilise 2840 par défaut. |
location_name | Facultatif | Nom du marché de recherche, facultatif, en alternative à location_code. Lorsqu’il est renseigné, il prévaut sur location_code. |
language_code | Facultatif | Code de langue de recherche de 2 à 10 caractères. Le Playground utilise en par défaut. |
language | Facultatif | Nom de la langue de recherche, facultatif, en alternative à language_code. Lorsqu’il est renseigné, il prévaut sur language_code. |
results_limit | Facultatif | Maximum demandé de 1 à 1 000 enregistrements de pages indexées. Il peut y avoir moins de lignes renvoyées. |
offset | Facultatif | Nombre 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.
- 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.
- Envoyez la charge utile en POST à /v1/seo/relevant-pages et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- 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 trueCas 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.
API associées
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.
- Keyword Suggestions API
- Related Keywords API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API