L’interface de programmation d’applications (API) est une méthode d’extraction des données brutes de Semrush qui ne nécessite aucune connexion manuelle au logiciel. Semrush propose deux principales options d’API :
- le pack API standard (API Analyse et Projets) ;
- l’API Traffic Analytics.
Cette API est disponible sous forme de module complémentaire avec le forfait Business. Le pack API standard comprend les API Analyse et Projets. En passant au forfait Business, vous pourrez acheter des unités API et générer une clé API. Veuillez noter qu’après cette mise à niveau, votre solde d’unité sera de zéro. Vous devrez acheter un nombre d’unités API adapté à vos besoins. Si des unités sont incluses avec votre forfait et que vous l’interrompez, ces unités seront perdues.
Lorsque vous épuisez vos unités, vous pouvez en racheter sur la page Infos abonnement ou en nous contactant.
Découvrez comment obtenir une API ici.
- L’API Analyse vous permet d’extraire les données de vos rapports d’analyse, y compris :
- L’API Projets vous permet d’extraire les données des campagnes Suivi de position et Audit de site créées dans vos projets.
Il est possible d’obtenir des données pour un sous-dossier et pour un sous-domaine via l’API. Consultez la section Subdomain et Subfolder dans la documentation de l’API pour voir de quels rapports vous pouvez extraire des données.
Les appels aux API Analyse et Projets présentent respectivement un coût exprimé en unités API. Le coût total en unités dépendra du type de requête ou du nombre exact de lignes dans le rapport.
Vous pouvez vérifier votre solde d’unités API soit dans l’onglet Infos abonnement, soit via une requête API gratuite (Solde d’unités API).
Consultez ici la liste complète des rapports Semrush que l’API peut extraire. Vous trouverez votre clé API sur votre page Infos abonnement.
L’API Traffic Analytics n’est disponible que pour les utilisateurs de Semrush disposant d’un abonnement payant. Elle se décline en 2 forfaits :
- API standard : ne fournit que des données synthétiques sur le trafic ;
- API étendue : 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 vous présenteront des estimations relatives au comportement des visiteurs d’un site Web. Il s’agit notamment du nombre de visites mensuelles, de visites uniques et de pages par visite, ainsi que de la durée moyenne des visites, du pourcentage de trafic par type d’appareil (mobile VS ordinateur) et du 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 un maximum de 200 domaines au cours d’une seule requête à l’aide des rapports de synthèse. Ces données vous donnent un aperçu du niveau général d’interactions entre un site Web et les internautes.
Les appels de l’API Traffic Analytics fonctionnent pour les domaines racine, les sous-domaines et les sous-dossiers, à l’exception des rapports Domain Rankings, Audience Insights et Data Accuracy.
API étendue
L’API étendue (description détaillée dans la documentation de l’API) propose 16 différents rapports en plus du rapport Vue d’ensemble du trafic fourni par l’API standard :
- Sources du trafic : décomposition du trafic du site Web en trafic direct, trafic référent, trafic de recherche, trafic sur les réseaux sociaux et trafic payant ;
- Destinations du trafic : là où les utilisateurs se rendent après avoir accédé au domaine que vous examinez ;
- Répartition géographique : les pays, régions ou sous-continents d’où proviennent la plupart des visiteurs d’un site Web ;
- Sous-domaines : les sous-domaines du site Web qui attirent le plus de trafic ;
- Pages principales : le nombre de vues uniques, de visiteurs uniques, d’entrées et de sources de trafic pour les 1000 pages les plus consultées d’un site sur la base de son trafic ;
- Classement des domaines : sites les mieux classés dans le lieu et pour la période ciblés, ordonnés par volume de trafic ;
- Renseignements sur l’audience : autres domaines visités, audience unique, audience commune et pourcentage d’audience commune pour les domaines 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, lieu, type d’appareil).
La limite mensuelle par défaut est de 10 000 requêtes. Les unités TA API seront renouvelées le jour du paiement de votre abonnement. Cette API n’utilise aucune unité API du pack API standard de Semrush dans le cadre d’un forfait Business.
Si vous souhaitez bénéficier de notre API Traffic Analytics, vous pouvez y accéder via la page Infos abonnement.
Vous pouvez également nous contacter à l’adresse sales@semrush.com et nous vous fournirons un devis adapté à vos besoins.
Pour acheter l’API Traffic Analytics, vous devez disposer d’un compte Semrush payant. Vous pouvez acheter l’accès à l’API vous-même ou en passant par nos agents commerciaux. Vous recevrez votre clé API par e-mail.
Vous trouverez dans les pages de documentation de l’API le détail et l’explication de tous les appels possibles. Vous y trouverez également le formatage adéquat qui vous permettra de structurer correctement vos appels à l’API. Pour les effectuer, il suffit de coller votre appel à l’API dans un navigateur Web.
Cliquez sur les liens ci-dessous pour accéder à la documentation sur l’API :
- Présentation de l’API
- Conditions d’utilisation de l’API
- API Analyse (Analyse du domaine, Analyse des mots clés, Analyse des backlinks, etc.)
- API Projets (Suivi de position, Audit de site)
- Solde d’unités API
- Documentation de l’API Traffic Analytics
Veuillez noter que, conformément à la section 2.3 de nos conditions d’utilisation, vous ne pouvez pas envoyer plus de 10 requêtes par seconde à notre API :
En souscrivant à l’API Semrush, vous acceptez, outre les restrictions susmentionnées, (i) de ne pas envoyer plus de 10 requêtes par seconde depuis une même adresse IP ou plus de 10 requêtes simultanées depuis un même utilisateur ; et (ii) de ne pas mettre en cache les informations reçues par nos Services pendant plus d’un (1) mois sans le consentement explicite et écrit de Semrush. Vous ne devez pas utiliser les Services si les lois du pays dans lequel vous résidez ou à partir duquel vous accédez aux Services ou les utilisez en interdisent la réception ou le recours.
Pour en savoir plus sur les principes de base des API et leur utilité, ne manquez pas de consulter notre article de blog Mais qu’est-ce qu’une API et comment l’utiliser ?