seo/
search-intent

Classez jusqu’à 1 000 mots-clés fournis selon l’intention de recherche, avec des libellés principaux et secondaires assortis de probabilités dans des enregistrements de mots-clés normalisés.

Search Intent API

Mots-clés envoyés en lot
Quatre libellés d’intention
Intention principale et secondaire
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

Search Intent

L’intention de recherche décrit une requête par les libellés informationnel, navigationnel, commercial ou transactionnel, accompagnés de signaux de probabilité principaux et secondaires. Ces classifications servent à étiqueter un inventaire de mots-clés, à examiner les intentions mixtes, à aligner les briefs de contenu et à orienter des listes de mots-clés préparées vers les bons workflows de recherche.

Fonctionnalités de la Search Intent API

  • Classification en lot selon la langueClasse jusqu’à 1 000 mots-clés fournis dans une langue choisie, l’anglais étant utilisé quand aucune langue n’est indiquée.
  • Signaux d’intention principale et secondaireRenvoie l’intention la plus probable avec sa probabilité, ainsi que les autres intentions vraisemblables et leurs probabilités.
  • Enregistrements normalisés et completsLisez les champs normalisés keyword et search_intent tout en retrouvant keyword_intent et secondary_keyword_intents dans extra.

Paramètres de la Search Intent API

ParamètresObligatoireDescription
keywordsObligatoireListe obligatoire de 1 à 1 000 mots-clés non vides, de 80 caractères au plus chacun.
location_codeFacultatifCode de localisation du marché de recherche, positif et facultatif.
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 facultatif, de 2 à 10 caractères. 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_limitFacultatifPlafond de résultats facultatif, de 1 à 2 000.

Comment utiliser la Search Intent API

Envoyez une liste de mots-clés avec des réglages facultatifs de marché, de langue et de limite de résultats, puis lisez les enregistrements d’intention normalisés 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, et tout champ facultatif de marché, de langue ou results_limit, en POST à /v1/seo/search-intent, 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 reste à true.
curl -X POST "https://api.socq.ai/v1/seo/search-intent" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["how to research keywords","buy seo software"],"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 Search Intent API

  • Étiquetage d’un inventaire de mots-clés : Associez chaque mot-clé à son intention principale pour ajouter des libellés d’intention homogènes à un inventaire de mots-clés préparé.
  • Examen des intentions mixtes : Comparez les libellés principaux et secondaires avec leurs probabilités pour repérer les mots-clés qui peuvent recouvrir plus d’un objectif de recherche.
  • Aiguillage vers les workflows de recherche : Regroupez les mots-clés fournis selon l’intention informationnelle, navigationnelle, commerciale ou transactionnelle avant de les orienter vers des workflows de recherche distincts.

Conseils d’expert pour la Search Intent API

  • Retirez les entrées vides et les doublons avant d’envoyer un lot, pour que la facturation au nombre d’entrées reflète les mots-clés que vous voulez réellement classer.
  • Gardez les champs de marché et de langue identiques quand vous comparez des lots.
  • Examinez les probabilités d’intention secondaire quand un mot-clé a une intention mixte, au lieu de tenir le libellé principal pour un fait universel.
  • Prévoyez des classifications manquantes, et consultez extra pour auditer les objets d’origine keyword_intent et secondary_keyword_intents.

En complément de la Search Intent 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 Difficulty API — Comparez la difficulté de classement organique d’un lot de mots-clés soumis et obtenez chaque mot-clé disponible avec son score normalisé.
  • 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.
  • 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.
  • Related Keywords API — Suivez les chemins de recherches associées à partir d’une requête de départ avec contrôle de la profondeur, mesures de mots-clés disponibles, intention de recherche et lignes sources complètes.

Explorer d’autres plateformes

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

Search Intent API — FAQ

Search Intent API est une interface programmatique qui classe jusqu’à 1 000 mots-clés fournis dans une langue choisie. Elle renvoie, pour chaque mot-clé disponible, des libellés d’intention principale et secondaire normalisés avec leurs probabilités.

Les quatre libellés sont informational, navigational, commercial et transactional, soit les intentions informationnelle, navigationnelle, commerciale et transactionnelle.

Envoyez keywords, définissez éventuellement location_code ou location_name, choisissez language_code ou language, et utilisez results_limit de 1 à 2 000 si nécessaire.

Envoyez de 1 à 1 000 mots-clés non vides, d’une longueur maximale de 80 caractères par mot-clé.

Il s’agit d’un niveau de confiance dans la classification d’intention, et non d’une probabilité d’achat ni d’un taux de conversion. Les mots-clés à intention mixte peuvent donc comporter des classifications secondaires significatives.

Non. Certains mots-clés envoyés peuvent ne produire aucune classification ; rapprochez donc les enregistrements renvoyés par mot-clé et gérez les lignes absentes.

Chaque mot-clé envoyé coûte 0,1 crédit SocQ.