Intégrez les datas dans vos outils ou réalisez des rapports personnalisés.
L'API Monitorank est de type REST et retourne du JSON. Chaque appel est une simple requête HTTP : aucune librairie, aucun SDK, aucun jeton à rafraîchir.
https://api.monitorank.com/Tous les appels sont authentifiés par votre clé d'API, passée dans le paramètre key. Vous la trouvez dans l'application, menu API, où vous pouvez également la renouveler.
Chaque appel consomme des unités d'API, reportées dans le champ units de la réponse. La méthode Ressources sur les 12 prochains mois vous indique ce qu'il vous reste.
Toutes les méthodes retournent un objet JSON construit sur le même modèle.
{"result": true,"data": [{"id_project": 1042,"name": "Mon site"}],"units": 1,"time_execution": 0.041}| Champ | Description |
|---|---|
result | true : l'appel a abouti. false : une erreur est survenue. |
error | Si result vaut false, indique la raison de l'erreur. |
data | Si result vaut true, contient les données retournées. |
units | Nombre d'unités d'API consommées par l'appel. |
time_execution | Temps d'exécution de l'appel, en secondes. |
result vaut false et error décrit la cause : clé invalide, méthode d'écriture désactivée, paramètre manquant ou ressource introuvable.Retourne la liste de vos projets. Les ID des projets sont nécessaires à la plupart des autres méthodes.
Crée un projet. Chaque projet regroupe plusieurs sites et plusieurs suivis de mots-clés.
| Paramètre | Description |
|---|---|
namerequis | Nom du projet. |
topfacultatif | Nombre de résultats récupérés sur Google : 50 ou 100. Le TOP100 est facturé 30 % plus cher. |
Modifie le nom d'un projet.
| Paramètre | Description |
|---|---|
id_projectrequis | ID du projet. Vous pouvez obtenir la liste des projets avec la méthode Liste des projets. |
namerequis | Nouveau nom du projet. |
Supprime un projet.
| Paramètre | Description |
|---|---|
id_projectrequis | ID des projets à supprimer, séparés par des virgules. Récupérez les ID avec la méthode Liste des projets. |
Retourne la liste de vos sites suivis : les vôtres, vos concurrents et ceux que vous surveillez.
| Paramètre | Description |
|---|---|
id_projectfacultatif | ID du projet. Vous pouvez obtenir la liste des projets avec la méthode Liste des projets. |
id_entityfacultatif | Limite le résultat à un seul site. |
Retourne les positions d'un site sur la période de votre choix.
| Paramètre | Description |
|---|---|
id_entityrequis | ID du site. Vous pouvez obtenir la liste des sites avec la méthode Liste des sites. |
periodfacultatif | Deux dates, début et fin, au format YYYYMMDD-YYYYMMDD. Sans période, les 7 derniers jours sont retournés.Exemple : 20260101-20260131 |
id_filterfacultatif | Filtre les données. Récupérez vos filtres avec la méthode Liste des filtres. Si une période est attribuée au filtre, elle est appliquée. |
id_groupfacultatif | Ne retourne que les positions de la thématique. Récupérez vos thématiques avec la méthode Liste des thématiques. |
Les positions retournées portent un rank_type : voir la liste des types de position.
Retourne les positions d'un domaine sur la période de votre choix.
| Paramètre | Description |
|---|---|
urlrequis | Domaine ou URL appartenant à l'un de vos sites. |
periodfacultatif | Deux dates, début et fin, au format YYYYMMDD-YYYYMMDD. Sans période, les 7 derniers jours sont retournés.Exemple : 20260101-20260131 |
id_filterfacultatif | Filtre les données. Récupérez vos filtres avec la méthode Liste des filtres. Si une période est attribuée au filtre, elle est appliquée. |
Les positions retournées portent un rank_type : voir la liste des types de position.
Crée un site dans un projet.
| Paramètre | Description |
|---|---|
namerequis | Nom du site. |
id_projectrequis | ID du projet. Vous pouvez obtenir la liste des projets avec la méthode Liste des projets. |
urlrequis | Un ou plusieurs domaines / adresses, séparés par des virgules. |
typerequis | Type du site : Mes sites, Concurrents ou A surveiller. Si vous avez renommé vos types dans l'application, utilisez vos propres libellés. |
brandfacultatif | Une ou plusieurs marques associées au site, séparées par des virgules. Les marques rattachent au site les citations des AI Overviews de Google qui mentionnent une marque sans lien cliquable, cas où l'URL seule ne permet pas le rattachement. |
Ajoute une ou plusieurs URL à un site existant.
| Paramètre | Description |
|---|---|
id_entityrequis | ID du site. Vous pouvez obtenir la liste des sites avec la méthode Liste des sites. |
urlrequis | Un ou plusieurs domaines / adresses, séparés par des virgules. |
Remplace les marques d'un site existant. Les autres informations du site - nom, URL, type - ne sont pas modifiées.
Les marques rattachent au site les citations des AI Overviews de Google qui mentionnent une marque sans lien cliquable, cas où l'URL seule ne permet pas le rattachement.
| Paramètre | Description |
|---|---|
id_entityrequis | ID du site. Vous pouvez obtenir la liste des sites avec la méthode Liste des sites. |
brandrequis | Une ou plusieurs marques, séparées par des virgules. Pour ajouter une marque à celles déjà en place, renvoyez la liste complète : les anciennes et la nouvelle. |
Modifie le nom d'un site.
| Paramètre | Description |
|---|---|
id_entityrequis | ID du site. Vous pouvez obtenir la liste des sites avec la méthode Liste des sites. |
namerequis | Nouveau nom du site. |
Supprime un site.
| Paramètre | Description |
|---|---|
id_entityrequis | ID des sites à supprimer, séparés par des virgules. |
Supprime une ou plusieurs URL d'un site.
| Paramètre | Description |
|---|---|
id_entityrequis | ID du site. Vous pouvez obtenir la liste des sites avec la méthode Liste des sites. |
urlrequis | Une ou plusieurs URL à supprimer, séparées par des virgules. |
Retourne la liste des mots-clés que vous suivez.
| Paramètre | Description |
|---|---|
id_projectfacultatif | ID du projet. Vous pouvez obtenir la liste des projets avec la méthode Liste des projets. |
Retourne les positions d'un suivi de mot-clé sur la période de votre choix.
| Paramètre | Description |
|---|---|
id_queryrequis | ID du suivi de mot-clé. Récupérez les ID avec la méthode Liste des suivis de positions. |
periodrequis | Deux dates, début et fin, au format YYYYMMDD-YYYYMMDD.Exemple : 20260101-20260131 |
Les positions retournées portent un rank_type : voir la liste des types de position.
Retourne une liste de villes avec leur ID. Cet ID est nécessaire pour géolocaliser un suivi de mots-clés.
| Paramètre | Description |
|---|---|
countryrequis | Code du pays. France : FR - Suisse : CH - Espagne : ES |
zip_codefacultatif | Code postal recherché. Plusieurs valeurs possibles, séparées par des virgules. |
searchfacultatif | Recherche une liste de villes par chaîne de caractères. |
Retourne l'état d'avancement des suivis de positions, projet par projet. Utile pour savoir si les positions du jour sont disponibles avant de les récupérer.
Télécharge la vue SERP d'un mot-clé, au format HTML, PNG ou JPG.
| Paramètre | Description |
|---|---|
id_queryrequis | ID du suivi de mot-clé. Récupérez les ID avec la méthode Liste des suivis de positions. |
outputrequis | Format du fichier retourné.
|
Ajoute des mots-clés au suivi d'un projet. Tous les sites du projet suivent ces mots-clés.
| Paramètre | Description |
|---|---|
id_projectrequis | ID du projet. Vous pouvez obtenir la liste des projets avec la méthode Liste des projets. |
id_servicerequis | Moteur sur lequel suivre les mots-clés.
|
versionrequis | Langue et version du service. Google France : fr-fr - Google Suisse en allemand : de-ch |
keywordsrequis | Mots-clés à suivre, séparés par des virgules. |
grouprequis | Nom de la thématique. Si elle n'existe pas, elle est créée. Plusieurs thématiques possibles, séparées par des virgules. |
devicefacultatif | Supports de suivi, séparés par des virgules. Par défaut : ordinateur.
|
id_locationfacultatif | Géolocalise la recherche, pour toutes les villes mondiales. Plusieurs ID possibles, séparés par des virgules. Obtenez les ID avec la méthode Rechercher une localisation. |
Crée un tag s'il n'existe pas, puis l'associe à des mots-clés.
| Paramètre | Description |
|---|---|
tagrequis | Nom du tag. |
id_queryrequis | ID des suivis de mots-clés, séparés par des virgules. |
colorfacultatif | Couleur du tag, au format RGB. |
Supprime un ou plusieurs suivis de mots-clés.
| Paramètre | Description |
|---|---|
id_queryrequis | ID des suivis de mots-clés, séparés par des virgules. |
Retourne les statistiques d'un site : position moyenne, visibilité et TOP 1 / 3 / 10 / 30 / 100.
| Paramètre | Description |
|---|---|
id_entityrequis | ID du site. Vous pouvez obtenir la liste des sites avec la méthode Liste des sites. |
periodrequis | Deux dates, début et fin, au format YYYYMMDD-YYYYMMDD.Exemple : 20260101-20260131 |
Retourne la liste de vos filtres.
Crée un filtre avec les critères de votre choix. Le filtre peut ensuite être appliqué aux méthodes qui retournent des positions.
| Paramètre | Description |
|---|---|
namerequis | Nom du filtre. |
periodfacultatif | Force une période dans le filtre. Elle s'appliquera automatiquement à chaque utilisation du filtre.
|
devicefacultatif | Filtre les données par support.
|
ranksfacultatif | Type de filtre sur les positions.
|
ranks_minrequis avec ranks | Valeur la plus petite du filtre. |
ranks_maxrequis avec ranks | Valeur la plus grande du filtre. Exemple - nouvelles entrées en TOP 10 : ranks=in&ranks_min=1&ranks_max=10 |
evolutionfacultatif | Type de filtre sur l'évolution.
|
evolution_minrequis avec evolution | Valeur la plus petite du filtre. |
evolution_maxrequis avec evolution | Valeur la plus grande du filtre. Exemple - fortes progressions, au moins 10 places : evolution=up&evolution_min=10&evolution_max=100 |
id_servicefacultatif | Filtre les données par service.
|
id_entityfacultatif | Compare les positions avec d'autres sites. Plusieurs valeurs possibles, séparées par des virgules. |
rank_typefacultatif | Compare vos positions avec d'autres types de position : position zéro, publicités, AI Overviews… Voir la liste des types de position. |
Modifie le nom d'un filtre.
| Paramètre | Description |
|---|---|
id_filterrequis | ID du filtre. Récupérez les ID avec la méthode Liste des filtres. |
namerequis | Nouveau nom du filtre. |
Supprime un filtre. Les positions ne sont pas affectées.
| Paramètre | Description |
|---|---|
id_filterrequis | ID du filtre. Récupérez les ID avec la méthode Liste des filtres. |
Retourne les thématiques de votre compte ou d'un projet.
| Paramètre | Description |
|---|---|
id_projectfacultatif | ID du projet. Vous pouvez obtenir la liste des projets avec la méthode Liste des projets. |
Crée une ou plusieurs thématiques dans un projet.
| Paramètre | Description |
|---|---|
id_projectrequis | ID du projet. Vous pouvez obtenir la liste des projets avec la méthode Liste des projets. |
namerequis | Nom de la thématique. Plusieurs thématiques possibles, séparées par des virgules. |
Modifie le nom d'une thématique.
| Paramètre | Description |
|---|---|
id_grouprequis | ID de la thématique. Vous pouvez obtenir la liste des thématiques avec la méthode Liste des thématiques. |
namerequis | Nouveau nom de la thématique. |
Supprime une thématique. Les mots-clés associés ne sont pas supprimés.
| Paramètre | Description |
|---|---|
id_grouprequis | ID de la thématique. Vous pouvez obtenir la liste des thématiques avec la méthode Liste des thématiques. |
Retourne les audits de votre compte. Un audit à jour a le statut processed.
| Paramètre | Description |
|---|---|
id_projectfacultatif | ID du projet. Vous pouvez obtenir la liste des projets avec la méthode Liste des projets. |
id_auditfacultatif | Limite le résultat à un seul audit. |
Retourne la liste des mots-clés d'un audit.
| Paramètre | Description |
|---|---|
id_auditrequis | ID de l'audit. Vous pouvez obtenir la liste des audits avec la méthode Liste des audits. |
Retourne les positions de toutes les exécutions d'un audit. Un audit à jour a le statut processed.
| Paramètre | Description |
|---|---|
id_auditrequis | ID de l'audit. Vous pouvez obtenir la liste des audits avec la méthode Liste des audits. |
id_entityrequis | ID du site dont vous voulez les positions. |
topfacultatif | Intègre le TOP X de chaque mot-clé, de 1 à 100. |
rank_type_allfacultatif | ID des types de position à intégrer, séparés par des virgules. Voir la liste des types de position. |
last_execfacultatif | Récupère uniquement les positions de la dernière exécution. |
id_execfacultatif | Récupère les positions d'une ou plusieurs exécutions, séparées par des virgules. |
Les positions retournées portent un rank_type : voir la liste des types de position.
Crée un audit dans un projet.
| Paramètre | Description |
|---|---|
id_projectrequis | ID du projet. Vous pouvez obtenir la liste des projets avec la méthode Liste des projets. |
namerequis | Nom de l'audit. |
Ajoute des mots-clés à un audit existant.
| Paramètre | Description |
|---|---|
id_projectrequis | ID du projet. Vous pouvez obtenir la liste des projets avec la méthode Liste des projets. |
id_auditrequis | ID de l'audit. Vous pouvez obtenir la liste des audits avec la méthode Liste des audits. |
id_servicerequis | Moteur sur lequel suivre les mots-clés.
|
versionrequis | Langue et version du service. Google France : fr-fr - Google Suisse en allemand : de-ch |
keywordsrequis | Mots-clés à suivre, séparés par des virgules. |
devicefacultatif | Supports de suivi, séparés par des virgules. Par défaut : ordinateur.
|
id_locationfacultatif | Géolocalise la recherche, pour toutes les villes mondiales. Plusieurs ID possibles, séparés par des virgules. Obtenez les ID avec la méthode Rechercher une localisation. |
Lance l'exécution d'un audit. Une fois terminé, l'audit passe au statut processed.
| Paramètre | Description |
|---|---|
id_auditrequis | ID de l'audit. Vous pouvez obtenir la liste des audits avec la méthode Liste des audits. |
Supprime un audit.
| Paramètre | Description |
|---|---|
id_auditrequis | ID de l'audit. Vous pouvez obtenir la liste des audits avec la méthode Liste des audits. |
Supprime un mot-clé d'un audit.
| Paramètre | Description |
|---|---|
id_auditrequis | ID de l'audit. Vous pouvez obtenir la liste des audits avec la méthode Liste des audits. |
id_queryrequis | ID du mot-clé à supprimer. |
Retourne le nombre de ressources disponibles sur les 12 prochains mois et le nombre de suivis créés.
Retourne la liste des mises à jour d'algorithme annoncées par Google. Pratique pour corréler une variation de positions avec un update.
Valeurs du paramètre id_service, utilisé pour choisir le moteur de recherche.
1 Google Recherche2 Google Images3 Google Actualités4 Google Vidéos12 Google Maps6 Google PlayStore8 YouTube11 Bing Recherche13 Yandex14 BaiduChaque position retournée par l'API porte un rank_type qui indique le type de résultat dans la SERP : résultat naturel, publicité, position zéro, AI Overview…
1 Résultat naturel2 Publicité (haut)3 Publicité (bas)4 Bloc images5 Bloc à droite6 Bloc actualités7 Pack local8 Position zéro9 People Also Ask10 Sitelinks11 Bloc shopping12 Bloc vidéos13 Rechercher des résultats sur14 Sites de lieux15 Recettes16 Résumé visuel18 AI Overview - Panneau de sources19 AI Overview - Citations20 AI Overview - Sources de citationsLes méthodes qui retournent des positions attendent une période au format YYYYMMDD-YYYYMMDD. Les périodes nommées ci-dessous sont utilisables dans un filtre, avec la méthode Créer un filtre.
last_2 Hier / aujourd'huilast_7 7 derniers jourslast_30 30 derniers jourslast_90 90 derniers jourslast_365 365 derniers jourslast_week Semaine précédentelast_month Mois précédentlast_3_month 3 mois précédentslast_12_month 12 mois précédentslast_year Année précédentecurrent_month Mois en courscurrent_year Année en coursValeurs du paramètre device.
1 Ordinateur2 Mobile3 Tablette