seo/
keyword-difficulty

Comparez la difficulté de classement organique de jusqu’à 1 000 mots-clés sur un marché, avec pour chaque mot-clé disponible un score de 0 à 100 dans des enregistrements normalisés.

Keyword Difficulty API

Jusqu’à 1 000 mots-clés
Score de difficulté de 0 à 100
Comparaison propre à un marché
0,1 crédit par mot-clé
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Keyword Difficulty

Les scores de difficulté d’un mot-clé expriment la concurrence relative estimée pour se positionner dans les résultats organiques sur un terme de recherche, une valeur plus élevée signalant une difficulté plus grande. Ces signaux au niveau du mot-clé servent à fixer des priorités, à segmenter des groupes de recherche et à comparer les termes d’une liste préparée.

Fonctionnalités de la Keyword Difficulty API

  • Saisie de mots-clés en lotÉvalue de 1 à 1 000 mots-clés non vides dans une même tâche, en appliquant au lot le même marché et la même langue.
  • Indicateur de difficulté normaliséRenvoie chaque mot-clé disponible avec metrics.keyword_difficulty, exprimé en général sur une échelle de 0 à 100 pour permettre la comparaison directe.
  • Contexte source completConserve dans extra la ligne renvoyée en entier, afin que les clients puissent inspecter d’autres champs de la source sans les considérer comme un schéma normalisé stable.

Paramètres de la Keyword Difficulty API

ParamètresObligatoireDescription
keywordsObligatoireListe obligatoire de 1 à 1 000 mots-clés non vides, de 80 caractères au maximum par élément.
location_codeFacultatifCode numérique positif du marché de recherche. Le Playground utilise 2840 par défaut, pour les États-Unis.
location_nameFacultatifNom du marché de recherche, facultatif, en alternative à location_code. Lorsqu’il est renseigné, il prévaut sur location_code.
language_codeFacultatifCode de langue de recherche de 2 à 10 caractères, appliqué au lot. Le Playground utilise en par défaut.
languageFacultatifNom de la langue de recherche, facultatif, en alternative à language_code. Lorsqu’il est renseigné, il prévaut sur language_code.
results_limitFacultatifLimite de résultats facultative, de 1 à 2 000.

Comment utiliser la Keyword Difficulty API

Envoyez une liste bornée de mots-clés avec des réglages de marché par codes, puis lisez les scores normalisés disponibles dans la tâche asynchrone terminée.

  1. Préparez de 1 à 1 000 mots-clés non vides, de 80 caractères au plus chacun.
  2. Envoyez keywords avec location_code et language_code en POST à /v1/seo/keyword-difficulty, puis conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. Lisez data.results.items, puis suivez next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/seo/keyword-difficulty" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["keyword research","seo tools"],"location_code":2840,"language_code":"en"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la Keyword Difficulty API

  • Hiérarchisation d’une liste de mots-clés : Comparez metrics.keyword_difficulty sur un ensemble de termes préparé pour ajouter un signal de concurrence au tri éditorial ou à la recherche.
  • Segmentation par tranches de difficulté : Regroupez les scores renvoyés selon des plages que vous définissez, afin d’organiser des files de recherche pour les mots-clés les plus faciles et les plus difficiles.
  • Comparaison de marchés : Lancez la même liste de mots-clés avec des valeurs location_code et language_code maîtrisées pour comparer la difficulté estimée d’un contexte de recherche à l’autre.

Conseils d’expert pour la Keyword Difficulty API

  • Dédoublonnez les mots-clés avant l’envoi, pour que des termes répétés ne génèrent pas des frais répétés fondés sur l’entrée.
  • Gardez location_code et language_code identiques quand vous comparez des scores au sein d’un même ensemble de recherche.
  • Omettez results_limit, car ce lot est piloté par le tableau keywords et non par une limite de résultats renvoyés.
  • Rapprochez les résultats par mot-clé plutôt que par position dans le tableau, car les termes indisponibles peuvent être omis des enregistrements renvoyés.
  • Distinguez un score numérique de 0 d’une valeur keyword_difficulty absente lorsque vous construisez vos tranches de score.

En complément de la Keyword Difficulty API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques SEO.

  • Google Organic SERP API — Récupérez une page de résultats Google en direct par requête et marché, avec destinations, positions, types d’éléments et détail complet des résultats normalisés.
  • Keyword Overview API — Enrichissez un lot de mots-clés soumis avec la demande, la concurrence payante, la difficulté, les recherches mensuelles et l’intention de recherche disponibles.
  • Keyword Search Volume API — Mesurez des mots-clés connus avec le volume de recherche, le CPC, la concurrence payante et l’historique mensuel des recherches disponibles.
  • Keywords for Site API — Générez des mots-clés pertinents pour un site web avec les mesures de demande disponibles, l’historique mensuel, le contexte de marché et les lignes sources complètes.
  • Keyword Suggestions API — Développez une requête de départ en termes de longue traîne correspondants, avec mesures de demande disponibles, historique mensuel, intention de recherche et lignes sources complètes.
  • Search Intent API — Classez l’intention de recherche principale et secondaire d’un lot de mots-clés soumis, en conservant les probabilités sources et les enregistrements complets.

Explorer d’autres plateformes

Combinez les données SEO avec les données publiques d’autres plateformes sociales prises en charge.

Keyword Difficulty API — FAQ

Keyword Difficulty API est une interface programmatique qui compare la difficulté de classement organique de 1 à 1 000 mots-clés envoyés sur un marché de recherche. Elle renvoie chaque mot-clé disponible avec un score de difficulté normalisé de 0 à 100 et la ligne source complète.

Une tâche accepte de 1 à 1 000 chaînes de mots-clés non vides, de 80 caractères au plus chacune. Le tableau keywords définit la taille du lot.

Pas nécessairement. Un mot-clé peut être omis ou n’avoir aucune métrique de difficulté quand un score ne peut pas être calculé ; les clients ne doivent donc pas supposer une ligne renvoyée par entrée.

Non. Le score est une estimation comparative de la difficulté de classement organique sur le marché choisi, et non une probabilité de classement, une prévision de trafic ou une recommandation propre à un site.

Chaque mot-clé envoyé coûte 0,1 crédit SocQ, y compris ceux pour lesquels aucune ligne de résultat n’est disponible. Une requête de deux mots-clés dans le Playground est donc estimée à 0,2 crédit.