Bienvenue dans cet article où nous allons explorer les subtilités de l’utilisation de l’API de Babbar avec Python. Si vous êtes un passionné de SEO, de données et d’exploration approfondie, vous serez enchanté par les possibilités offertes par cet outil puissant.
Aujourd’hui, je vous propose de plonger dans l’univers captivant de l’API de Babbar et de découvrir comment en tirer le meilleur parti en utilisant deux méthodes pratiques :
Première méthode : l’usage des fichiers pour obtenir des csv
La première c’est d’utiliser les fichiers .py présents dans le github via des lignes de commande, c’est assez simple :
Rendez-vous sur https://github.com/BabbarTech/BabbarPy
Cliquez sur « code »
Cliquez sur « download zip »
Déplacez le dossier compressé là où vous allez l’utiliser et décompressez le.
Assurez-vous d’avoir installé python (généralement la dernière version se trouve ici : https://www.python.org/downloads/ )
Sur votre ordinateur, recherchez « cmd » (sur windows) pour ouvrir une invite de commande, ou ouvrez un terminal depuis la mission Control (sur Mac).
Déplacez vous jusqu’au dossier décompressé en ligne de commande avec « cd ».
Exemple : pour moi je peux me déplacer jusqu’à ce dossier en faisant
cd pierredebabbar\codepython\BabbarPy
Mais pour vous c’est peut-être différent, à vous de voir.
Ensuite avant de pouvoir utiliser les codes python, il vous faut faire la commande suivante :
python first_start.py
Attention, cette commande nécessite d’avoir pip installé. Si vous n’avez pas pip, c’est souvent parce que vous n’avez pas installé python depuis python.org). Dans ce cas, je vous invite à regarder ce lien pour l’installer.
Il vous faut ensuite rentrer votre clé API pour Babbar lorsque c’est demandé :
Vous pouvez la créer ici : https://www.babbar.tech/settings#/api
Copiez la clé API qui est générée, et stockez-la : vous ne pourrez plus la revoir après dans l’interface Babbar (mais vous pourrez en générer d’autres).
Attention, votre clé API utilise le rate de votre compte. Si vous avez plusieurs codes avec une ou plusieurs clés APIs qui tournent en simultané, le rate est réparti entre les différents codes.
Collez la clé API dans l’invite de commande lorsqu’elle vous est demandée : clic droit sur Windows et pomme + V sur Mac.
La doc API se trouve ici https://www.babbar.tech/doc-api/
Si vous souhaitez utiliser les exécutables avec python, vous pouvez donc lancer une commande comme suit :
python [nom de la catégorie de la route]\[nom de la fonction].py [nom du fichier (txt ou csv) contenant les informations (host, url, keyword, couples d’urls)]
Par exemple :
python host\h_anchors.py hostsLists.txt
Ou encore :
python url\fi.py coupleUrls.csv
Vous pouvez aussi les lancer les uns à la suite des autres ou en parallèle, mais n’oubliez pas que le rate de l’API est partagé entre le nombre de processus utilisant l’API. (code python, BDA, autres utilisations de l’API).
Les résultats sont des fichiers csv que vous pourrez importer dans excel ou un autre tableur (en général assez facilement : (ouvrez excel : nouvelle feuille > données>Obtenir des données > A partir d’un fichier (texte/csv) > origine (UTF8) + Délimiteur (virgule) > Charger.)
Deuxième méthode : importer le code comme un package Python
La 2e méthode, c’est d’utiliser le code présent dans BabbarPy comme un package python.
Il vous suffit de taper dans votre interface la commande suivante :
pip install git+https://github.com/BabbarTech/BabbarPy.git
Ensuite dans votre code python, vous pouvez exploiter BabbarPy sous forme de modules :
| from BabbarPy import url url.u_anchors(url, api_key) |
| from BabbarPy.url import * u_anchors(url, api_key) |
| import BabbarPy BabbarPy.url.u_anchors(url, api_key) |
etc..
Voici une liste des 56 fonctions existantes :
| Dossier (module python) | Que fait la fonction ? | Fonction (et nom de fichier) | Retour pour vos usages python | Fonction à appeler en python |
|---|---|---|---|---|
| domain | liste les ancres fréquentes vers le domaine renseigné | d_anchors | dictionnaire dans une liste | d_anchors(domain, api_key) |
| domain | liste les tops backlinks du domaine | d_backlinks_url | dictionnaire dans une liste | d_backlinks_url(domain, api_key) |
| domain | donne les scores de duplication au sein d’un domaine | d_duplicate | dictionnaire dans une liste | d_duplicate(domain, api_key) |
| domain | liste les urls connues et crawlées par Babbar | d_fetches | dictionnaire dans une liste | d_fetches(domain, api_key, lang= »fr ») |
| domain | donne le score de santé du domaine | d_health | dictionnaire | d_health(domain, api_key) |
| domain | liste les ips sur lesquelles Babbar a vu au moins une url | d_ip | dictionnaire dans une liste | d_ip(domain, api_key) |
| domain | liste les métriques au niveau domaine | d_overview | dictionnaire | d_overview(domain, api_key) |
| domain | liste les sites référents du domaine | d_referring_host | dictionnaire | d_referring_host(domain, api_key) |
| domain | liste les domaines avec un vecteur sémantique similaire | d_similar | dictionnaire dans une liste | d_similar(domain, api_key) |
| domain | liste des domaines référents du domaine | d_referring_domain | dictionnaire | d_referring_domain(domain, api_key) |
| domain | liste des langues détectées sur le domaine | d_lang | dictionnaire dans une liste | d_lang(domain, api_key) |
| domain | historique des métriques du domaine | d_history | dictionnaire | d_history(domain, api_key) |
| domain | liste des top page trust du domaine | d_top_pt | dictionnaire | d_top_pt(domain, api_key) |
| domain | liste des top page value du domaine | d_top_pv | dictionnaire | d_top_pv(domain, api_key) |
| domain | liste des top semantic value du domaine | d_top_sv | dictionnaire | d_top_sv(domain, api_key) |
| host | liste les ancres fréquentes vers le host renseigné | h_anchors | dictionnaire dans une liste | h_anchors(host, api_key) |
| host | liste les backlinks du host | h_backlinks_url_list | dictionnaire dans une liste | h_backlinks_url_list(host, api_key) |
| host | liste les urls connues et crawlées par Babbar | h_fetches | dictionnaire dans une liste | h_fetches(host, api_key, lang= »fr ») |
| host | donne le score de santé du host | h_health | dictionnaire | h_health(host, api_key) |
| host | liste les pages interne du host renseigné | h_internal_pages | Pandas DataFrame | h_internal_pages(host, api_key) |
| host | liste les keywords du host | h_keywords | Pandas DataFrame | h_keywords(host, lang, country, start_date, end_date, api_key) |
| host | liste les métriques au niveau host | h_overview | dictionnaire | h_overview(host, api_key) |
| host | liste les sites référents du host | h_referring_host | dictionnaire | h_referring_host(host, api_key) |
| host | liste les hosts avec un vecteur sémantique similaire | h_similar | dictionnaire dans une liste | h_similar(host, api_key) |
| host | liste des hosts proches d’un terme | h_spotfinder | liste de listes | h_spotfinder(term, api_key) |
| host | liste les ips sur lesquelles Babbar a vu au moins une url | h_ip | dictionnaire dans une liste | h_ip(host, api_key) |
| host | donne les scores de duplication au sein d’un host | h_duplicate | liste de listes | h_duplicate(host, api_key) |
| host | liste des hosts dans le voisinage du host visé | h_neighbours | dictionnaire | h_neighbours(host, api_key) |
| host | liste des domaines référents du host indiqué | h_referring_domain | dictionnaire | h_referring_domain(host, api_key) |
| host | liste des questions proches sémantiquement d’un host indiqué | h_questions | dictionnaire dans une liste | h_questions(host, api_key) |
| host | liste des langues détectées sur un host indiqué | h_lang | dictionnaire dans une liste | h_lang(host, api_key) |
| host | historique des métriques d’un host indiqué | h_history | dictionnaire | h_history(host, api_key) |
| host | liste des tops pages internes selon la Page Value | h_top_pv | dictionnaire | h_top_pv(host, api_key) |
| host | liste des tops pages internes selon la Page Trust | h_top_pt | dictionnaire | h_top_pt(host, api_key) |
| host | liste des tops pages internes selon la Semantic Value | h_top_sv | dictionnaire | h_top_sv(host, api_key) |
| host | liste des tops pages internes selon l’Internal Page Value | h_top_iev | dictionnaire | h_top_iev(host, api_key) |
| host | liste les tops backlinks du host | h_backlinks_url | dictionnaire dans une liste | h_backlinks_url(host, api_key, sort= »desc », type= »semanticValue ») |
| keywords | Résultats de la SERP stockée dans l’index Babbar | serp_keywords | dictionnaire | serp_keywords(keyword, api_key, lang= »fr », country= »FR », date=initial_date) |
| onpage | Analyse du DOM à partir d’une url | onpage_analyzis | dictionnaire | onpage_analyzis(url, api_key) |
| semantic_explorer | liste de People Also Asks à partir d’une requête | semantic_paa | dictionnaire | semantic_paa(query, api_key, lang= »fr ») |
| semantic_explorer | liste de requêtes associées à partir d’une requête | semantic_related | dictionnaire | semantic_related(query, api_key, lang= »fr ») |
| semantic_explorer | liste des suggestions associées à une requête | semantic_suggests | dictionnaire | semantic_suggests(query, api_key, lang= »fr ») |
| semantic_explorer | liste de sujets associés à une requête selon mindreader | semantic_mindreader | dictionnaire | semantic_mindreader(query, api_key, lang= »fr ») |
| url | liste les ancres fréquentes vers l’url renseignée | u_anchors | dictionnaire dans une liste | u_anchors(url, api_key) |
| url | liste les sites référents de l’url | u_referring_host | dictionnaire | u_referring_host(url, api_key) |
| url | liste les backlinks de l’url | u_backlinks_url | dictionnaire | u_backlinks_url(url, api_token, sort= »desc », type= »semanticValue ») |
| url | métrique de la force induite calculée à partir de deux urls fournies | u_fi | Pandas DataFrame | u_fi(source_url, target_url, api_key) |
| url | liste des mots clés sur lesquels une url ranke dans l’index Babbar | u_keywords | dictionnaire dans une liste | u_keywords(url, api_key, start_date, end_date, min =1, max=100, lang = »fr », country= »FR ») |
| url | liste des métriques d’une url | u_overview | dictionnaire | u_overview(url, api_key) |
| url | liste les urls internes proches d’une url donnée | u_internal_linking | Pandas DataFrame | u_internal_linking(url, api_key) |
| url | évalue la similarité sémantique entre deux urls | u_semanticSimilarity | Pandas DataFrame | u_semanticSimilarity(source_url, target_url, api_key) |
| url | liste les liens en internes depuis une url | u_current_internals_from | dictionnaire dans une liste | u_current_internals_from(url, api_key) |
| url | liste les liens externes depuis une url | u_current_externals_from | dictionnaire dans une liste | u_current_externals_from(url, api_key) |
| url | liste les questions associées sémantiquement à une url | u_questions | dictionnaire dans une liste | u_questions(url, api_key) |
| url | liste les domaines référents à une url | u_referring_domain | dictionnaire | u_referring_domain(url, api_key) |