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

Content Analysis – API de recherche

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 recherche

​

Liste les pages individuelles citant un mot-clé, plutôt que les totaux. Chaque élément porte url, domain, main_domain, url_rank, domain_rank, spam_score, fetch_time, country, language, score et page_category, ainsi que total_count et items_count. filters accepte les champs listés par get_dataforseo_content_available_filters. Pour des décomptes et des répartitions plutôt que des pages, utilisez post_dataforseo_content_summary_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)[]
    • filters
      Type: array (object | null)[] | null

      tableau de paramètres de filtrage des résultats
      champ facultatif
      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, 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 :
      ["country","=", "US"]

      [["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]]

      [["domain_rank",">",800],
      "and",
      [["page_types","has","ecommerce"],
      "or",

      ["content_info.text_category","has",10994]]]
      pour plus d'informations sur les filtres, consultez Content Analysis API - Filters

      Objet vide
    • 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
    • limit
      Type: integer | null

      nombre maximal de citations renvoyées
      champ facultatif
      valeur par défaut : 100
      valeur maximale : 1000

    • offset
      Type: integer | null

      décalage dans le tableau de résultats des citations renvoyées
      champ facultatif
      valeur par défaut : 0
      si vous indiquez la valeur 10, les dix premières citations du tableau de résultats seront omises et les données seront fournies pour les citations suivantes
      Remarque : nous recommandons d'utiliser ce paramètre uniquement pour récupérer jusqu'à 10 000 résultats
      pour récupérer plus de 10 000 résultats, utilisez plutôt le offset_token.

    • offset_token
      Type: string | null

      jeton de décalage pour les requêtes suivantes
      champ facultatif
      fourni dans le champ identique de la réponse à chaque requête ;
      utilisez ce paramètre pour éviter les délais d'attente lorsque vous essayez d'obtenir plus de 10 000 résultats en une seule requête ;
      en indiquant la valeur unique de offset_token du tableau de réponse, vous obtiendrez les résultats suivants de la tâche initiale ;
      les valeurs de offset_token sont uniques pour chaque tâche suivante
      Remarque : si le offset_token est indiqué dans la requête, tous les autres paramètres à l'exception de limit ne seront pas pris en compte lors du traitement de la tâche
      en savoir plus sur ce paramètre dans notre centre d'aide

    • order_by
      Type: array string[] | null

      règles de tri des résultats
      champ facultatif
      vous pouvez utiliser les mêmes valeurs que dans le tableau filters pour trier les résultats
      types de tri possibles :
      asc - les résultats seront triés par ordre croissant
      desc - les résultats seront triés par ordre décroissant
      vous devez utiliser une virgule pour définir un type de tri
      exemple :
      ["content_info.sentiment_connotations.anger,desc"]
      règle par défaut :
      ["content_info.sentiment_connotations.anger,desc"]
      notez que vous pouvez définir au maximum trois règles de tri dans une seule requête
      vous devez utiliser une virgule pour séparer plusieurs règles de tri
      exemple :
      ["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]

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

    • rank_scale
      Type: string | null

      définit l'échelle utilisée pour calculer et afficher les valeurs de domain_rank et url_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

    • 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_ContentAnalysisSearchLiveResponseInfo
    • 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_ContentAnalysisSearchLiveTaskInfo
        • 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

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

            contient les citations et les données associées

            • content_info
              Type: object | null · Response36Afe1097B20_AnalysisContentInfo

              contient des données sur les citations de l'url donnée

              • author
                Type: string | null

                auteur du contenu

              • connotation_types
                Type: object | null

                types de connotation
                contient les types de sentiments (polarité du sentiment) associés à la citation donnée et l'indice de probabilité 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).

              • content_quality_score
                Type: integer | null

                score de qualité du contenu
                cette valeur est calculée en fonction du nombre de mots, de phrases et de caractères que contient le contenu

              • content_type
                Type: string | null

                type de contenu
                exemple :
                page_content, comment

              • date_published
                Type: string | null

                date et heure de publication du contenu
                au format UTC : "yyyy-mm-dd hh-mm-ss +00:00"
                exemple :
                2017-01-24 13:20:59 +00:00

              • group_date
                Type: string | null

                date et heure du groupe de citations
                indique la date de publication du contenu ou la date et heure auxquelles notre crawler a visité la page pour la première fois ;
                ce champ peut servir à regrouper les citations par date et à afficher les tendances de citation ;
                la date et l'heure sont fournies au format UTC : "yyyy-mm-dd hh-mm-ss +00:00"
                exemple :
                2017-01-24 13:20:59 +00:00

              • highlighted_text
                Type: string | null

                texte mis en évidence de l'snippet

              • language
                Type: string | null

                langue principale du domaine
                pour obtenir la liste complète des langues disponibles, consultez le point de terminaison Languages

              • level
                Type: integer | null

                niveau de titre title
                indique le niveau de balise h de 1 (haut) à 6 (bas)

              • main_title
                Type: string | null

                titre de la page

              • previous_title
                Type: string | null

                titre du bloc de contenu précédent

              • rating
                Type: object | null · Response36Afe1097B20_ContententRatingInfo

                notation du contenu
                notation associée à content_info

                • max_rating_value
                  Type: number | null Format: double

                  valeur maximale pour le nom de la note

                • name
                  Type: string | null

                  nom de la note vous trouverez ici les éléments suivants : Max5, Percents, CustomMax

                • rating_count
                  Type: integer | null Format: int64

                  nombre de votes

                • rating_value
                  Type: number | null Format: double

                  la valeur de la note

                • relative_rating
                  Type: number | null Format: double

                  note relative

              • semantic_location
                Type: string | null

                emplacement sémantique
                indique l'élément sémantique du HTML où se trouve la citation du mot-clé cible
                exemple :
                article, header

              • sentiment_connotations
                Type: object | null

                connotations de sentiment
                contient les sentiments (réactions émotionnelles) associés à la citation donnée et l'indice de probabilité 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).

              • snippet
                Type: string | null

                extrait du contenu

              • snippet_length
                Type: integer | null

                longueur en caractères de l'extrait

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

                métriques d'engagement sur les réseaux sociaux
                données sur les interactions sur les réseaux sociaux associées au contenu, basées sur des intégrations de sites web développées et prises en charge par les plateformes de réseaux sociaux

                • like_count
                  Type: integer | null Format: int64

                  nombre de mentions J'aime

                • type
                  Type: string | null

                  type d'élément

              • text_category
                Type: array integer[] | null

                catégorie du texte
                pour obtenir la liste complète des catégories disponibles, consultez le point de terminaison Categories

              • title
                Type: string | null

                titre du résultat

            • country
              Type: string | null

              code pays du pays d'enregistrement du domaine
              pour obtenir la liste complète des pays disponibles, consultez le point de terminaison Locations

            • domain
              Type: string | null

              nom de domaine

            • domain_rank
              Type: integer | null

              rang du domain
              cette valeur repose sur les données de backlinks du domaine donné issues du DataForSEO Backlink Index ;
              domain_rank est calculé selon la méthode de classement des nœuds dans une base de données liée, un principe utilisé dans l'algorithme PageRank original de Google
              en savoir plus sur la métrique et son mode de calcul dans cet article du centre d'aide

            • fetch_time
              Type: string | null

              date et heure auxquelles notre robot d'exploration a visité la page
              au format UTC : "yyyy-mm-dd hh-mm-ss +00:00"
              exemple :
              2017-01-24 13:20:59 +00:00

            • language
              Type: string | null

              langue principale du domaine
              pour obtenir la liste complète des langues disponibles, consultez le point de terminaison Languages

            • main_domain
              Type: string | null

              domaine principal

            • page_category
              Type: array integer[] | null

              contient toutes les catégories de page pertinentes
              catégories de produits et de services pertinentes pour la page
              pour obtenir la liste complète des catégories disponibles, consultez le point de terminaison Categories

            • page_types
              Type: array string[] | null

              types de page

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

              notes trouvées sur la page
              toutes les notes trouvées sur la page selon les microdonnées

              • max_rating_value
                Type: number | null Format: double

                valeur maximale pour le nom de la note

              • name
                Type: string | null

                nom de la note vous trouverez ici les éléments suivants : Max5, Percents, CustomMax

              • rating_count
                Type: integer | null Format: int64

                nombre de votes

              • rating_value
                Type: number | null Format: double

                la valeur de la note

              • relative_rating
                Type: number | null Format: double

                note relative

            • score
              Type: number | null

              score de proéminence de la citation
              cette valeur repose sur la présence de url_rank, domain_rank, keyword dans title, main_title, url, snippet
              plus le score est élevé, plus la citation associée a de valeur

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

              métriques d'engagement sur les réseaux sociaux
              données sur les interactions sur les réseaux sociaux associées au contenu, basées sur des intégrations de sites web développées et prises en charge par les plateformes de réseaux sociaux

              • like_count
                Type: integer | null Format: int64

                nombre de mentions J'aime

              • type
                Type: string | null

                type d'élément

            • spam_score
              Type: integer | null

              score de spam des backlinks de l'url
              cette valeur repose sur les données de backlinks de l'URL donnée issues du DataForSEO Backlink Index ;
              en savoir plus sur le mode de calcul de cette métrique sur cette page du centre d'aide

            • type
              Type: string | null

              type d'élément

            • url
              Type: string | null

              URL où la citation a été trouvée

            • url_rank
              Type: integer | null

              rang de l'url
              cette valeur repose sur les données de backlinks de l'URL donnée issues du DataForSEO Backlink Index ;
              url_rank est calculé selon la méthode de classement des nœuds dans une base de données liée, un principe utilisé dans l'algorithme PageRank original de Google
              en savoir plus sur la métrique et son mode de calcul dans cet article du centre d'aide

          • items_count
            Type: integer | null Format: int64

            le nombre de résultats renvoyés dans le tableau items

          • offset_token
            Type: string | null

            jeton de décalage pour les requêtes suivantes
            vous pouvez utiliser la chaîne fournie dans ce champ pour obtenir les résultats suivants de la tâche initiale ;
            remarque : les valeurs d'offset_token sont uniques pour chaque tâche suivante

          • total_count
            Type: integer | null Format: int64

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

        • 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/search/live
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword_fields": {
      "snippet": "logitech"
    },
    "keyword": "logitech",
    "page_type": [
      "ecommerce",
      "news",
      "blogs",
      "message-boards",
      "organization"
    ],
    "search_mode": "as_is",
    "filters": [
      "main_domain",
      "=",
      "reviewfinder.ca"
    ],
    "order_by": [
      "content_info.sentiment_connotations.anger,desc"
    ],
    "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": [
        {
          "offset_token": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "url": null,
              "domain": null,
              "main_domain": null,
              "url_rank": null,
              "spam_score": null,
              "domain_rank": null,
              "fetch_time": null,
              "country": null,
              "language": null,
              "score": null,
              "page_category": [
                "[Max Depth Exceeded]"
              ],
              "page_types": [
                "[Max Depth Exceeded]"
              ],
              "ratings": [
                "[Max Depth Exceeded]"
              ],
              "social_metrics": [
                "[Max Depth Exceeded]"
              ],
              "content_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Content Analysis – Search API