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.
Limite d'appels : au-delà de 300 appels sur une minute glissante, la clé est suspendue pendant une minute. Les appels renvoient alors result à false, avec l'erreur « You have reached the call limit in one minute ».
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. |
Chaque position porte son type de résultat (type ou type_rank) : 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. |
Chaque position porte son type de résultat (type ou type_rank) : 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. L'ID du type est aussi accepté. Récupérez vos types avec la méthode Liste des types de sites. |
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 les types de sites de votre compte (Mes sites, Concurrents, A surveiller ou vos propres libellés), avec leur couleur et le nombre de sites rattachés (nb_entities). Le type sert au paramètre type de Créer un site.
Modifie le nom d'un type de sites. Les sites rattachés gardent leur type.
| Paramètre | Description |
|---|---|
id_typerequis | ID du type de sites. Vous pouvez obtenir la liste des types avec la méthode Liste des types de sites. |
namerequis | Nouveau nom du type. Il doit être différent de celui de vos autres types. |
Supprime un type de sites. La suppression est refusée tant qu'au moins un site a ce type : changez d'abord le type de ces sites, ou supprimez-les.
| Paramètre | Description |
|---|---|
id_typerequis | ID du type de sites. Vous pouvez obtenir la liste des types avec la méthode Liste des types de sites. |
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. |
volume_historicalfacultatif | Passez true pour ajouter à chaque mot-clé le volume de recherche mensuel des 12 derniers mois, dans un champ volume_historical : une liste de { date: "AAAA-MM", volume }. Exemple : true |
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 |
Chaque position porte son type de résultat (type ou type_rank) : 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 les versions disponibles pour un service : la clé (key) est la valeur du paramètre version de Suivre des mots-clés. Pour Google, chaque version indique aussi le domaine (host) et la langue (name).
| Paramètre | Description |
|---|---|
id_servicefacultatif | Service dont vous voulez les versions. Sans ce paramètre, les versions de Google Search sont retournées.
|
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-chRécupérez la liste des versions avec la méthode Liste des versions. |
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, ou d'une de ses thématiques : 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 |
id_groupfacultatif | Ne retourne que les statistiques de la thématique. Sans ce paramètre, les statistiques portent sur tous les mots-clés du site. Plusieurs thématiques peuvent être demandées en les séparant par des virgules : la réponse contient alors une ligne par date et par thématique, identifiée par son champ id_group. Récupérez vos thématiques avec la méthode Liste des thématiques. Exemple : 12,34 |
Retourne, pour chaque mot-clé d'un projet et sur la période choisie, le nombre de jours où Google a affiché un AI Overview (days_ai_overview), et pour chaque site suivi le nombre de jours où il y est cité (days_cited), avec le détail par bloc : panneau de sources (days_panel), citations (days_citation) et sources de citation (days_citation_source). Les mots-clés sans AI Overview sont retournés avec days_ai_overview à 0. Un appel suffit pour tout le projet, sans passer par rank/get mot-clé par mot-clé. Consomme une unité par mot-clé.
| Paramètre | Description |
|---|---|
id_projectfacultatif | ID du projet. Obligatoire si id_entity n'est pas renseigné. |
id_entityfacultatif | ID d'un site suivi : seules ses citations sont retournées. Le projet est alors celui du site, id_project devient facultatif. |
periodrequis | Deux dates, début et fin, au format YYYYMMDD-YYYYMMDD.Exemple : 20260901-20260930 |
id_groupfacultatif | Ne retourne que les mots-clés de la thématique. Récupérez vos thématiques avec la méthode Liste des thématiques. |
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. |
offsetfacultatif | Pagination sur les mots-clés de l'audit : position du premier mot-clé, à partir de 0. À utiliser avec limit. |
limitfacultatif | Pagination : nombre de mots-clés retournés, par exemple 2000. À utiliser avec offset. Sans pagination, tout l'audit est renvoyé en une seule réponse. |
Chaque position porte son type de résultat (type ou type_rank) : 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-chRécupérez la liste des versions avec la méthode Liste des versions. |
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 indique le type de résultat dans la SERP : résultat naturel, publicité, position zéro, AI Overview… rank/get le renvoie en texte dans le champ type (natural, ai_overview_panel…), entity/get dans le champ type_rank, préfixé par type_ (type_natural, type_ai_overview_panel…). Le numéro sert aux paramètres qui filtrent par type, comme rank_type de filter/create ou rank_type_all de audit/ranks.
1 Résultat naturel · natural2 Publicité (haut) · ads_top3 Publicité (bas) · ads_bottom4 Bloc images · bloc_image5 Bloc à droite · bloc_right6 Bloc actualités · bloc_news7 Pack local · bloc_maps8 Position zéro · position_zero9 People Also Ask · paa10 Sitelinks · sitelinks11 Bloc shopping · shopping12 Bloc vidéos · videos13 Rechercher des résultats sur · search_result_on14 Sites de lieux · location_sites15 Recettes · recipes16 Résumé visuel · visual_digest17 AI Overview · ai_overview18 AI Overview - Panneau de sources · ai_overview_panel19 AI Overview - Citations · ai_overview_citation20 AI Overview - Sources de citations · ai_overview_citation_sourceLes 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