Lancer une analyse
1 url donné à l’abonnement + paramètres à renseigner en GET :
- keywords
- apikey
/?keywords=whey%20ou%20creatine&apikey=votre_apikeyCet appel est le plus simple possible. Il vous sera retourné un JSON avec toutes les data de base et vous coûtera 1 seul crédit.
Pour les cas d’usage plus spécifiques voici les options
Options 1 : Sauvegarder l’analyse pour la rendre disponible dans l’interface
Par défaut l’endpoint de l’API ne fait que vous renvoyer les données de l’analyse et rien n’est stocké chez ThotSEO.
En revanche si vous êtes doté d’un abonnement APImax (sur demande uniquement) vous pouvez lancer une analyse via API et la rendre disponible dans l’interface.
Dans ce cas vous n’obtiendrez pas les résultats de l’analyse mais une confirmation de son lancement.
Pour cela on utilise : saving=True
/?keywords=whey%20ou%20creatine&apikey= votre_apikey&saving=TrueNotez que vous pouvez ajouter sharing_option=shared si vous souhaitez mettre l’analyse en collaborative / publique. Par défaut sharing_option=private
Vous obtiendrez alors le retour suivant contenant l’URL finale de l’analyse. Vous pourrez ensuite récupérer les informations via API avec l’endpoint /retrieve :
{
"type": "success",
"message": "analyse en cours",
"analyse_id": 99999,
"url_future": "https://thot-seo.fr/workspace/...."
}
{
"reponse": "API",
"query": "calories seche musculaire",
"search_intents": [
{
"intention": "Comment calculer ses calories en sèche ?",
"ngrams": "calculer, calories, sèche, déficit calorique, apport calorique quotidien, kcal par jour, besoin, calorique, programme alimentaire, régime alimentaire"
},
{
"intention": "Quels aliments privilégier en période de sèche ?",
"ngrams": "aliments, période de sèche, alimentation, sèche musculaire, protéines, lipides, glucides, programme de nutrition, repas, petit déjeuner"
},
{
"intention": "Quelle est la différence entre sèche et perte de poids ?",
"ngrams": "différence, sèche, perte de poids, masse musculaire, graisse corporelle, perte de gras, objectif, programme de musculation, définition musculaire"
},
{
"intention": "Comment éviter la fonte musculaire en sèche ?",
"ngrams": "éviter, fonte musculaire, sèche, protéines, déficit calorique, maintien, masse musculaire, programme de musculation, entraînement, récupération"
},
],
"score_target": 67,
...
}
Options 2 : Obtenir les intentions de recherche
Par défaut l’endpoint de l’API ne fournit pas le détail des intentions de recherche identifiées sur la SERP.
Pour les calculer et les obtenir dans le JSON retourné on utilise : search_intents=True
Cette analyse coûte 2 crédits.
Notez qu’il n’est pas nécessaire de demander les intentions de recherche lorsque vous sauvegardez une analyse dans la base de données ThotSEO car elles sont inclus par défaut.
Vous obtiendrez alors un retour similaire au premier avec une clé supplémentaire : search_intents
Option 3 : Mener une analyse dans une autre langue
Par défauts les paramètres optionnels sont les suivants :
- langue= fr,
- pays=‘France’
Deux systèmes sont possibles, le nom de pays en français comme ci-dessous ou bien le code ISO 3166-1 alpha-2
Voici les autres options disponibles pour les pays actuellement (ne mettre QUE les 2 caractères) :
BE - Belgium
CH - Suisse
CA - Canada
US - États-Unis
GB - Angleterre (Royaume-Uni)
ES - Espagne
MX - Mexique
DE - Allemagne
IT - Italie
PT - Portugal
BR - Brésil
NL - Pays-Bas
Pour les langues utilisez également les codes iso :
en - Anglais
es - Espagnol
de - Allemand
it - Italien
pt - Portugais
nl - Néerlandais
/?keywords=whey%20or%20creatine&apikey= votre_apikey&langue=en&pays=enRésultats des analyses et clés JSON
L’API donne accès à toutes les données de base de ThotSEO :
querysearch_intents (optionnel)score_targetmots_requisKW_obligatoiresKW_complementairesngramsmax_suroptimisationquestionstype_editorialtype_cataloguetype_fiche_produitmots_uniques_min_max_moyenneconcurrence
Pour la concurrence, vous obtenez les informations suivantes chaque url positionnée :
h1titleh2scoresuroptimisationpositionwordsurldomaineinternal_linksexternal_linkstableauxtitlesvideolisteimagestructured_data
Fonctionnement des calculs
Les calculs permettent d’analyser l’optimisation SEO d’un texte donné.
URL : https://api.thot-seo.fr/analyse-texte-api
Ce endpoint permet d’envoyer une requête POST pour obtenir un score SEO basé sur le texte soumis.
Vous avez 2 options :
- une rapide qui nécessite de stocker les résultats de l’analyse ;
- une plus lente mais permettant d’éviter de stocker les informations de votre côté.
Option 1 : Scoring de texte rapide ⚡️
Pour la version rapide il vous faudra renseigner :
- Le texte à analyser (string)
- Les mots-clés fournis par l’analyse ThotSEO préalable (array)
- Les ngrams fournis par ThotSEO (str)
- Le nombre de mots si vous souhaitez analyser uniquement une partie du texte (int)
- Le nombre de mots requis d’après l’analyse ThotSEO préalable (int)
- Votre clé API (string)
Cette version vous permet de scorer n’importe quel texte à partir de la liste de termes délivrée lors de l’analyse.
Option 2 : Scoring de texte à partir d’une analyse de l’interface 📀
La seconde option permet de scorer un texte sauvegardé préalablement dans l’interface ThotSEO uniquement à partir de son ID.
Cette méthode est un peu plus longue car il faut aller chercher les données en base de données.
- Le texte à analyser (string)
- Votre clé API (string)
- L’analyse ID (int)
Une réponse réussie retournera un objet JSON contenant les scores suivants :
scoreSEO: Le score SEO global du texte.scoreSEOIntro: Le score SEO de l’introduction du texte.scoreSuropitmisation: Le score indiquant si le texte est sur-optimisé
Voici 2 exemples, notez comme l’array keywords_all est exactement similaire à celle retournée par l’analyse.
{
"texte": "La meilleur whey pour une prise de masse est la whey native. ... ",
"keywords_all": [["whey",26,88],["protéine",6,88],["meilleure",1,3],["prise",1,15],["masse",2,12],["protein",1,20],["native",1,16],["musculation",1,10]],
"premiers_mots": "200",
"nb_mots_requis": "2000",
"apikey":"votreCleeAPI",
"ngrams": "whey protéine;prise de masse"
}
Avec la version basée sur une analyse enregistrée dans ThotSEO :
{
"texte": "La meilleur whey pour une prise de masse est la whey native. ... ",
"apikey":"votreCleeAPI",
"analyse_id":"9999"
}Pour la première solution, si vous ne souhaitez pas analyser l’introduction vous pouvez mettre variable premiers_mots égale à 0
{
"texte": "La meilleur whey pour une prise de masse est la whey native. ... ",
"keywords_all": [["whey",26,88],["protéine",6,88],["meilleure",1,3],["prise",1,15],["masse",2,12],["protein",1,20],["native",1,16],["musculation",1,10]],
"nb_mots_requis": "2000",
"premiers_mots": "0",
"apikey":"votreCleeAPI"
}
Dans les deux cas, voici ce qui sera retourné par l’API :
{
"scoreSEO": 40,
"scoreSEOIntro": 40,
"scoreSuroptimisation": 0,
"overused":['whey', 'protéine'],
"underused":['prise', 'masse', 'protein', 'native', 'musculation', ...],
"how_to_get_better": {
"prise": 7,
"masse": 5,
...
},
"usage": {
"musculation": 23,
"protéines": 17,
...
}
}
Suggestions de maillage interne
Cet endpoint permet d’obtenir une liste d’opportunités de maillage interne classés par glissement sémantique. Chaque appel vous coutera 1 crédit sur vos 500 mensuels (hors plan spécial).
Pour l’utiliser, il faut absolument une url et une requête visée par cette url.
URL : https://api.thot-seo.fr/maillage_interne_suggest_api
Il vous faudra renseigner :
- query : La requête cible (string)
- urlactuelle : L’url actuelle (string)
- apikey : Votre clé API (string)
En option :
- pays_google : Le pays de recherche (string) – « France » par défaut
- langue : La langue de recherche Google (string) – « fr » par défaut
- google_domaine : Le google spécifique (string) – « google.fr » par défaut
Les options disponibles sont les mêmes que pour l’analyse sémantique classique.
Voici un exemple :
{
"query": "whey pour grossir",
"urlactuelle": https://protealpes.com/produit/gainer/,
"apikey":"votreCleeAPI",
"pays_google": "France",
"langue": "fr",
"google_domaine": "google.fr"
}Voici ce qui sera retourné par l’API :
[
{
"score":89,
"internal_links":21,
"external_links":0,
"link":"https://protealpes.com/whey-fait-elle-grossir/",
"url_presente":false,
"url_vers":false,
"title_text":"La whey fait-elle grossir ? Que dit la science ?"
},
{
"score":52,
"internal_links":40,
"external_links":0,
"link":"https://protealpes.com/whey-perte-de-poids/",
"url_presente":false,
"url_vers":false,
"title_text":"La whey peut-elle aider à maigrir et perdre du poids ?"
},
{
"score":48,
"internal_links":41,
"external_links":0,
"link":"https://protealpes.com/en-combien-de-temps-effet-whey/",
"url_presente":false,
"url_vers":false,
"title_text":"En combien de temps la whey fait-elle effet ?"
},
...
]
Concrétement :
- score : le glissement sémantique entre l’url actuelle et l’url détectée
- internal_links : liens internes sortant de la page détectée (hors menus si possible)
- external_links : liens externes sortant de la page détectée
- link : l’url de la page détectée
- url_présente : l’url actuelle a été trouvée dans l’url détectée, ne fonctionne pas pour les liens relatifs pour le moment
- url_vers : l’url actuelle fait un lien vers l’url détectée
- title_text : le title tag de la page détectée (parfois plus parlant que l’URL)
Récupérer le contenu d’une analyse
Cet endpoint permet de récupérer les éléments relatifs à une analyse menée par le passée et enregistrée dans l’interface. Attention endpoint en GET uniquement
URL : https://api.thot-seo.fr/retrieve
Il vous faudra renseigner :
- apikey : Votre clée API (string)
- analyse_id : l’ID de l’analyse (string)
Voici un exemple :
https://api.thot-seo.fr/retrieve?apikey=votreCleeAPI&analyse_id=99999
Voici ce qui sera retourné par l'API :
{
"type": "success",
"texte_user": "votre texte en HTML",
"exces_max": "16",
"exces": "1",
"mots_requis": "608",
"mots": "1927",
"score_requis": "58",
"score": "85",
"meta_description": "",
"meta_title": "",
"query": "Meilleur outil SEO",
"analyse_id": "99999",
"ngrams":["thot seo","blog du modérateur",...],
"questions":["Quel est le prix de ThotSEO ?","Pourquoi quitter Semji ?",...],
"keywords_array":[["outils",25,56],["seo",4,74]...]
}
Lister les analyses
Cet endpoint permet de lister toutes les analyses associées à un utilisateur et enregistrées dans l'interface.
Attention pour éviter les temps de récupération trop important il est VIVEMENT conseillé de filtrer par groupe.
Endpoint en GET uniquement
URL : https://api.thot-seo.fr/retrieve
Il vous faudra renseigner :
- apikey : Votre clée API (string)
En option :
- groupe : groupe de l'analyse (string)
Voici un exemple :
https://api.thot-seo.fr/retrieve?apikey=votreCleeAPI&groupe=SEO
Voici ce qui sera retourné par l'API :
{
"type": "success",
"count": 106,
"analyses": [
{
"etat_analyse": "",
"exces_max": "27",
"exces": "0",
"mots_requis": "1608",
"mots": "600",
"score_requis": "89",
"score": "66",
"query": "whey pour Basketball",
"analyse_id": "7778",
"date_ajout": "2023-09-13 19:54:57",
"groupe": "protealpes"
},
{
"etat_analyse": "",
"exces_max": "13",
"exces": "21",
"mots_requis": "1117",
"mots": "594",
"score_requis": "79",
"score": "68",
"query": "whey pour Tennis",
"analyse_id": "7772",
"date_ajout": "2023-09-13 19:54:51",
"groupe": "protealpes"
},
...
]
}
Lister les groupes
Cet endpoint permet de lister tous les groupes associés à un utilisateur pour des analyses enregistrées dans l'interface.
URL : https://api.thot-seo.fr/list-groups
Il vous faudra renseigner :
- apikey : Votre clée API (string)
Voici un exemple :
{
"apikey":"votreCleeAPI"
}
Voici ce qui sera retourné par l'API :
{
"type": "success",
"total_groups": 65,
"groups": [
{
"groupe": "(sans groupe)",
"total_analyses": 648,
"analyses": [
{
"id": "4608",
"query": "whey"
},
{
"id": "8192",
"query": "maltodextrine de manioc"
},
...
]
},
{"groupe": "veracy",
"total_analyses": 1,
"analyses": [
{
"id": "8059",
"query": "Taxe Carbone aux frontières"
}
]
}
...
]
}
Prêt à scaler vos process et vos résultats ?
Après votre abonnement, je vous recontacterai sous 24h pour vous remettre votre clé API.
API only - mensuel
Pour les agences qui scalent
89 € HT / mois
500 analyses / mois
Soit 0.18€ / analyse + calculs de score gratuits
API only - annuel
Pour les agences qui scalent
79 € HT / mois soit 948€ / an
6000 analyses / an
Soit 0.158€ / analyse + calculs de score gratuits
APImax
Accès API + interface en formule max
119 € HT / mois au lieu de 149€
500 analyses / mois
Plan custom et plan annuel possibles
Besoin d'un plan custom ?
500