Content Analysis – API de tendances des expressions
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis – API de tendances des expressions
Les métriques de synthèse d'un mot-clé, répétées par période. Chaque entrée porte un date ainsi que total_count, rank, top_domains (chacun avec domain et count), sentiment_connotations (anger, happiness, love, sadness, share, fun), connotation_types (positive, negative, neutral), text_categories, page_categories, page_types, countries et languages. date_from, date_to et date_group (day, week, month) définissent la plage et la granularité. Utilisez-le pour voir si les mentions d'une expression montent ou baissent ; pour un instant précis, utilisez post_dataforseo_content_summary_live. Pour suivre une catégorie de produits entière plutôt qu'une expression, utilisez post_dataforseo_content_category_trends_live.
Référence tarifaire
- Facturation : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.0276.
- Multiplicateur de référence client : 1.0. Ne pas l'appliquer une seconde fois à un montant client déjà réglé.
Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.
- Type: array (object | null)[]
- dateType: string
_from date de début de l'intervalle de temps
champ obligatoire
format de date :"yyyy-mm-dd"
exemple :"2019-01-15" - dateType: string | null
_group intervalle de temps utilisé pour regrouper les résultats
champ facultatif
valeur par défaut :month
valeurs possibles :day,week,month - dateType: string | null
_to date de fin de l'intervalle de temps
champ facultatif
si vous n'indiquez pas ce champ, la date du jour est utilisée par défaut
format de date :"yyyy-mm-dd"
exemple :"2019-01-15" - initialType: array (object | null)[] | null
_dataset _filters paramètres de filtrage de l'ensemble de données initial
champ facultatif
paramètres de filtrage initiaux qui s'appliquent aux champs du point de terminaison Search ;
vous pouvez ajouter plusieurs filtres à la fois (8 filtres maximum) ;
vous devez définir un opérateur logiqueand,orentre les conditions ;
les opérateurs suivants sont pris en charge :regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,has,has_not,match,not_match
vous pouvez utiliser l'opérateur%aveclikeetnot_likepour correspondre à toute chaîne de zéro ou plusieurs caractères ;
exemple :["domain","<>", "logitech.com"][["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]][["domain","<>","logitech.com"]],
"and",
[["content_info.connotation_types.negative",">",1000],
"or",["content_info.text_category","has",10994]]]
pour plus d'informations sur les filtres, consultez Content Analysis API - Filters
en savoir plus sur les filtres d'ensemble de données initial dans cet article du centre d'aide.Objet vide - internalType: integer | null
_list _limit nombre maximal d'éléments dans les tableaux internes
champ facultatif
vous pouvez utiliser ce champ pour limiter le nombre d'éléments dans les tableaux suivants :top_domainstext_categoriespage_categoriescountrieslanguages
valeur par défaut :1
valeur maximale :20 - keywordType: string
mot-clé cible
champ obligatoire
encodage UTF-8
les mots-clés seront convertis en minuscules ;
Remarque : pour correspondre à une phrase exacte plutôt qu'à un mot-clé isolé, utilisez des guillemets doubles et des barres obliques inverses ;
exemple :"keyword": ""tesla palo alto""en savoir plus sur les règles et limitations des champs
keywordetkeywordsdans les API DataForSEO dans cet article du centre d'aide - keywordType: object | null
_fields champs de mot-clé cibles et mots-clés cibles
champ facultatif
utilisez ce paramètre pour filtrer l'ensemble de données par les mots-clés que certains champs doivent contenir ;
champs que vous pouvez indiquer :title,main_title,previous_title,snippet
vous pouvez indiquer plusieurs champs ;
Remarque : pour correspondre à une phrase exacte plutôt qu'à un mot-clé isolé, utilisez des guillemets doubles et des barres obliques inverses ;
exemple :"keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"- propertyType: string | null
Name
- pageType: array string[] | null
_type types de page cibles
champ facultatif
utilisez ce paramètre pour filtrer l'ensemble de données par types de page
valeurs possibles :"ecommerce","news","blogs","message-boards","organization" - rankType: string | null
_scale définit l'échelle utilisée pour calculer et afficher les valeurs de
rank
champ facultatifvous pouvez utiliser ce paramètre pour choisir si les valeurs de rang sont présentées sur une échelle de 0–100 ou de 0–1000
valeurs possibles :
one_hundred— les valeurs de rang sont affichées sur une échelle de 0–100one_thousand— les valeurs de rang sont affichées sur une échelle de 0–1000valeur par défaut :
one_thousanden savoir plus sur le fonctionnement de ce paramètre dans cet article du centre d'aide
- searchType: string | null
_mode type de regroupement des résultats
champ facultatif
types de regroupement possibles :as_is- renvoie les données de toutes les citations dukeywordcibleone_per_domain- renvoie les données d'une citation dukeywordpar domaine
valeur par défaut :as_is - tagType: string | null
identifiant de tâche défini par l'utilisateur
champ facultatif
la limite est de 255 caractères
vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat
vous trouverez la valeurtagspécifiée dans l'objetdatade la réponse
- Type: object | null · Response36Afe1097B20_ContentAnalysisPhraseTrendsLiveResponseInfo200
- Type: number | null Format: doublecost
coût total des tâches, USD
- Type: integer | nullstatus
_code code d'état général vous pouvez trouver la liste complète des codes de réponse ici
- Type: string | nullstatus
_message message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici
- Type: array (object | null)[] | nulltasks
tableau de tâches
- Type: object | null · Response36Afe1097B20_ContentAnalysisPhraseTrendsLiveTaskInfo
- costType: number | null Format: double
coût total des tâches, USD
- dataType: object | null
contient les mêmes paramètres que ceux spécifiés dans la requête POST
- propertyType: object | null
Name
- idType: string | null
identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID
- pathType: array (string | null)[] | null
chemin de l'URL
- resultType: array (object | null)[] | null
tableau de résultats
- connotationType: object | null
_types types de connotation
contient les types de sentiments (polarité du sentiment) associés à la citation du mot-clé et le nombre de citations pour chaque type de sentiment
types de connotation possibles :"positive","negative","neutral"- propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- countriesType: object | null
- propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- dateType: string | null
date pour laquelle les données sont fournies
- languagesType: object | null
- propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- pageType: array (object | null)[] | null
_categories - categoryType: array (integer | null)[] | null
- countType: integer | null Format: int64
Signed 64-bit integers (long type).
- pageType: object | null
_types types de page
contient les types de page et le nombre de citations pour chaque type de page- propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- rankType: integer | null
rang de toutes les URL citant le
keyword
somme normalisée des rangs de toutes les URL citant lekeywordcible pour la date donnée - sentimentType: object | null
_connotations connotations de sentiment
contient les sentiments (réactions émotionnelles) associés à la citation du mot-clé cible et le nombre de citations pour chaque sentiment
connotations possibles :"anger","happiness","love","sadness","share","fun"- propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- textType: array (object | null)[] | null
_categories - categoryType: array (integer | null)[] | null
- countType: integer | null Format: int64
Signed 64-bit integers (long type).
- topType: array (object | null)[] | null
_domains principaux domaines citant le mot-clé cible
contient des objets avec les principaux domaines citant le mot-clé cible et le nombre de citations pour chaque domaine- countType: integer | null Format: int64
Signed 64-bit integers (long type).
- domainType: string | null
- totalType: integer | null Format: int64
_count nombre total de résultats de notre base de données correspondant à votre requête
- typeType: string | null
type d'élément
- resultType: integer | null Format: int64
_count nombre d'éléments dans le tableau de résultats
- statusType: integer | null
_code code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici
- statusType: string | null
_message message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici
- timeType: string | null
temps d'exécution, en secondes
- Type: integer | null Format: int64tasks
_count le nombre de tâches dans le tableau de tâches
- Type: integer | null Format: int64tasks
_error le nombre de tâches dans le tableau de tâches renvoyées avec une erreur
- Type: string | nulltime
temps d'exécution total, en secondes
- Type: string | nullversion
la version actuelle de l'API
application/json - 400
La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
- 401
Une clé API Felo valide est requise.
- 402
La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
- 403
Le compte n'est pas autorisé à effectuer cette opération.
- 429
Une limite de requêtes ou de dépenses a été atteinte.
- 502
Le service n'a pas pu terminer la requête.
- 503
L'API ou le service de facturation est temporairement indisponible.
- 504
Le service a expiré lors du traitement de la requête.
- default
Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/phrase_trends/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"search_mode": "as_is",
"date_from": "2022-09-01",
"date_group": "month"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"type": null,
"date": null,
"total_count": null,
"rank": null,
"top_domains": [
{
"domain": null,
"count": null
}
],
"sentiment_connotations": null,
"connotation_types": null,
"text_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_types": null,
"countries": null,
"languages": null
}
]
}
]
}