DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis – API de synthèse
Vue agrégée de toutes les citations d'un mot-clé dans l'index web. Renvoie 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. C'est le point central de la famille contenu : post_dataforseo_content_sentiment_analysis_live ne renvoie que les deux blocs de connotation déjà inclus ici, alors appelez celui-ci sauf si vous voulez précisément la charge utile plus petite. Pour les pages citantes individuelles plutôt que les totaux, utilisez post_dataforseo_content_search_live ; pour le même agrégat dans le temps, post_dataforseo_content_phrase_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)[]
- 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
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": {
"snippet": ""logitech mouse"",
"main_title": "sale"
}- 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" - positiveType: number | null
_connotation _threshold seuil de connotation positive
champ facultatif
indiqué comme le seuil de l'indice de probabilité de sentiment positif lié au contenu de la citation
si vous indiquez ce champ, l'objetconnotation_typesde la réponse ne contiendra que les données des citations dont la probabilité de sentimentpositiveest supérieure ou égale à la valeur indiquée
valeurs possibles : de0à1
valeur par défaut :0.4 - 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
- sentimentsType: number | null
_connotation _threshold seuil de connotation de sentiment
champ facultatif
indiqué comme le seuil de l'indice de probabilité des connotations de sentiment liées au contenu de la citation
si vous indiquez ce champ, l'objetsentiment_connotationsde la réponse ne contiendra que les données des citations pour lesquelles la
probabilité de chaque sentiment est supérieure ou égale à la valeur indiquée
valeurs possibles : de0à1
valeur par défaut :0.4 - 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_ContentAnalysisSummaryLiveResponseInfo200
- 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_ContentAnalysisSummaryLiveTaskInfo
- 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 de sentiment 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).
- 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 - 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 de sentiment 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 quantité totale 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/summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"page_type": [
"ecommerce",
"news",
"blogs",
"message-boards",
"organization"
],
"internal_list_limit": 8,
"positive_connotation_threshold": 0.5
}
]'
{
"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,
"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
}
]
}
]
}