Scalez vos process avec l’API de ThotSEO
Une seule url à appeler pour recevoir toute la data en moins d’une minute.
Voici un exemple de sortie pour la requête whey ou créatine
Vous pouvez aussi utiliser cette url de test gratuitement pour faire vos automatisations avant de souscrire : https://thot-seo.fr/wp-content/themes/Thot/api/testing-api.php
{
"query": "whey ou creatine",
"score_target": 54,
"mots_requis": 1404,
"KW_obligatoires": [["créatine",2,44],["whey",1,35],["prise",1,33],["muscle",2,29],["complément",2,27],["masse",2,25],["bcaa",1,25],["protéine",5,20],["alimentaire",2,21],["musculaire",2,17],["effet",3,12],["récupération",1,14],["musculation",1,12],["produit",1,12],["acide",2,10],["aminé",2,10],["force",2,9],["énergie",1,11],["monohydrate",2,8],["poudre",2,9],["dose",1,8],["consommer",1,8],["effort",2,9],["jour",1,8],["shaker",1,7],["objectif",1,7],["source",1,7],["séance",2,7],["sport",1,6],["lait",1,5],["sportif",1,6],["endurance",1,5],["exemple",1,5],["étude",1,5],["corps",1,6],["consommation",1,5],["recommandée",2,4],["bienfait",1,5],["puissance",1,6],["apport",1,5],["graisse",1,6],["meilleure",1,3],["haute",1,4],["santé",2,3],["rôle",1,4]],
"KW_complementaires": [["pack",2,33],["collation",2,17],["taux",5,9],["substance",2,10],["point",1,11],["marque",4,6],["augmenter",2,8],["personne",1,8],["amélioration",1,8],["utilisé",1,8],["matin",2,8],["midi",2,8],["performance",2,7],["booster",1,7],["meilleur",1,7],["sportive",1,7],["développement",2,5],["prix",4,5],["gamme",1,7],["forme",2,6],["intense",2,7],["organisme",1,7],["court",2,7],["qualité",1,7],["profiter",1,7],["risque",1,7],["composition",2,7],["fabriqué",2,5],["choisir",2,4],["associer",2,4],["nutrition",2,4],["croissance",1,5],["isolate",1,4],["training",2,3],["eau",2,4],["bénéfique",1,5],["supplémentation",1,4],["dosage",1,6],["varié",2,4],["équilibré",2,4],["cadre",2,4],["essentiel",1,4],["temps",1,5],["existe",1,5],["aide",1,4],["premier",1,5],["charge",1,5],["association",2,5],["raison",1,5],["nutriment",1,5],["éviter",1,4],["haut",1,5],["dépasser",1,4],["développer",1,4],["volume",2,3],["lieu",1,5],["favoriser",1,6],["capacité",2,4],["apporte",1,5],["spécifique",1,4],["construction",2,4],["dérivée",1,4],["concentrée",1,4],["positif",1,5],["favorisant",1,5],["choix",2,3],["naturelle",2,4],["consommateur",2,4],["teneur",1,5],["goût",1,5],["formule",2,5],["format",2,4],["vie",2,4],["sain",2,4],["portée",2,4],["enfant",2,4],["sec",2,4],["marché",2,4],["forte",2,4],["conservation",2,4],["idéale",2,3],["apprécié",2,5],["partie",2,5],["supplément",1,4],["avantage",2,3],["creapure",2,3],["gramme",1,4],["utile",2,3],["première",1,2],["augmente",1,2],["contient",1,2],["repas",1,2],["lactosérum",1,2],["monde",1,2],["pratiquant",1,3],["intensité",1,4],["gain",2,3],["rapide",2,3],["article",1,2]],
"ngrams": "grammes de créatine;lait de vache;synthèse des protéines;phase de charge;récupération musculaire;développement musculaire;protéine de lactosérum;créatine par jour;protéines de lactosérum;créatine augmente;force musculaire;nutrition sportive;whey et de créatine;grande quantité;régime alimentaire;sport nutrition;whey ou créatine;prise de muscle;supplémentation en créatine;protéine complète;courte durée;prise de masse musculaire;créatine et la whey;prenant de la créatine;adénosine triphosphate;apport protéique;prise de créatine;complément alimentaire;explosivité musculaire;augmentation de la masse;whey protein;masse maigre;prise de poids;protéine whey;construction musculaire;fonction rénale;augmentation de la force;créatine et la protéine;joue un rôle;jouent un rôle;whey isolat native;haute qualité;créatine monohydrate;faible teneur;whey isolate native;mode de vie sain;croissance musculaire;volume musculaire;protéine en poudre;petit lait;hypertrophie musculaire;haute intensité",
"max_suroptimisation": 5,
"questions": "Quel est le mieux entre la créatine et la whey ?;Est-ce qu'on peut mélanger la créatine et la whey ?;Quelle est la différence entre la créatine et la protéine ?;Est-ce que la créatine fait prendre du muscle ?;Est-ce qu'on peut mélanger créatine et whey ?;Quand prendre son shaker de whey et de créatine ?;Comment prendre de la créatine et de la whey ?;Comment prendre protéine et créatine ?;Quand prendre la protéine et la créatine ?;Quel est le mieux entre créatine et protéine ?;Est-ce que la créatine est une protéine ?;Est-ce que on peut mélanger la créatine avec la protéine ?;Est-ce bon de prendre de la créatine ?;Est-ce que la créatine augmente la masse musculaire ?;Quand voit-on les effets de la créatine ?;Quels sont les effets positifs de la créatine ?;Qu’est-ce que la créatine ? ;La prise de créatine est-elle efficace ? ;Faut-il prendre la whey et la créatine en même temps ? ;Faut-il nécessairement consommer un mélange de whey et de créatine ? ;Désabonnement possible à tout momentquels sont les bienfaits de la créatine sur la prise de masse ? ;Alors comment agit la créatine sur la prise de masse musculaire ? ;Pourquoi prendre de la créatine pour la musculation ? ;Pourquoi prendre de la créatine pour faire une prise de masse ? ;Quels sont les autres bienfaits de la créatine pour la musculation ? ;Comment prendre de la créatine pour faire une prise de masse ? ;Quand prendre de la créatine pour une prise de masse ? ;Mais quel est le meilleur supplément adapté à vos besoins ? ;Est-il possible d’associer la whey avec la créatine ? ;Quand prendre la whey la créatine et les bcaa ? ;Vu que tous les bienfaits de ces suppléments sont complémentaires peut-on les associer entre eux ? ;Que devez-vous choisir ? ;Quelle marque choisir ? ;Qui peut consommer de la créatine ? ;Qu’est-ce que la whey ? ;Qui peut consommer de la whey ? ;Comment prendre la whey testo booster ? ;Pourquoi choisir le pack prise de masse de muscle master ? ;Comment associer des produits ? ;Pourquoi prendre un complément alimentaire ? ;Quand et comment prendre des compléments alimentaires ? ;Quel est le meilleur complément alimentaire naturel pour perdre du poids / maigrir ? ;Pour en savoir plus nous vous invitions à consulter notre article complet \"quels compléments alimentaires prendre pour maigrir ? ;Mais alors quand prendre de la créatine ? ;Comment prendre de la whey ou de la créatine ? ;Alors combien de créatine par jour faut-il consommer ? ;Comment combiner whey créatine et bcaa en même temps ? ;Quand et comment faut-il prendre la whey bcaa et créatine ? ;Pourquoi prendre de la whey proteine ? ;Quelle est la meilleure whey protéine en poudre ? ;Comment choisir sa protéine whey ? ;Pourquoi boire de la whey protéine au réveil ? ;Pourquoi prendre de la whey et de la créatine tous les jours ? ;Quand prendre son shaker whey + créatine ? ;Combien coûte en moyenne le combo whey + créatine tous les mois ? ;Quels autres produits consommer en plus de la whey et de la créatine ? ;Qu'est-ce que la créatine ? ;Comment et quand prendre la créatine ? ;Qu'est-ce que la whey ? ;Quel supplément choisir ? ;Face au choix entre créatine et whey pourquoi ne pas envisager une solution qui transcende les deux ? ;Études de cas whey ou créatine comment choisir ? ;Pourquoi associer ces 3 formules ? ;Quel est le rôle de la créatine en musculation ? ;Comment associer protéine et créatine ? ;A quel moment prendre de la créatine ? ;Quand consommer sa créatine monohydrate ? ;Quel dosage de créatine pour une efficacité optimale ? ;Quand voit-on les effets de la créatine ? ;Quelle est la meilleure whey en 2022 ? ;À quoi sert la créatine ? ;Pourquoi prendre de la créatine en poudre ? ;Quels sont les effets de la créatine sur la masse musculaire ? ;Pourquoi utiliser de la créatine ? ;A quoi sert la créatine en musculation ? ;A quoi sert la créatine monohydrate ? ;A quel moment prendre la créatine monohydrate ? ;Quel est le meilleur moment pour prendre la créatine monohydrate ? ;Créatine en poudre ou créatine en gélule ? ;Comment prendre de la créatine ? ;Quelle dose de créatine par jour ? ;Faut-il prendre la créatine avant ou après l’effort ? ;Quand prendre de la créatine ? ;Pourquoi faire des pauses de créatine ? ;Est-ce qu’il vaut mieux cycler la prise de créatine ou la prendre de façon continue ? ;Avec quoi prendre la créatine ? ;La créatine est-elle un produit dopant ? ;Florent manaudou prend de la créatine… mais c'est quoi la créatine ? ;",
"type_editorial": 100,
"type_catalogue": 0,
"type_fiche_produit": 0,
"mots_uniques_min_max_moyenne": "[37, 57, 49]",
"concurrence": [{
"h1": "Quels sont les bienfaits de la créatine sur la prise de masse ?",
"title": "Créatine et prise de masse : à quoi s'attendre réellement ?",
"h2": "Comment prendre de la créatine pour faire une prise de masse ?",
"h3": "Quand prendre de la créatine pour une prise de masse ?",
"score": 48,
"suroptimisation": 8,
"position": 2,
"words": 1675,
"url": "https://nutriandco.com/fr/pages/creatine-prise-de-masse",
"domaine": "nutriandco.com",
"internal_links": 12,
"external_links": 0,
"tableaux": 0,
"titles": 8,
"video": 0,
"liste": 2,
"image": 54
},{
"h1": " ",
"title": " créatine whey ou bcaa : quel complément choisir et pourquoi ? – inshape nutrition ",
"h2": "Peut-on mélanger whey et bcaa dans un seul shaker ? ",
"score": 45,
"suroptimisation": 0,
"position": 3,
"words": 906,
"url": "https://www.inshape-nutrition.com/blogs/article/creatine-whey-ou-bcaa-quel-complement-choisir-et-pourquoi",
"domaine": "www.inshape-nutrition.com",
"internal_links": 11,
"external_links": 6,
"tableaux": 0,
"titles": 6,
"video": 0,
"liste": 6,
"image": 6,
"structured_data": [
"Logo",
"Personne",
"Organisation"
]
},{
"h1": "Whey ou créatine : quel complément est fait pour vous ?",
"title": "Whey ou créatine : quel complément est fait pour vous ?",
"h2": "Quelle marque choisir ?",
"score": 55,
"suroptimisation": 5,
"position": 4,
"words": 1553,
"url": "https://www.nocsy.fr/whey-ou-creatine/",
"domaine": "www.nocsy.fr",
"internal_links": 12,
"external_links": 7,
"tableaux": 0,
"titles": 4,
"video": 0,
"liste": 10,
"image": 17,
"structured_data": [
"Fil d'ariane",
"Logo",
"WebPage",
"Personne",
"Organisation"
]
},{
"h1": "R77® whey testo booster + créatine",
"title": "R77® whey testo booster + créatine • cf7 sport nutrition",
"h2": "Comment prendre la whey testo booster ?",
"score": 29,
"suroptimisation": 0,
"position": 5,
"words": 537,
"url": "https://www.cf7.fr/produit/tvcf7/r77-whey-proteine-creatine-daa-eaa/",
"domaine": "www.cf7.fr",
"internal_links": 17,
"external_links": 4,
"tableaux": 2,
"titles": 3,
"video": 1,
"liste": 4,
"image": 10,
"structured_data": [
"Fil d'ariane",
"Logo",
"Sitelink",
"Organisation"
]
},{
"h1": "Créatine bcaa whey : quelles différences ?",
"title": "Créatine bcaa whey : quelles différences ? - l'équipe",
"score": 24,
"suroptimisation": 0,
"position": 6,
"words": 642,
"url": "https://www.lequipe.fr/Coaching/Conseils/Actualites/Creatine-bcaa-whey-quelles-differences/742052",
"domaine": "www.lequipe.fr",
"internal_links": 1,
"external_links": 2,
"tableaux": 0,
"titles": 0,
"video": 0,
"liste": 0,
"image": 9,
"structured_data": [
"Article de news",
"Fil d'ariane",
"Logo",
"WebPage",
"Organisation"
]
},{
"h1": "Créatine ou whey : on vous aide à choisir",
"title": "Créatine ou whey : on vous aide à choisir",
"h2": "La whey idéale pour la croissance musculaire et la récupération",
"h3": "Les meilleures créatines du moment",
"score": 34,
"suroptimisation": 0,
"position": 7,
"words": 538,
"url": "https://selectos.eu/guide/creatine-ou-whey/",
"domaine": "selectos.eu",
"internal_links": 23,
"external_links": 15,
"tableaux": 1,
"titles": 3,
"video": 0,
"liste": 4,
"image": 80,
"structured_data": [
"Fil d'ariane",
"Logo",
"Sitelink",
"WebPage",
"Organisation"
]
},{
"h1": " prise de masse muscle master pack muscle master ",
"title": "Pack prise de masse master | whey proteine gluta+bcaa créatine",
"h2": "Comment prendre ce pack ?",
"score": 29,
"suroptimisation": 0,
"position": 8,
"words": 282,
"url": "https://www.dravelnutrition.fr/prise-de-masse-muscle-master-whey",
"domaine": "www.dravelnutrition.fr",
"internal_links": 1,
"external_links": 0,
"tableaux": 1,
"titles": 3,
"video": 0,
"liste": 3,
"image": 7,
"structured_data": [
"Produit",
"Offre"
]
},{
"h1": "Peut-on mélanger de la whey avec de la créatine?",
"title": "Peut-on mélanger de la whey avec de la créatine? - optigura",
"h2": "Les avantages de consommer de la whey avec de la créatine",
"score": 34,
"suroptimisation": 0,
"position": 9,
"words": 763,
"url": "https://www.optigura.fr/blog/melanger-whey-avec-creatine",
"domaine": "www.optigura.fr",
"internal_links": 1,
"external_links": 0,
"tableaux": 0,
"titles": 3,
"video": 0,
"liste": 8,
"image": 17,
"structured_data": [
"Article de news",
"Logo",
"WebPage",
"Personne",
"Organisation"
]
},{
"h1": "L’association de la whey et de la créatine : pourquoi faire ?",
"title": "L'association de la whey et de la créatine : pourquoi faire ? - blog eric favre | sport nutrition expert",
"h2": "Whey et créatine : la bonne combinaison ?",
"score": 38,
"suroptimisation": 0,
"position": 10,
"words": 544,
"url": "https://www.ericfavre.com/lifestyle/association-whey-creatine/",
"domaine": "www.ericfavre.com",
"internal_links": 1,
"external_links": 1,
"tableaux": 0,
"titles": 1,
"video": 0,
"liste": 2,
"image": 3,
"structured_data": [
"Fil d'ariane",
"Logo",
"WebPage",
"Personne",
"Organisation"
]
}
]
}

