Felo API PlatformFelo API Platform
Tous les endpoints DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Content Analysis – API de répartition par note

Felo API Support
MIT
Serveur:https://openapi.felo.ai
Bibliothèques clientes
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Opérations

Content Analysis – API de répartition par note

​

Répartit les citations d'un mot-clé en tranches de note et rapporte le jeu complet de métriques pour chacune. Renvoie une entrée par tranche avec min, max et un objet metrics contenant 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. rank_scale détermine le découpage. Pour les mêmes métriques sans découpage, utilisez post_dataforseo_content_summary_live ; pour le sentiment seul, post_dataforseo_content_sentiment_analysis_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.

Corps
application/json
  • Type: array (object | null)[]
    • initial_dataset_filters
      Type: array (object | null)[] | null

      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 logique and, or entre 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 % avec like et not_like pour 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","<&gt","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
    • internal_list_limit
      Type: integer | null

      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_domains
      text_categories
      page_categories
      countries
      languages
      valeur par défaut : 1
      valeur maximale : 20

    • keyword
      Type: 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 keyword et keywords dans les API DataForSEO dans cet article du centre d'aide

    • keyword_fields
      Type: object | null

      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>}"

      • propertyName
        Type: string | null
    • page_type
      Type: array string[] | null

      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"

    • positive_connotation_threshold
      Type: number | null

      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'objet connotation_types de la réponse ne contiendra que les données des citations dont la probabilité de sentiment positive est supérieure ou égale à la valeur indiquée
      valeurs possibles : de 0 à 1
      valeur par défaut : 0.4

    • rank_scale
      Type: string | null

      définit l'échelle utilisée pour calculer et afficher les valeurs de rank
      champ facultatif

      vous 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–100
      one_thousand — les valeurs de rang sont affichées sur une échelle de 0–1000

      valeur par défaut : one_thousand

      en savoir plus sur le fonctionnement de ce paramètre dans cet article du centre d'aide

    • search_mode
      Type: string | null

      type de regroupement des résultats
      champ facultatif
      types de regroupement possibles :
      as_is - renvoie toutes les citations du keyword cible
      one_per_domain - renvoie une citation du keyword par domaine
      valeur par défaut : as_is

    • sentiments_connotation_threshold
      Type: number | null

      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'objet sentiment_connotations de 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 : de 0 à 1
      valeur par défaut : 0.4

    • tag
      Type: 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 valeur tag spécifiée dans l'objet data de la réponse

Réponses
  • 200
    Type: object | null · Response36Afe1097B20_ContentAnalysisRatingDistributionLiveResponseInfo
    • cost
      Type: number | null Format: double

      coût total des tâches, USD

    • status_code
      Type: integer | null

      code d'état général vous pouvez trouver la liste complète des codes de réponse ici

    • status_message
      Type: string | null

      message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici

    • tasks
      Type: array (object | null)[] | null

      tableau de tâches

      • Type: object | null · Response36Afe1097B20_ContentAnalysisRatingDistributionLiveTaskInfo
        • cost
          Type: number | null Format: double

          coût total des tâches, USD

        • data
          Type: object | null

          contient les mêmes paramètres que ceux spécifiés dans la requête POST

          • propertyName
            Type: object | null
        • id
          Type: string | null

          identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID

        • path
          Type: array (string | null)[] | null

          chemin de l'URL

        • result
          Type: array (object | null)[] | null

          tableau de résultats

          • max
            Type: number | null

            note maximale sur une échelle de répartition

          • metrics
            Type: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo

            contient les métriques de répartition des notes

            • connotation_types
              Type: object | null

              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

              • propertyName
                Type: integer | null Format: int64

                Signed 64-bit integers (long type).

            • countries
              Type: object | null

              pays
              contient les pays et le nombre de citations dans chaque pays
              pour obtenir la liste complète des pays disponibles, consultez le point de terminaison Locations

              • propertyName
                Type: integer | null Format: int64

                Signed 64-bit integers (long type).

            • languages
              Type: object | null

              langues
              contient les langues et le nombre de citations dans chaque langue
              pour obtenir la liste complète des langues disponibles, consultez le point de terminaison Languages

              • propertyName
                Type: integer | null Format: int64

                Signed 64-bit integers (long type).

            • page_categories
              Type: array (object | null)[] | null

              catégories de page
              contient des objets avec les catégories de page et le nombre de citations dans chaque catégorie de page
              pour obtenir la liste complète des catégories disponibles, consultez le point de terminaison Categories

              • category
                Type: array (integer | null)[] | null
              • count
                Type: integer | null Format: int64

                Signed 64-bit integers (long type).

            • page_types
              Type: object | null

              types de page
              contient les types de page et le nombre de citations pour chaque type de page

              • propertyName
                Type: integer | null Format: int64

                Signed 64-bit integers (long type).

            • rank
              Type: integer | null

              rang de toutes les URL citant le keyword
              somme normalisée des rangs de toutes les URL citant le keyword cible

            • sentiment_connotations
              Type: object | null

              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

              • propertyName
                Type: integer | null Format: int64

                Signed 64-bit integers (long type).

            • text_categories
              Type: array (object | null)[] | null

              catégories de texte
              contient des objets avec les catégories de texte et le nombre de citations dans chaque catégorie de texte
              pour obtenir la liste complète des catégories disponibles, consultez le point de terminaison Categories

              • category
                Type: array (integer | null)[] | null
              • count
                Type: integer | null Format: int64

                Signed 64-bit integers (long type).

            • top_domains
              Type: array (object | null)[] | null

              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

              • count
                Type: integer | null Format: int64

                Signed 64-bit integers (long type).

              • domain
                Type: string | null
            • total_count
              Type: integer | null Format: int64

              quantité totale de résultats de notre base de données correspondant à votre requête

            • type
              Type: string | null

              type d'élément

          • min
            Type: number | null

            note minimale sur une échelle de répartition

          • type
            Type: string | null

            type d'élément

        • result_count
          Type: integer | null Format: int64

          nombre d'éléments dans le tableau de résultats

        • status_code
          Type: integer | null

          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

        • status_message
          Type: string | null

          message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici

        • time
          Type: string | null

          temps d'exécution, en secondes

    • tasks_count
      Type: integer | null Format: int64

      le nombre de tâches dans le tableau de tâches

    • tasks_error
      Type: integer | null Format: int64

      le nombre de tâches dans le tableau de tâches renvoyées avec une erreur

    • time
      Type: string | null

      temps d'exécution total, en secondes

    • version
      Type: string | null

      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
Request Example for post/v1/beta/dataforseo/content_analysis/rating_distribution/live
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/rating_distribution/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "logitech",
    "search_mode": "as_is",
    "internal_list_limit": 10
  }
]'

{
  "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,
          "min": null,
          "max": null,
          "metrics": {
            "type": null,
            "total_count": null,
            "rank": null,
            "top_domains": [
              "[Max Depth Exceeded]"
            ],
            "sentiment_connotations": null,
            "connotation_types": null,
            "text_categories": [
              "[Max Depth Exceeded]"
            ],
            "page_categories": [
              "[Max Depth Exceeded]"
            ],
            "page_types": null,
            "countries": null,
            "languages": null
          }
        }
      ]
    }
  ]
}

Opération réussie

Content Analysis – Rating Distribution API