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

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

LLM Mentions en temps réel

​

Les réponses individuelles dans lesquelles un assistant a mentionné votre cible. Renvoie total_count, current_offset, search_after_token et items — paginez avec le jeton, pas avec offset, au-delà des premières pages. ⚠️ 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. Pour des comptages plutôt que les mentions elles-mêmes, utilisez post_dataforseo_ai_llm_mentions_aggregated_metrics_live.

Référence tarifaire

  • Mesure : coût de réponse déclaré.
  • Estimation de référence par requête : USD 0.701.
  • 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 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.

    • filters
      Type: array

      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 : =, 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 ou plusieurs caractères exemple : ["ai_search_volume",">","1000"] La liste complète des filtres possibles est disponible ici.

    • 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

    • limit
      Type: integer

      le nombre maximal d'objets renvoyés champ facultatif valeur par défaut : 100 valeur maximale : 1000

    • 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

    • offset
      Type: integer

      décalage dans le tableau de résultats des données de mentions renvoyées champ facultatif valeur par défaut : 0 exemple : si vous spécifiez la valeur 10, les dix premiers objets de mentions du tableau de résultats seront omis et les données seront fournies pour les objets suivants ; Remarque : la valeur maximale est 9 000, utilisez search_after_token si vous souhaitez décaler davantage de résultats

    • order_by
      Type: array string[]

      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 : ["ai_search_volume,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

    • 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

    • search_after_token
      Type: string

      jeton pour les requêtes suivantes champ facultatif fourni dans le champ identical 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 20 000 résultats en une seule requête ; en spécifiant la valeur unique search_after_token du tableau de réponse, vous obtiendrez les résultats suivants de la tâche initiale ; les valeurs de search_after_token sont uniques pour chaque tâche suivante ; Remarque : si search_after_token est spécifié dans la requête, tous les autres paramètres doivent être identiques à ceux de la requête précédente

    • 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.current_offset
      Type: integer

      le nombre d'objets de mentions omis dans le tableau items

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

      contient les données de mentions pertinentes

    • tasks.result.items_count
      Type: integer

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

    • tasks.result.items.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.answer
      Type: string

      réponse pertinente au format markdown contenu du résultat formaté dans le langage de balisage markdown

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

      tableau d'entités de marque contient des informations sur les marques mentionnées dans la réponse

    • tasks.result.items.brand_entities.category
      Type: string

      catégorie de la marque

    • tasks.result.items.brand_entities.position
      Type: integer

      position dans les résultats

    • tasks.result.items.brand_entities.title
      Type: string

      nom de la marque

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

      tableau de requêtes dérivées contient des requêtes de recherche associées dérivées de la requête principale afin de fournir une réponse plus complète

    • tasks.result.items.first_response_at
      Type: string

      date et heure auxquelles les données de la réponse ont été enregistrées pour la première fois au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” exemple : 2025-10-21 06:25:30 +00:00

    • tasks.result.items.language_code
      Type: string

      code de langue dans un tableau POST

    • tasks.result.items.last_response_at
      Type: string

      date et heure de la dernière mise à jour des données de la réponse au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” exemple : 2025-10-21 06:25:30 +00:00

    • tasks.result.items.location_code
      Type: integer

      code de localisation dans un tableau POST

    • tasks.result.items.model_name
      Type: string

      nom du modèle d'IA à partir duquel les données ont été récupérées Remarque : pour le type de plateforme google, la valeur est toujours google_ai_overview

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

      taux mensuels de volume de recherche IA tableau d'objets avec les taux de volume de recherche IA pour un mois donné de l'année

    • tasks.result.items.monthly_searches.month
      Type: integer

      mois

    • tasks.result.items.monthly_searches.search_volume
      Type: integer

      taux de volume de recherche IA pour un mois donné de l'année en savoir plus sur cette métrique ici

    • tasks.result.items.monthly_searches.year
      Type: integer

      année

    • tasks.result.items.platform
      Type: string

      plateforme reçue dans un tableau POST

    • tasks.result.items.question
      Type: string

      question pertinente

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

      tableau de résultats de recherche toutes les sorties de recherche web que le modèle a récupérées lors de la recherche d'informations, y compris les doublons et les entrées inutilisées

    • tasks.result.items.search_results.breadcrumb
      Type: string

      fil d'Ariane

    • tasks.result.items.search_results.description
      Type: string

      description du résultat

    • tasks.result.items.search_results.domain
      Type: string

      domaine du résultat

    • tasks.result.items.search_results.position
      Type: integer

      position dans les résultats

    • tasks.result.items.search_results.publication_date
      Type: string

      date et heure de publication du résultat au format : “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” exemple : 2019-11-15 12:57:46 +00:00

    • tasks.result.items.search_results.title
      Type: string

      titre du résultat

    • tasks.result.items.search_results.url
      Type: string

      URL du résultat

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

      tableau de sources les sources que le modèle a citées ou utilisées dans sa réponse finale

    • tasks.result.items.sources.domain
      Type: string

      domaine source

    • tasks.result.items.sources.markdown
      Type: string

      contenu de l'élément au format markdown contenu du résultat formaté dans le langage de balisage markdown

    • tasks.result.items.sources.position
      Type: integer

      position dans les résultats

    • tasks.result.items.sources.publication_date
      Type: string

      date et heure de publication du résultat au format : “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” exemple : 2019-11-15 12:57:46 +00:00

    • tasks.result.items.sources.snippet
      Type: string

      description de la source

    • tasks.result.items.sources.source_name
      Type: string

      nom de la source

    • tasks.result.items.sources.thumbnail
      Type: string

      miniature de la source

    • tasks.result.items.sources.title
      Type: string

      titre de la source

    • tasks.result.items.sources.url
      Type: string

      URL de la source

    • tasks.result.search_after_token
      Type: string

      jeton pour les requêtes suivantes en définissant le search_after_token unique lors de la création d'une nouvelle tâche, vous obtiendrez les résultats suivants de la tâche initiale ; les valeurs de search_after_token sont uniques pour chaque tâche suivante

    • tasks.result.total_count
      Type: integer

      nombre total de résultats pertinents pour la requête

    • 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/search/live
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": [
      {}
    ],
    "location_name": "",
    "location_code": 1,
    "language_name": "",
    "language_code": "",
    "platform": "",
    "filters": [],
    "order_by": [
      ""
    ],
    "offset": 1,
    "search_after_token": "",
    "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_count": 1,
  "tasks.result.current_offset": 1,
  "tasks.result.search_after_token": "string",
  "tasks.result.items_count": 1,
  "tasks.result.items": [
    "string"
  ],
  "tasks.result.items.platform": "string",
  "tasks.result.items.model_name": "string",
  "tasks.result.items.location_code": 1,
  "tasks.result.items.language_code": "string",
  "tasks.result.items.question": "string",
  "tasks.result.items.answer": "string",
  "tasks.result.items.sources": [
    "string"
  ],
  "tasks.result.items.sources.snippet": "string",
  "tasks.result.items.sources.source_name": "string",
  "tasks.result.items.sources.thumbnail": "string",
  "tasks.result.items.sources.markdown": "string",
  "tasks.result.items.sources.position": 1,
  "tasks.result.items.sources.title": "string",
  "tasks.result.items.sources.domain": "string",
  "tasks.result.items.sources.url": "string",
  "tasks.result.items.sources.publication_date": "string",
  "tasks.result.items.search_results": [
    "string"
  ],
  "tasks.result.items.search_results.description": "string",
  "tasks.result.items.search_results.breadcrumb": "string",
  "tasks.result.items.search_results.position": 1,
  "tasks.result.items.search_results.title": "string",
  "tasks.result.items.search_results.domain": "string",
  "tasks.result.items.search_results.url": "string",
  "tasks.result.items.search_results.publication_date": "string",
  "tasks.result.items.ai_search_volume": 1,
  "tasks.result.items.monthly_searches": [
    "string"
  ],
  "tasks.result.items.monthly_searches.year": 1,
  "tasks.result.items.monthly_searches.month": 1,
  "tasks.result.items.monthly_searches.search_volume": 1,
  "tasks.result.items.first_response_at": "string",
  "tasks.result.items.last_response_at": "string",
  "tasks.result.items.brand_entities": [
    "string"
  ],
  "tasks.result.items.brand_entities.position": 1,
  "tasks.result.items.brand_entities.title": "string",
  "tasks.result.items.brand_entities.category": "string",
  "tasks.result.items.fan_out_queries": [
    "string"
  ]
}

Réponse réussie

Live LLM Mentions