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

Configurer les tâches ‘DataForSEO Trends Demography’ en temps réel

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

Configurer les tâches ‘DataForSEO Trends Demography’ en temps réel

​

L'audience Google Trends derrière un mot-clé : répartitions par âge et par genre sur la même fenêtre que celle utilisée par post_dataforseo_keywords_trends_explore_live, avec les mêmes arguments type et de date. Enveloppé dans l'enveloppe DataForSEO : les données dans tasks[0].result, l'issue dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200. Peu coûteux comme son homologue. Pour le lieu plutôt que le profil, utilisez post_dataforseo_keywords_trends_subregion_interests_live.

Référence tarifaire

  • Mesure : coût de réponse déclaré.
  • Estimation de référence par requête : USD 0.0024.
  • Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à 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)[]
    • date_from
      Type: string | null

      date de début de l'intervalle de temps
      champ facultatif
      si vous n'indiquez pas ce champ, le jour et le mois actuels de l'année précédente sont utilisés par défaut
      valeur minimale pour le type web : 2004-01-01
      valeur minimale pour les autres types : 2008-01-01
      format de date : "yyyy-mm-dd"
      exemple :
      "2019-01-15"

    • date_to
      Type: string | null

      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"

    • keywords
      Type: array string[]

      mots-clés
      champ obligatoire
      nombre maximal de mots-clés que vous pouvez indiquer : 5
      évitez les symboles et caractères spéciaux (par exemple, symboles UTF, emojis) ;
      si vous indiquez des caractères non latins, vous obtiendrez des données pour les pays où ils sont utilisés

      en savoir plus sur les règles et limites des champs keyword et keywords dans les API DataForSEO dans cet article du centre d'aide

    • location_code
      Type: integer | null

      code d'emplacement du moteur de recherche
      champ facultatif
      si vous n'utilisez pas ce champ, vous recevrez des résultats globaux
      si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name
      vous pouvez obtenir la liste des emplacements disponibles des moteurs de recherche avec leur location_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
      notez que les données seront fournies pour le pays auquel appartient le location_code indiqué ;
      exemple :
      2840

    • location_name
      Type: string | null

      nom complet de l'emplacement du moteur de recherche
      champ facultatif
      si vous n'utilisez pas ce champ, vous recevrez des résultats globaux
      si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_code
      vous pouvez obtenir la liste des emplacements disponibles du moteur de recherche avec leur location_name en effectuant une requête distincte sur https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
      notez que les données seront fournies pour le pays auquel appartient le location_name indiqué ;
      exemple :
      United Kingdom

    • 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

    • time_range
      Type: string | null

      plages de temps prédéfinies
      champ facultatif
      si vous indiquez les paramètres date_from ou date_to, ce champ sera ignoré lors de la définition d'une tâche
      valeurs possibles pour tous les paramètres type :
      past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years

    • type
      Type: string | null

      type d'élément

Réponses
  • 200
    Type: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsDemographyLiveResponseInfo
    • 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_KeywordsDataDataforseoTrendsDemographyLiveTaskInfo
        • 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

          • datetime
            Type: string | null

            date et heure de réception du résultat
            au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
            exemple :
            2019-11-15 12:57:46 +00:00

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

            contient la popularité du mot-clé et les données associées

            • Type: object | null · Response36Afe1097B20_DataforseoTrendsDemographyElementItem
                • Type: object · Response36Afe1097B20_DataforseoTrendsDemographyElementItem
                  • type
                    Discriminateur
                    Type: string | null

                    type d'élément

                  • demography
                    Type: object | null · Response36Afe1097B20_Demography

                    ventilation démographique des données de popularité des mots-clés pour chaque terme spécifié
                    contient les données de popularité des mots-clés par âge et par genre

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

                      répartition de la popularité des mots-clés par âge

                      • keyword
                        Type: string | null

                        mot-clé pertinent pour lequel les données démographiques sont fournies

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

                        contient la tranche d'âge et les valeurs de popularité du mot-clé correspondantes

                        • type
                          Type: string | null

                          type d'élément

                        • value
                          Type: integer | null

                          taux de popularité du mot-clé dans la tranche d'âge spécifiée
                          avec cette value, vous pouvez comprendre à quel point un mot-clé est populaire dans chaque tranche d'âge ;
                          calcul : nous déterminons la valeur de popularité la plus élevée pour le mot-clé pertinent dans tous les groupes d'âge, puis exprimons toutes les autres valeurs en pourcentage de cette valeur la plus élevée (100) ;
                          une valeur de 100 correspond à la popularité la plus élevée du terme
                          une valeur de 0 signifie qu'il n'y avait pas assez de données pour ce terme

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

                      répartition de la popularité des mots-clés par genre

                      • keyword
                        Type: string | null

                        mot-clé pertinent pour lequel les données démographiques sont fournies

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

                        contient la tranche d'âge et les valeurs de popularité du mot-clé correspondantes

                        • type
                          Type: string | null

                          type d'élément

                        • value
                          Type: integer | null

                          taux de popularité du mot-clé dans la tranche d'âge spécifiée
                          avec cette value, vous pouvez comprendre à quel point un mot-clé est populaire dans chaque tranche d'âge ;
                          calcul : nous déterminons la valeur de popularité la plus élevée pour le mot-clé pertinent dans tous les groupes d'âge, puis exprimons toutes les autres valeurs en pourcentage de cette valeur la plus élevée (100) ;
                          une valeur de 100 correspond à la popularité la plus élevée du terme
                          une valeur de 0 signifie qu'il n'y avait pas assez de données pour ce terme

                  • demography_comparison
                    Type: object | null · Response36Afe1097B20_DemographyComparisonInfo

                    comparaison des données démographiques sur la popularité des mots-clés pour les paramètres spécifiés
                    contient les données de popularité des mots-clés par âge et par genre
                    si vous avez indiqué un seul mot-clé, la valeur sera null

                    • age
                      Type: object | null

                      type d'élément

                      • propertyName
                        Type: array (integer | null)[] | null
                    • gender
                      Type: object | null

                      type d'élément

                      • propertyName
                        Type: array (integer | null)[] | null
                  • keywords
                    Type: array (string | null)[] | null

                    mots-clés dans un tableau POST

                  • position
                    Type: integer | null

                    l'alignement de l'élément
                    peut prendre les valeurs suivantes : 1, 2, 3, 4, etc.

          • items_count
            Type: integer | null Format: int64

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

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

            mots-clés dans un tableau POST

          • language_code
            Type: string | null

            code de langue dans un tableau POST
            s'il n'y a pas de données, la valeur est_nulln

          • location_code
            Type: integer | null

            code d'emplacement dans un tableau POST
            s'il n'y a pas de données, la valeur est_nulln

          • 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/keywords_data/dataforseo_trends/demography/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/demography/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "rugby",
      "cricket"
    ],
    "date_from": "2023-01-01",
    "date_to": "2024-01-01",
    "type": "web",
    "location_name": "United States"
  }
]'

{
  "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": [
        {
          "keywords": [
            null
          ],
          "type": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "keywords": "[Max Depth Exceeded]",
              "demography": "[Max Depth Exceeded]",
              "demography_comparison": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Setting Live ‘DataForSEO Trends Demography’ Tasks