L’interface de programmation d’application (API) est une méthode d’extraction des données brutes de Semrush sans avoir à se connecter manuellement au logiciel. Semrush propose deux options principales d’API :
- Le pack API standard (API Analyse et API Projets)
- L’API Traffic Analytics
Cette API est disponible en complément du forfait Business. Le pack API standard comprend l’API Analyse et l’API Projets. En passant au forfait Business, vous pourrez acheter des unités API et générer une clé d’API.
Veuillez noter qu’en mettant à niveau votre forfait vers le forfait Business, le nombre d’unités disponible 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 des 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 Traffic Analytics n’est disponible que pour les utilisateurs disposant d’un forfait payant à Semrush et se décline en 2 niveaux :
- Standard : ne fournit que des données synthétiques sur le trafic
- Premium : fournit des données synthétiques sur le trafic ainsi que 16 rapports différents
API standard
Les données de Vue d’ensemble du trafic pourront vous montrer des estimations du comportement des visiteurs d’un site Web. Ces données incluent les visites mensuelles, les visites uniques, les pages par visite, la durée moyenne des visites, le pourcentage de trafic mobile par rapport au trafic sur ordinateur et le taux de rebond.
De la même manière, le rapport Vue d’ensemble de Traffic Analytics permet de comparer jusqu’à 5 domaines à la fois. Vous pouvez extraire ces données pour jusqu’à 200 domaines en une seule demande en utilisant les rapports de synthèse. Ces données vous donnent un aperçu rapide du niveau général d’interaction entre un site Web et ses visiteurs.
Les appels à l’API Traffic Analytics fonctionnent pour le domaine racine, les sous-domaines et les sous-dossiers, à l’exception de Classements de domaine, Renseignements sur l’audience et Précision des données.
API Premium
L’API Premium (détaillée dans la documentation de l’API) offre 16 rapports distincts en plus du rapport Vue d’ensemble du trafic de l’API standard :
- Sources du trafic : le trafic du site Web est réparti en trafic direct, trafic référent, trafic de recherche, trafic social et trafic payant ;
- Destinations du trafic : où les utilisateurs se rendent après avoir visité le domaine en question ;
- Répartition géographique : les pays, régions ou sous-continents d’où proviennent la majorité des visiteurs d’un site Web ;
- Sous-domaines : les sous-domaines du site Web qui reçoivent le plus de trafic ;
- 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 principales d’un site en fonction du trafic ;
- Classements du domaine : 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 ;
- Précision des données : la précision estimée du rapport en fonction de la taille du domaine et des filtres que vous avez appliqués (données historiques, emplacement, appareil).
- Sous-dossiers : les sous-dossiers du site Web qui reçoivent le plus de trafic ;
- Répartition par âge et sexe : le nombre et la part d’utilisateurs masculins et féminins, ainsi que leur répartition par âge ;
- Répartition par ménage : une répartition de l’audience du domaine par la taille du ménage ;
- Répartition par niveau de revenu : le nombre et la proportion des utilisateurs ayant un revenu faible, moyen ou élevé ;
- Répartition par niveau d’études : le nombre et la proportion des utilisateurs ayant fait des études supérieures, universitaires, secondaires ou n’ayant pas fait d’études ;
- Répartition par profession : une répartition de l’audience du domaine par situation professionnelle ;
- Intérêts de l’audience : les principaux centres d’intérêts de votre audience cible en fonction des catégories de domaines visités ;
- Réseaux sociaux : 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 Traffic Analytics seront actualisées tous les mois, le jour du paiement de votre forfait. Cette API n’utilise pas les mêmes unités que le pack API standard disponible avec le forfait Business.
Pour accéder à l’API Traffic Analytics, 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 Traffic Analytics, 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
- Conditions d’utilisation 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 Traffic Analytics
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.