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

Métriques agrégées croisées LLM Mentions 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

Métriques agrégées croisées LLM Mentions en temps réel

​

Compare les métriques de mentions de plusieurs cibles en un seul appel, regroupées par aggregation_key. Prend targets comme une liste de tableaux de cibles plutôt que le target unique de ses points de terminaison frères — les formes diffèrent, et les confondre est rejeté comme champ inconnu. ⚠️ target est un tableau d'objets, chacun {"domain": "..."} ou {"keyword": "..."} ; une chaîne seule est rejetée comme type incorrect et un tableau de chaînes avec 'Each target item must be an object'. Les champs de filtre proviennent de get_dataforseo_ai_llm_mentions_available_filters. 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. Exécuter post_dataforseo_ai_llm_mentions_aggregated_metrics_live une fois par cible coûte autant par appel ; utilisez donc ce point de terminaison quand la comparaison elle-même est le but.

Référence tarifaire

  • Mesure : coût de réponse déclaré.
  • Estimation de référence par requête : USD 0.101.
  • 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
obligatoire
application/json
  • Type: array object[]
    • targets
      Type: array object[]
      obligatoire

      tableau d'objets contenant les entités cibles avec les clés d'agrégation champ obligatoire vous pouvez spécifier jusqu'à 10, mais au moins 2 ensembles de paramètres cibles, chacun avec son aggregation_key ;exemple d'un tableau targets avec plusieurs entités : [{"aggregation_key":"bmw","target":[{"domain":"en.wikipedia.org","search_filter":"exclude"},{"keyword":"m5","match_type":"partial_match","search_scope":["answer"]}]},{"aggregation_key":"mercedes","target":[{"domain":"www.mercedes-benz.com","search_filter":"exclude"},{"keyword":"GLC","match_type":"word_match"}]}]

      • aggregation_key
        Type: string
        obligatoire

        clé d'agrégation pour regrouper les résultats champ obligatoire regroupe les résultats à des fins de comparaison et sert d'étiquette au groupe ; vous pouvez spécifier jusqu'à 250 caractères dans le champ aggregation_key

      • target
        Type: array object[]
        obligatoire

        tableau d'objets contenant les entités cibles champ obligatoire une seule cible peut contenir jusqu'à 10 entités de domaine et/ou de mot-clé

          • domain
            Type: string
            obligatoire

            domaine cible champ obligatoire si vous ne spécifiez pas de mot-clé vous pouvez spécifier jusqu'à 63 caractères dans le champ domain ; un domaine doit être spécifié sans https:// ni www.

          • include_subdomains
            Type: boolean

            indique si les sous-domaines du domaine cible seront inclus dans la recherche champ facultatif si défini sur true, les sous-domaines seront inclus dans la recherche valeur par défaut : false

          • keyword
            Type: string

            mot-clé cible champ obligatoire si vous ne spécifiez pas de domaine vous pouvez spécifier jusqu'à 250 caractères dans le champ keyword tous les %## seront décodés (le caractère ‘+’ sera décodé en espace) si vous devez utiliser le caractère “%” dans votre mot-clé, spécifiez-le comme “%25” ; si vous devez utiliser le caractère “+”, spécifiez-le comme “%2B” 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

          • match_type
            Type: string

            type de correspondance du mot-clé cible définit comment le mot-clé spécifié est mis en correspondance champ facultatif valeurs possibles : word_match - recherche plein texte des termes qui correspondent au mot-clé d'amorçage spécifié, avec des mots supplémentaires inclus avant, après ou à l'intérieur de l'expression clé (par exemple, une recherche de "light" renverra des résultats contenant "light bulb", "light switch") ; partial_match - recherche de sous-chaînes qui trouve toutes les occurrences contenant la séquence de caractères spécifiée, même si elle apparaît à l'intérieur d'un mot plus long (par exemple, une recherche de "light" renverra des résultats contenant "lighting", "highlight") ; valeur par défaut : word_match

          • search_filter
            Type: string

            Filtre de recherche d'entité : inclure ou exclure ; la valeur par défaut est inclure.

          • search_scope
            Type: array string[]

            Portée de la recherche. Entités de domaine : any, sources, search_results. Entités de mot-clé : any, question, answer, brand_entities, fan_out_queries. Valeur par défaut : any.

    • initial_dataset_filters
      Type: array

      tableau d'expressions de filtre appliquées avant l'agrégation champ facultatif vous pouvez utiliser ce tableau pour filtrer les expressions appliquées à la base de mentions brute avant l'agrégation, afin de limiter les lignes qui contribuent au résultat ;vous pouvez ajouter plusieurs filtres à la fois (8 filtres maximum) vous devez définir un opérateur logique and ou or entre les conditions les opérateurs suivants sont pris en charge : =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match vous pouvez utiliser l'opérateur % avec like et not_like pour correspondre à toute chaîne de zéro caractère ou plus exemple : ["ai_search_volume",">","1000"]la liste complète des filtres possibles est disponible ici. en savoir plus sur les filtres du jeu de données initial dans cet article du centre d'aide.

    • internal_list_limit
      Type: integer

      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 : sources_domain search_results_domain valeur minimale : 1 valeur maximale : 10 valeur par défaut : 5

    • language_code
      Type: string

      code de langue de recherche champ facultatif si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_name ; vous pouvez obtenir la liste des langues disponibles du moteur de recherche avec leur language_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages valeur par défaut : en Remarque : les données chat_gpt sont disponibles pour en uniquement

    • language_name
      Type: string

      nom complet de la langue de recherche champ facultatif si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_code ; si vous ne spécifiez pas ce champ, le language_code avec la valeur en sera utilisé par défaut ; vous pouvez obtenir la liste des langues disponibles du moteur de recherche avec leur language_name en effectuant une requête distincte sur https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages Remarque : les données chat_gpt sont disponibles en anglais uniquement

    • location_code
      Type: integer

      code d'emplacement de recherche champ facultatif si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name vous pouvez obtenir la liste des emplacements disponibles du moteur de recherche avec leur location_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages valeur par défaut : 2840 Remarque : les données chat_gpt sont disponibles pour 2840 uniquement

    • location_name
      Type: string

      nom complet de l'emplacement de recherche champ facultatif si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_code si vous ne spécifiez pas ce champ, le location_code avec la valeur 2840 sera utilisé par défaut ; 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/ai_optimization/llm_mentions/locations_and_languages Remarque : les données chat_gpt sont disponibles pour les États-Unis uniquement

    • platform
      Type: string

      plateforme cible champ facultatif valeurs possibles : chat_gpt, google valeur par défaut : google Remarque : les données renvoyées dépendent de la plateforme sélectionnée Remarque n° 2 : les données chat_gpt sont disponibles pour les États-Unis et en anglais uniquement

    • tag
      Type: string

      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

    Réponse réussie

    • cost
      Type: number

      coût total des tâches, USD

    • status_code
      Type: integer

      code d'état général vous pouvez trouver la liste complète des codes de réponse ici Remarque : nous recommandons vivement de concevoir un système pour gérer les conditions exceptionnelles ou d'erreur associées

    • status_message
      Type: string

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

    • tasks
      Type: array string[]

      tableau de tâches

    • tasks_count
      Type: integer

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

    • tasks_error
      Type: integer

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

    • tasks.cost
      Type: number

      coût de la tâche, USD

    • tasks.data
      Type: object

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

    • tasks.id
      Type: string

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

    • tasks.path
      Type: array string[]

      chemin de l'URL

    • tasks.result
      Type: array string[]

      tableau de résultats

    • tasks.result_count
      Type: integer

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

    • tasks.result.items
      Type: array string[]

      contient les données de mentions pertinentes

    • tasks.result.items.brand_entities_category
      Type: array string[]

      données sur les entités de marque pertinentes pour la cible tableau d'objets contenant des données sur les catégories d'entités de marque qui apparaissent dans les résultats de recherche liés aux requêtes LLM

    • tasks.result.items.brand_entities_category.ai_search_volume
      Type: integer

      taux actuel de volume de recherche IA d'un mot-clé en savoir plus sur cette métrique ici

    • tasks.result.items.brand_entities_category.impressions
      Type: integer

      taux actuel d'impressions IA d'un mot-clé

    • tasks.result.items.brand_entities_category.key
      Type: string

      identifiant de regroupement l'identifiant spécifique de la dimension de regroupement dans ce cas, le champ affiche une catégorie d'entité de marque trouvée

    • tasks.result.items.brand_entities_category.mentions
      Type: integer

      nombre total de mentions LLM le nombre de fois où le mot-clé ou le domaine cible ont été mentionnés en relation avec le domaine spécifique

    • tasks.result.items.brand_entities_category.type
      Type: string

      type de l'élément = 'group_element'

    • tasks.result.items.brand_entities_title
      Type: array string[]

      données sur les entités de marque pertinentes pour la cible tableau d'objets contenant des données sur les titres d'entités de marque qui apparaissent dans les résultats de recherche liés aux requêtes LLM

    • tasks.result.items.brand_entities_title.ai_search_volume
      Type: integer

      taux actuel de volume de recherche IA d'un mot-clé en savoir plus sur cette métrique ici

    • tasks.result.items.brand_entities_title.impressions
      Type: integer

      taux actuel d'impressions IA d'un mot-clé

    • tasks.result.items.brand_entities_title.key
      Type: string

      identifiant de regroupement l'identifiant spécifique de la dimension de regroupement dans ce cas, le champ affiche un titre d'entité de marque trouvé

    • tasks.result.items.brand_entities_title.mentions
      Type: integer

      nombre total de mentions LLM le nombre de fois où le mot-clé ou le domaine cible ont été mentionnés en relation avec le domaine spécifique

    • tasks.result.items.brand_entities_title.type
      Type: string

      type de l'élément = 'group_element'

    • tasks.result.items.key
      Type: string

      clé d'agrégation reçue dans un tableau POST

    • tasks.result.items.language
      Type: array string[]

      regroupement par langue tableau d'objets contenant des métriques de mentions segmentées par langue du contenu

    • tasks.result.items.language.ai_search_volume
      Type: integer

      taux actuel de volume de recherche IA d'un mot-clé en savoir plus sur cette métrique ici

    • tasks.result.items.language.impressions
      Type: integer

      taux actuel d'impressions IA d'un mot-clé

    • tasks.result.items.language.key
      Type: string

      identifiant de regroupement l'identifiant spécifique de la dimension de regroupement

    • tasks.result.items.language.mentions
      Type: integer

      nombre total de mentions LLM le nombre de fois où le mot-clé ou le domaine cible ont été mentionnés en relation avec cette clé de regroupement spécifique

    • tasks.result.items.language.type
      Type: string

      type de l'élément = 'group_element'

    • tasks.result.items.location
      Type: array string[]

      regroupement par emplacement tableau d'objets contenant des métriques de mentions segmentées par emplacement géographique

    • tasks.result.items.location.ai_search_volume
      Type: integer

      taux actuel de volume de recherche IA d'un mot-clé en savoir plus sur cette métrique ici

    • tasks.result.items.location.impressions
      Type: integer

      taux actuel d'impressions IA d'un mot-clé

    • tasks.result.items.location.key
      Type: string

      identifiant de regroupement l'identifiant spécifique de la dimension de regroupement

    • tasks.result.items.location.mentions
      Type: integer

      nombre total de mentions LLM le nombre de fois où le mot-clé ou le domaine cible ont été mentionnés en relation avec cette clé de regroupement spécifique

    • tasks.result.items.location.type
      Type: string

      type de l'élément = 'group_element'

    • tasks.result.items.platform
      Type: array string[]

      regroupement par plateforme tableau d'éléments de groupe contenant des métriques de mentions segmentées par plateforme IA

    • tasks.result.items.platform.ai_search_volume
      Type: integer

      taux actuel de volume de recherche IA d'un mot-clé en savoir plus sur cette métrique ici

    • tasks.result.items.platform.impressions
      Type: integer

      taux actuel d'impressions IA d'un mot-clé

    • tasks.result.items.platform.key
      Type: string

      identifiant de regroupement l'identifiant spécifique de la dimension de regroupement

    • tasks.result.items.platform.mentions
      Type: integer

      nombre total de mentions LLM le nombre de fois où le mot-clé ou le domaine cible ont été mentionnés en relation avec cette clé de regroupement spécifique

    • tasks.result.items.platform.type
      Type: string

      type de l'élément = 'group_element'

    • tasks.result.items.search_results_domain
      Type: array string[]

      principaux domaines de résultats de recherche trouvés pertinents pour la cible tableau d'objets contenant des données sur les principaux domaines qui apparaissent dans les résultats de recherche liés aux requêtes LLM

    • tasks.result.items.search_results_domain.ai_search_volume
      Type: integer

      taux actuel de volume de recherche IA d'un mot-clé en savoir plus sur cette métrique ici

    • tasks.result.items.search_results_domain.impressions
      Type: integer

      taux actuel d'impressions IA d'un mot-clé

    • tasks.result.items.search_results_domain.key
      Type: string

      identifiant de regroupement l'identifiant spécifique de la dimension de regroupement dans ce cas, le champ affiche un nom de domaine trouvé

    • tasks.result.items.search_results_domain.mentions
      Type: integer

      nombre total de mentions LLM le nombre de fois où le mot-clé ou le domaine cible ont été mentionnés en relation avec le domaine spécifique

    • tasks.result.items.search_results_domain.type
      Type: string

      type de l'élément = 'group_element'

    • tasks.result.items.sources_domain
      Type: array string[]

      principaux domaines sources trouvés pertinents pour la cible tableau d'objets contenant des données sur les principaux domaines cités comme sources dans les réponses LLM

    • tasks.result.items.sources_domain.ai_search_volume
      Type: integer

      taux actuel de volume de recherche IA d'un mot-clé en savoir plus sur cette métrique ici

    • tasks.result.items.sources_domain.impressions
      Type: integer

      taux actuel d'impressions IA d'un mot-clé

    • tasks.result.items.sources_domain.key
      Type: string

      identifiant de regroupement l'identifiant spécifique de la dimension de regroupement dans ce cas, le champ affiche un nom de domaine trouvé

    • tasks.result.items.sources_domain.mentions
      Type: integer

      nombre total de mentions LLM le nombre de fois où le mot-clé ou le domaine cible ont été mentionnés en relation avec le domaine spécifique

    • tasks.result.items.sources_domain.type
      Type: string

      type de l'élément = 'group_element'

    • tasks.result.total
      Type: object

      résumé des métriques agrégées de mentions contient les métriques agrégées globales de mentions LLM sur tous les domaines trouvés, regroupées par diverses dimensions

    • tasks.result.total.brand_entities_category
      Type: array string[]

      données sur les entités de marque pertinentes pour la cible tableau d'objets contenant des données sur les catégories d'entités de marque qui apparaissent dans les résultats de recherche liés aux requêtes LLM

    • tasks.result.total.brand_entities_category.ai_search_volume
      Type: integer

      taux actuel de volume de recherche IA d'un mot-clé en savoir plus sur cette métrique ici

    • tasks.result.total.brand_entities_category.impressions
      Type: integer

      taux actuel d'impressions IA d'un mot-clé

    • tasks.result.total.brand_entities_category.key
      Type: string

      identifiant de regroupement l'identifiant spécifique de la dimension de regroupement dans ce cas, le champ affiche une catégorie d'entité de marque trouvée

    • tasks.result.total.brand_entities_category.mentions
      Type: integer

      nombre total de mentions LLM le nombre de fois où le mot-clé ou le domaine cible ont été mentionnés en relation avec le domaine spécifique

    • tasks.result.total.brand_entities_category.type
      Type: string

      type de l'élément = 'group_element'

    • tasks.result.total.brand_entities_title
      Type: array string[]

      données sur les entités de marque pertinentes pour la cible tableau d'objets contenant des données sur les titres d'entités de marque qui apparaissent dans les résultats de recherche liés aux requêtes LLM

    • tasks.result.total.brand_entities_title.ai_search_volume
      Type: integer

      taux actuel de volume de recherche IA d'un mot-clé en savoir plus sur cette métrique ici

    • tasks.result.total.brand_entities_title.impressions
      Type: integer

      taux actuel d'impressions IA d'un mot-clé

    • tasks.result.total.brand_entities_title.key
      Type: string

      identifiant de regroupement l'identifiant spécifique de la dimension de regroupement dans ce cas, le champ affiche un titre d'entité de marque trouvé

    • tasks.result.total.brand_entities_title.mentions
      Type: integer

      nombre total de mentions LLM le nombre de fois où le mot-clé ou le domaine cible ont été mentionnés en relation avec le domaine spécifique

    • tasks.result.total.brand_entities_title.type
      Type: string

      type de l'élément = 'group_element'

    • tasks.result.total.language
      Type: array string[]

      regroupement par langue tableau d'objets contenant des métriques de mentions segmentées par langue du contenu

    • tasks.result.total.language.ai_search_volume
      Type: integer

      taux actuel de volume de recherche IA d'un mot-clé en savoir plus sur cette métrique ici

    • tasks.result.total.language.impressions
      Type: integer

      taux actuel d'impressions IA d'un mot-clé

    • tasks.result.total.language.key
      Type: string

      identifiant de regroupement l'identifiant spécifique de la dimension de regroupement

    • tasks.result.total.language.mentions
      Type: integer

      nombre total de mentions LLM le nombre de fois où le mot-clé ou le domaine cible ont été mentionnés en relation avec cette clé de regroupement spécifique

    • tasks.result.total.language.type
      Type: string

      type de l'élément = 'group_element'

    • tasks.result.total.location
      Type: array string[]

      regroupement par emplacement tableau d'objets contenant des métriques de mentions segmentées par emplacement géographique

    • tasks.result.total.location.ai_search_volume
      Type: integer

      taux actuel de volume de recherche IA d'un mot-clé en savoir plus sur cette métrique ici

    • tasks.result.total.location.impressions
      Type: integer

      taux actuel d'impressions IA d'un mot-clé

    • tasks.result.total.location.key
      Type: string

      identifiant de regroupement l'identifiant spécifique de la dimension de regroupement

    • tasks.result.total.location.mentions
      Type: integer

      nombre total de mentions LLM le nombre de fois où le mot-clé ou le domaine cible ont été mentionnés en relation avec cette clé de regroupement spécifique

    • tasks.result.total.location.type
      Type: string

      type de l'élément = 'group_element'

    • tasks.result.total.platform
      Type: array string[]

      regroupement par plateforme tableau d'éléments de groupe contenant des métriques de mentions segmentées par plateforme IA

    • tasks.result.total.platform.ai_search_volume
      Type: integer

      taux actuel de volume de recherche IA d'un mot-clé en savoir plus sur cette métrique ici

    • tasks.result.total.platform.impressions
      Type: integer

      taux actuel d'impressions IA d'un mot-clé

    • tasks.result.total.platform.key
      Type: string

      identifiant de regroupement l'identifiant spécifique de la dimension de regroupement

    • tasks.result.total.platform.mentions
      Type: integer

      nombre total de mentions LLM le nombre de fois où le mot-clé ou le domaine cible ont été mentionnés en relation avec cette clé de regroupement spécifique

    • tasks.result.total.platform.type
      Type: string

      type de l'élément = 'group_element'

    • tasks.result.total.search_results_domain
      Type: array string[]

      principaux domaines de résultats de recherche trouvés pertinents pour la cible tableau d'objets contenant des données sur les principaux domaines qui apparaissent dans les résultats de recherche liés aux requêtes LLM

    • tasks.result.total.search_results_domain.ai_search_volume
      Type: integer

      taux actuel de volume de recherche IA d'un mot-clé en savoir plus sur cette métrique ici

    • tasks.result.total.search_results_domain.impressions
      Type: integer

      taux actuel d'impressions IA d'un mot-clé

    • tasks.result.total.search_results_domain.key
      Type: string

      identifiant de regroupement l'identifiant spécifique de la dimension de regroupement dans ce cas, le champ affiche un nom de domaine trouvé

    • tasks.result.total.search_results_domain.mentions
      Type: integer

      nombre total de mentions LLM le nombre de fois où le mot-clé ou le domaine cible ont été mentionnés en relation avec le domaine spécifique

    • tasks.result.total.search_results_domain.type
      Type: string

      type de l'élément = 'group_element'

    • tasks.result.total.sources_domain
      Type: array string[]

      principaux domaines sources trouvés pertinents pour la cible tableau d'objets contenant des données sur les principaux domaines cités comme sources dans les réponses LLM

    • tasks.result.total.sources_domain.ai_search_volume
      Type: integer

      taux actuel de volume de recherche IA d'un mot-clé en savoir plus sur cette métrique ici

    • tasks.result.total.sources_domain.impressions
      Type: integer

      taux actuel d'impressions IA d'un mot-clé

    • tasks.result.total.sources_domain.key
      Type: string

      identifiant de regroupement l'identifiant spécifique de la dimension de regroupement dans ce cas, le champ affiche un nom de domaine trouvé

    • tasks.result.total.sources_domain.mentions
      Type: integer

      nombre total de mentions LLM le nombre de fois où le mot-clé ou le domaine cible ont été mentionnés en relation avec le domaine spécifique

    • tasks.result.total.sources_domain.type
      Type: string

      type de l'élément = 'group_element'

    • tasks.status_code
      Type: integer

      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

    • tasks.status_message
      Type: string

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

    • tasks.time
      Type: string

      temps d'exécution, en secondes

    • time
      Type: string

      temps d'exécution, en secondes

    • version
      Type: string

      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/ai_optimization/llm_mentions/cross_aggregated_metrics/live
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      {
        "aggregation_key": "",
        "target": [
          {}
        ]
      }
    ],
    "location_name": "",
    "location_code": 1,
    "language_name": "",
    "language_code": "",
    "platform": "",
    "initial_dataset_filters": [],
    "internal_list_limit": 1,
    "tag": ""
  }
]'

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ],
  "tasks.result.total": {},
  "tasks.result.total.location": [
    "string"
  ],
  "tasks.result.total.location.type": "string",
  "tasks.result.total.location.key": "string",
  "tasks.result.total.location.mentions": 1,
  "tasks.result.total.location.ai_search_volume": 1,
  "tasks.result.total.location.impressions": 1,
  "tasks.result.total.language": [
    "string"
  ],
  "tasks.result.total.language.type": "string",
  "tasks.result.total.language.key": "string",
  "tasks.result.total.language.mentions": 1,
  "tasks.result.total.language.ai_search_volume": 1,
  "tasks.result.total.language.impressions": 1,
  "tasks.result.total.platform": [
    "string"
  ],
  "tasks.result.total.platform.type": "string",
  "tasks.result.total.platform.key": "string",
  "tasks.result.total.platform.mentions": 1,
  "tasks.result.total.platform.ai_search_volume": 1,
  "tasks.result.total.platform.impressions": 1,
  "tasks.result.total.sources_domain": [
    "string"
  ],
  "tasks.result.total.sources_domain.type": "string",
  "tasks.result.total.sources_domain.key": "string",
  "tasks.result.total.sources_domain.mentions": 1,
  "tasks.result.total.sources_domain.ai_search_volume": 1,
  "tasks.result.total.sources_domain.impressions": 1,
  "tasks.result.total.search_results_domain": [
    "string"
  ],
  "tasks.result.total.search_results_domain.type": "string",
  "tasks.result.total.search_results_domain.key": "string",
  "tasks.result.total.search_results_domain.mentions": 1,
  "tasks.result.total.search_results_domain.ai_search_volume": 1,
  "tasks.result.total.search_results_domain.impressions": 1,
  "tasks.result.total.brand_entities_title": [
    "string"
  ],
  "tasks.result.total.brand_entities_title.type": "string",
  "tasks.result.total.brand_entities_title.key": "string",
  "tasks.result.total.brand_entities_title.mentions": 1,
  "tasks.result.total.brand_entities_title.ai_search_volume": 1,
  "tasks.result.total.brand_entities_title.impressions": 1,
  "tasks.result.total.brand_entities_category": [
    "string"
  ],
  "tasks.result.total.brand_entities_category.type": "string",
  "tasks.result.total.brand_entities_category.key": "string",
  "tasks.result.total.brand_entities_category.mentions": 1,
  "tasks.result.total.brand_entities_category.ai_search_volume": 1,
  "tasks.result.total.brand_entities_category.impressions": 1,
  "tasks.result.items": [
    "string"
  ],
  "tasks.result.items.key": "string",
  "tasks.result.items.location": [
    "string"
  ],
  "tasks.result.items.location.type": "string",
  "tasks.result.items.location.key": "string",
  "tasks.result.items.location.mentions": 1,
  "tasks.result.items.location.ai_search_volume": 1,
  "tasks.result.items.location.impressions": 1,
  "tasks.result.items.language": [
    "string"
  ],
  "tasks.result.items.language.type": "string",
  "tasks.result.items.language.key": "string",
  "tasks.result.items.language.mentions": 1,
  "tasks.result.items.language.ai_search_volume": 1,
  "tasks.result.items.language.impressions": 1,
  "tasks.result.items.platform": [
    "string"
  ],
  "tasks.result.items.platform.type": "string",
  "tasks.result.items.platform.key": "string",
  "tasks.result.items.platform.mentions": 1,
  "tasks.result.items.platform.ai_search_volume": 1,
  "tasks.result.items.platform.impressions": 1,
  "tasks.result.items.sources_domain": [
    "string"
  ],
  "tasks.result.items.sources_domain.type": "string",
  "tasks.result.items.sources_domain.key": "string",
  "tasks.result.items.sources_domain.mentions": 1,
  "tasks.result.items.sources_domain.ai_search_volume": 1,
  "tasks.result.items.sources_domain.impressions": 1,
  "tasks.result.items.search_results_domain": [
    "string"
  ],
  "tasks.result.items.search_results_domain.type": "string",
  "tasks.result.items.search_results_domain.key": "string",
  "tasks.result.items.search_results_domain.mentions": 1,
  "tasks.result.items.search_results_domain.ai_search_volume": 1,
  "tasks.result.items.search_results_domain.impressions": 1,
  "tasks.result.items.brand_entities_title": [
    "string"
  ],
  "tasks.result.items.brand_entities_title.type": "string",
  "tasks.result.items.brand_entities_title.key": "string",
  "tasks.result.items.brand_entities_title.mentions": 1,
  "tasks.result.items.brand_entities_title.ai_search_volume": 1,
  "tasks.result.items.brand_entities_title.impressions": 1,
  "tasks.result.items.brand_entities_category": [
    "string"
  ],
  "tasks.result.items.brand_entities_category.type": "string",
  "tasks.result.items.brand_entities_category.key": "string",
  "tasks.result.items.brand_entities_category.mentions": 1,
  "tasks.result.items.brand_entities_category.ai_search_volume": 1,
  "tasks.result.items.brand_entities_category.impressions": 1
}

Réponse réussie

Live LLM Mentions Cross Aggregated Metrics