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) ;
- API .Trends
Cette API est disponible en complément du forfait Business. L'option 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 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 est disponible uniquement pour les utilisateurs d’un forfait Semrush payants et se décline en 2 forfaits :
- l’API .Trends standard, qui 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.
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 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 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 l’option API standard disponible avec le forfait Business.
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
- 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 .Trends
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.