Lancer une analyse
1 url donné à l’abonnement + paramètres à renseigner en GET :
- keywords
- apikey
/?keywords=whey%20ou%20creatine&apikey=votre_apikey
Cet 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=True
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’
Voici les autres options disponibles pour les pays :
- Belgium
- Suisse
- Canada
- Etats-Unis
- Angleterre
- Espagne
- Mexique
- Allemagne
- Italie
- Portugal
- Bresil
Et voici les autres options possibles pour les langues :
- en
- es
- de
- it
- pt
/?keywords=whey%20or%20creatine&apikey= votre_apikey&langue=en&pays=Angleterre
Résultats des analyses et clés JSON
L’API donne accès à toutes les données de base de ThotSEO :
query
search_intents (optionnel)
score_target
mots_requis
KW_obligatoires
KW_complementaires
ngrams
max_suroptimisation
questions
type_editorial
type_catalogue
type_fiche_produit
mots_uniques_min_max_moyenne
concurrence
Pour la concurrence, vous obtenez les informations suivantes chaque url positionnée :
h1
title
h2
score
suroptimisation
position
words
url
domaine
internal_links
external_links
tableaux
titles
video
liste
image
structured_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 analyse uniquement une partie du texte (int)
- Le nombre de mots requis d’après l’analyse ThotSEO préalable (int)
- Votre clée 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é 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ée 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 ?
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
Après votre abonnement, je vous recontacterai sous 24h pour vous remettre votre clé API.