L’interface de programmation d’application (API) est une méthode d’extraction des données brutes de Semrush ne nécessitant pas de se connecter manuellement au logiciel. Semrush propose deux options principales d’API :
- l’API standard (API Analyse et API Projets) ;
- l’API Trends (données de la Boîte à outils Trafic et marché)
Cette API est disponible en tant que module complémentaire au forfait Business de la Boîte à outils SEO. L’option API standard inclut les API Analyse et Projets. Passer au niveau Business vous donnera la possibilité d’acheter des unités API et de générer une clé API. Notez qu’après la mise à niveau vers un forfait Business, le nombre d’unités sera toujours zéro. En fonction de vos besoins, il vous faudra acheter un certain nombre d’unités API. Le nombre d’unités achetées fera partie de votre forfait récurrent. Si des unités sont incluses dans votre forfait, elles seront renouvelées le même jour que votre forfait. Les unités inutilisées expireront et ne seront pas ajoutées au montant renouvelé.
Lorsque vous manquez d’unités, vous pouvez en acheter davantage depuis la page Infos abonnement ou en nous contactant.
Découvrez comment obtenir une API ici.
-
L’API Analyse vous permet de récupérer des données à partir des rapports d’analyse, y compris :
-
L’API Projets peut extraire des données des campagnes de Suivi de position et d’Audit de site créées dans Projets. Vous pouvez également gérer vos projets (par exemple, créer, mettre à jour ou supprimer vos projets) à l’aide de l’API Projets.
Il est possible d’obtenir les données du sous-dossier, du sous-domaine et de l’URL via l’API. Consulte la section Sous-domaine, Sous-dossier, ou URL dans la documentation de l’API pour savoir depuis quels rapports vous pouvez récupérer des données.
Les appels à l’API Analyse et à l’API Projets ont chacun un coût en unités API. Le montant total d’unités que vous devrez dépenser dépendra du type de demande ou du nombre exact de lignes dans le rapport.
Vous pouvez vérifier le solde de vos unités API soit dans l’onglet Infos abonnement ou via une requête API gratuite (Solde d’unités API).
La liste complète des rapports Semrush que l’API peut extraire est disponible ici. Votre clé API est affichée sur votre page Infos abonnement.
L’API Trends (données de la boîte à outils Trafic et marché) est uniquement accessible aux utilisateurs disposant d’un forfait Semrush payant et est proposée en deux formules :
- L’API Trends standard fournit un accès à des aperçus du trafic comprenant des métriques de trafic de site Web et des données sur le comportement des utilisateurs.
- l’API Trends Premium, qui inclut tout le contenu du niveau standard, ainsi que 16 types de données supplémentaires pour approfondir votre analyse des dynamiques du marché, des stratégies des concurrents et des flux de trafic Web.
API Trends standard
L’API Trends standard fournit les estimations suivantes en matière de trafic de site Web et de comportement des visiteurs : le nombre de visites mensuelles, de visites uniques et de pages par visite, la durée moyenne des visites, le pourcentage de trafic en provenance d’appareils mobiles et d’ordinateurs, le taux de rebond et la catégorie de domaine.
Vous pouvez extraire ces données de trafic pour un maximum de 200 domaines en une seule demande en utilisant les rapports de synthèse. Ces données vous donnent un aperçu du niveau général d’interactions des internautes avec ces sites Web.
Les appels à l’API Trends standard fonctionnent pour le domaine racine, les sous-domaines et les sous-dossiers, à l’exception des rapports Rang du trafic, Renseignements sur l’audience, et Précision des données.
API Trends Premium
L’API Trends Premium (détails complets dans la documentation de l’API) propose 16 rapports différents en plus des données de Vue d’ensemble du trafic disponibles avec l’API Trends standard.
- Trafic quotidien : volume de visiteurs du site Web recensés sur une base journalière.
- Trafic hebdomadaire : volume de visiteurs du site Web recensés sur une base hebdomadaire.
- Conversions en acheteurs : pourcentage de visiteurs qui réalisent une action souhaitée, telle qu’achat.
- Industry Categories: Les divers secteurs industriels d’où proviennent les visiteurs du site Web.
- Sources du trafic : trafic du site Web réparti entre le trafic direct, le trafic référent, la recherche organique, la recherche payante, les réseaux sociaux (recherche naturelle), les réseaux sociaux (recherche payante), les e-mails et les annonces display.
- Destinations du trafic : où les utilisateurs se rendent après avoir visité le domaine en question.
- Trafic des sous-domaines : les sous-domaines du site Web qui reçoivent le plus de trafic.
- Trafic des sous-dossiers : les sous-dossiers du site Web qui reçoivent le plus de trafic.
- Répartition géographique : les pays, régions ou sous-continents d’où proviennent la majorité des visiteurs du site Web.
- Pages principales : le nombre de pages uniques vues, de visiteurs uniques, d’entrées et de sources de trafic pour un maximum de 1 000 pages les plus performantes du site en matière de trafic.
- Rang du trafic : principaux sites Web à l’emplacement cible pour la période cible triés par trafic.
- Renseignements sur l’audience : domaines visités supplémentaires, audience unique, pourcentage d’audience partagée et audience partagée pour les domaines que vous avez saisis.
- Répartition par âge et par sexe : nombre et part d’utilisateurs masculins et féminins, ainsi que leur répartition par âge.
- Répartition par taille du ménage, par niveau de revenu, par niveau d’études et par profession :
- Répartition par taille du ménage : répartition de l’audience du domaine par taille du ménage ;
- Répartition par niveau de revenus : nombre et proportion des utilisateurs ayant un revenu faible, moyen ou élevé ;
- Répartition par niveau d’études : nombre et proportion des utilisateurs ayant fait des études supérieures, universitaires, secondaires ou n’ayant pas fait d’études ;
- Répartition par profession : répartition de l’audience du domaine par situation professionnelle.
- Intérêts de l’audience : les principaux centres d’intérêt de votre audience cible en fonction des catégories de domaines visités.
- Réseaux sociaux préférés : les plateformes de réseaux sociaux les plus visitées par l’audience du marché.
Le taux limite mensuel inclus par défaut est de 10 000 requêtes. Les unités de l’API Trends sont renouvelées chaque mois à la date de paiement de votre forfait. Cette API n’utilise aucune des unités API associées à l’option API standard incluse dans le forfait Business de la boîte à outils SEO.
Pour accéder à l’API Trends, rendez-vous sur la page « Infos abonnement ».
Vous pouvez également contacter notre équipe commerciale via ce formulaire pour recevoir un devis adapté à vos besoins.
Pour acheter l’API Trends, vous devez disposer d’un forfait Semrush payant. Vous pouvez acheter l’accès à l’API vous-même ou via nos représentants commerciaux. Vous obtiendrez ensuite votre clé d’API par e-mail.
Les pages de documentation de l’API ci-dessous sont essentielles pour une bonne utilisation de l’API. Chaque appel y est décomposé et expliqué. Le format correct sera également affiché afin que vous puissiez structurer correctement vos appels à l’API. Ces appels peuvent être effectués en collant votre appel à l’API dans un navigateur Web.
Veuillez utiliser les liens de documentation suivants pour de l’aide au sujet de l’API :
- Récapitulatif de l’API
- API Analyse (Analyse de domaine, Analyse de mots clés, Backlinks, etc)
- API Projets (Suivi de position, Audit de site)
- Solde d’unités API
- Documentation sur l’API Trends
- Conditions d’utilisation de l’API
Veuillez noter que dans la section 2.3 de nos conditions d’utilisation, nous vous demandons de ne pas effectuer plus de 10 requêtes par seconde à partir de notre API :
En souscrivant à l’API Semrush, en plus des restrictions énoncées ci-dessus, vous acceptez (i) de ne pas transmettre plus de 10 requêtes par seconde à partir d’une adresse IP unique ou plus de 10 requêtes simultanées à partir d’un utilisateur ; et (ii) de ne pas mettre en cache les informations reçues des services pendant plus d’un (1) mois sans le consentement écrit de Semrush. Vous ne pouvez pas utiliser les Services si vous êtes légalement empêché de les recevoir ou de les utiliser en vertu des lois du pays dans lequel vous résidez ou à partir duquel vous accédez ou utilisez les Services.
N’hésitez pas à consulter notre article de blog Qu’est-ce que l’API et comment l’utiliser ? pour en savoir plus sur les bases des API et comment elles peuvent vous être utiles.