v0.2.0-beta

OpenAPI 3.1.0

Métriques agrégé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

post/v1/beta/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live

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

À quelle fréquence les assistants mentionnent votre cible, en totaux plutôt qu'en réponses individuelles : total et items. ⚠️ 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. C'est le chiffre de visibilité principal ; post_dataforseo_ai_llm_mentions_search_live montre les réponses derrière, et post_dataforseo_ai_llm_mentions_cross_metrics_live compare plusieurs cibles à la fois.

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[]
- target
  Type: array object[]
  obligatoire
  
  tableau d'objets contenant les entités cibles champ obligatoire vous pouvez spécifier jusqu'à 10 entités (objets) dans le champ target une entité cible peut contenir soit un domaine, soit un mot-clé, ainsi que les paramètres associés. Exemples : tableau targets avec une entité de domaine [{"domain": "en.wikipedia.org", "search_filter": "exclude"}] tableau targets avec une entité de mot-clé [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}] tableau targets avec plusieurs entités [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]
  
  domain
  Type: string
  obligatoire
  
  domaine cible champ obligatoire si vous ne spécifiez pas keyword 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 domain 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 keyword, spécifiez-le comme “%25” ; si vous devez utiliser le caractère “+” dans votre keyword, spécifiez-le comme “%2B”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
  
  match_type
  Type: string
  
  type de correspondance du mot-clé cible champ facultatif word_match - recherche plein texte des termes qui correspondent au mot-clé initial spécifié avec des mots supplémentaires inclus avant, après ou à l'intérieur de l'expression clé (par ex., une recherche sur “light” renverra des résultats avec “light bulb”, “light switch”) ; partial_match - recherche de sous-chaîne 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 ex., une recherche sur “light” renverra des résultats avec “lighting”, “highlight”) ; valeurs possibles : word_match, partial_match 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 : 20 valeur par défaut : 10
- 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[]

tableau de résultats de pages individuelles contenant des métriques détaillées de mentions pour chacune des pages principales trouvées dans ce cas, est égal à null

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

post/v1/beta/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": [
      {
        "domain": "en.wikipedia.org"
      }
    ]
  }
]'

Afficher le schéma

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

Réponse réussie

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

AuthentificationRequired

DataForSEO

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

Référence tarifaire