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ètres | Obligatoire | Description |
|---|---|---|
keywords | Obligatoire | Liste obligatoire de 1 à 1 000 mots-clés non vides, de 80 caractères au plus chacun. |
location_code | Facultatif | Code de localisation du marché de recherche, positif et facultatif. |
location_name | Facultatif | Nom du marché de recherche, facultatif, en alternative à location_code. Lorsqu’il est renseigné, il prévaut sur location_code. |
language_code | Facultatif | Code de langue de recherche facultatif, de 2 à 10 caractères. Le Playground utilise en par défaut. |
language | Facultatif | Nom de la langue de recherche, facultatif, en alternative à language_code. Lorsqu’il est renseigné, il prévaut sur language_code. |
results_limit | Facultatif | Plafond 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.
- Préparez de 1 à 1 000 mots-clés non vides, de 80 caractères au plus chacun.
- 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é.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- 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 trueCas 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.
API associées
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.
- Keywords for Site API
- Ranked Keywords API
- Relevant Pages API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API