Recherche de Mots-Clés (YepAPI)

Workflow de Recherche de Mots-Clés

Workflow dédié à la recherche de mots-clés — découvrez, évaluez et priorisez des mots-clés avec les endpoints YepAPI.

Endpoints Utilisés

Endpoint	Coût	Objectif
POST /v1/seo/keywords/ideas	0,03 $	Suggestions de mots-clés à partir d'un mot-clé racine
POST /v1/seo/keywords/related	0,03 $	Mots-clés connexes pour un mot-clé racine
POST /v1/seo/keywords	0,15 $	Métriques groupées de mots-clés (volume, CPC, difficulté, intention)
POST /v1/seo/keyword-gap	0,04 $	Analyse des écarts de mots-clés entre deux domaines

Workflow

Étape 1 : Générer des Idées de Mots-Clés

Commencez par un mot-clé racine. Exécutez POST /v1/seo/keywords/ideas.

{
  "keyword": "gestion de projet",
  "location": "fr"
}

Retourne : des suggestions de mots-clés basées sur le mot-clé racine — angles de contenu et variantes longue traîne.

Étape 2 : Trouver des Mots-Clés Connexes

Élargissez avec POST /v1/seo/keywords/related.

{
  "keyword": "gestion de projet",
  "location": "fr"
}

Retourne : des termes sémantiquement liés — variations plus larges et plus étroites.

Étape 3 : Évaluer les Métriques des Mots-Clés

Exécutez POST /v1/seo/keywords avec tous les mots-clés candidats.

{
  "keywords": ["logiciel gestion de projet", "outils gestion de projet", "meilleure application gestion de projet"],
  "location": "fr"
}

Retourne : volume de recherche, CPC, difficulté des mots-clés, intention de recherche (informationnelle/commerciale/transactionnelle), tendances sur 12 mois.

Étape 4 : Analyse des Écarts de Mots-Clés (Optionnelle)

Si l'utilisateur dispose d'un domaine et d'un concurrent, exécutez POST /v1/seo/keyword-gap.

{
  "domain": "example.com",
  "competitor": "concurrent.com"
}

Retourne : les mots-clés pour lesquels le concurrent se classe mais pas l'utilisateur — opportunités inexploitées.

Étape 5 : Prioriser les Mots-Clés

Présentez une liste de mots-clés priorisée triée par score d'opportunité :

• Forte opportunité — volume élevé + difficulté faible
• Grouper par intention — informationnelle, navigationnelle, commerciale, transactionnelle
• Marquer les mots-clés saisonniers — notez les motifs sur 12 mois à partir des données de tendances

Règles

• Commencez large avec les idées, puis affinez avec les métriques
• Groupez les mots-clés par intention de recherche : informationnelle, navigationnelle, commerciale, transactionnelle
• Marquez les mots-clés saisonniers à l'aide des données de tendances (motif sur 12 mois)
• Regroupez les appels de métriques de mots-clés — jusqu'à 100 mots-clés par requête (0,15 $) est moins cher que des recherches individuelles

Gestion des Erreurs

• NO_CREDITS (402) — Dites à l'utilisateur d'ajouter des crédits sur https://yepapi.com/dashboard
• UPSTREAM_ERROR (502) — Réessayez une fois ; si cela échoue à nouveau, passez cette étape et notez-le
• VALIDATION_ERROR (400) — Vérifiez le format des mots-clés ; les mots-clés doivent être des chaînes non vides
• RATE_LIMITED (429) — Attendez et réessayez ; respectez l'en-tête Retry-After