Felo API PlatformFelo API Platform
Tutti gli endpoint di DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

LLM Mentions live

Felo API Support
MIT
Server:https://openapi.felo.ai
Librerie client
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operazioni

LLM Mentions live

​

Le singole risposte in cui un assistente ha menzionato il target. Restituisce total_count, current_offset, search_after_token e items: scorrere con il token, non con offset, oltre le prime pagine. ⚠️ target è un array di oggetti, ciascuno {"domain": "..."} o {"keyword": "..."}; una semplice stringa viene rifiutata come tipo errato e un array di stringhe con 'Each target item must be an object'. I campi filtro provengono da get_dataforseo_ai_llm_mentions_available_filters. Incapsulato nell'involucro di DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code - una richiesta rifiutata restituisce comunque HTTP 200. Per i conteggi anziché le menzioni stesse usare post_dataforseo_ai_llm_mentions_aggregated_metrics_live.

Riferimento prezzi

  • Misurazione: costo della risposta comunicato.
  • Stima di riferimento per richiesta: USD 0.701.
  • Moltiplicatore cliente di riferimento: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.

Solo metadati di riferimento, non un preventivo dell'account, né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Corpo
obbligatorio
application/json
  • Tipo: array object[]
    • target
      Tipo: array object[]
      obbligatorio

      Array di oggetti contenenti entità di destinazione. Campo obbligatorio. Nel campo target puoi specificare fino a 10 entità (oggetti). Una singola entità di destinazione può contenere un dominio oppure una keyword e i relativi parametri. Esempi: array target con un'entità dominio [{"domain": "en.wikipedia.org", "search_filter": "exclude"}] array target con un'entità keyword [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}] array target con più entità [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]

        • domain
          Tipo: string
          obbligatorio

          Dominio di destinazione. Campo obbligatorio se non specifichi keyword. Nel campo domain puoi specificare fino a 63 caratteri; un dominio deve essere specificato senza https:// e www.

        • include_subdomains
          Tipo: boolean

          Indica se i sottodomini del dominio di destinazione saranno inclusi nella ricerca. Campo facoltativo. Se impostato su true, i sottodomini saranno inclusi nella ricerca. Valore predefinito: false.

        • keyword
          Tipo: string

          Keyword di destinazione. Campo obbligatorio se non specifichi domain. Nel campo keyword puoi specificare fino a 250 caratteri. Tutti i %## vengono decodificati (inoltre il carattere ‘+’ viene decodificato in uno spazio). Se devi usare il carattere “%” per la tua keyword, specificalo come “%25”; se devi usare il carattere “+” per la tua keyword, specificalo come “%2B”. Per saperne di più su regole e limiti dei campi keyword e keywords nelle API DataForSEO, consulta questo articolo del Help Center.

        • match_type
          Tipo: string

          Tipo di corrispondenza della keyword di destinazione; definisce come viene confrontata la keyword specificata. Campo facoltativo. Valori possibili: word_match – ricerca full-text di termini che corrispondono alla keyword seed specificata, con parole aggiuntive incluse prima, dopo o all'interno della frase chiave (ad es. la ricerca di “light” restituisce risultati con “light bulb”, “light switch”); partial_match – ricerca per sottostringa che trova tutte le occorrenze contenenti la sequenza di caratteri specificata, anche se compare all'interno di una parola più lunga (ad es. la ricerca di “light” restituisce risultati con “lighting”, “highlight”); valore predefinito: word_match

        • search_filter
          Tipo: string

          Filtro di ricerca dell'entità: include o exclude; il valore predefinito è include.

        • search_scope
          Tipo: array string[]

          Ambito di ricerca. Entità dominio: any, sources, search_results. Entità keyword: any, question, answer, brand_entities, fan_out_queries. Predefinito: any.

    • filters
      Tipo: array

      Array di parametri per il filtraggio dei risultati. Campo facoltativo. È possibile aggiungere più filtri contemporaneamente (massimo 8 filtri). Tra le condizioni è necessario impostare un operatore logico and o or. Sono supportati i seguenti operatori: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match. Con l'operatore % è possibile usare like e not_like per trovare qualsiasi stringa di zero o più caratteri. Esempio: ["ai_search_volume",">","1000"]. L'elenco completo dei filtri possibili è disponibile qui.

    • language_code
      Tipo: string

      Codice lingua di ricerca. Campo facoltativo. Se usi questo campo, non devi specificare language_name; puoi ottenere l'elenco delle lingue disponibili del motore di ricerca con il relativo language_code effettuando una richiesta separata a https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Valore predefinito: en. Nota: i dati chat_gpt sono disponibili solo per en.

    • language_name
      Tipo: string

      Nome completo della lingua di ricerca. Campo facoltativo. Se usi questo campo, non devi specificare language_code; se non specifichi questo campo, per impostazione predefinita viene usato il language_code con valore en; puoi ottenere l'elenco delle lingue disponibili del motore di ricerca con il relativo language_name effettuando una richiesta separata a https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Nota: i dati chat_gpt sono disponibili solo per l'inglese.

    • limit
      Tipo: integer

      Numero massimo di oggetti restituiti. Campo facoltativo. Valore predefinito: 100. Valore massimo: 1000.

    • location_code
      Tipo: integer

      Codice località di ricerca. Campo facoltativo. Se usi questo campo, non devi specificare location_name. Puoi ottenere l'elenco delle località disponibili del motore di ricerca con il relativo location_code effettuando una richiesta separata a https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Valore predefinito: 2840. Nota: i dati chat_gpt sono disponibili solo per 2840.

    • location_name
      Tipo: string

      Nome completo della località di ricerca. Campo facoltativo. Se usi questo campo, non devi specificare location_code. Se non specifichi questo campo, per impostazione predefinita viene usato il location_code con valore 2840; puoi ottenere l'elenco delle località disponibili del motore di ricerca con il relativo location_name effettuando una richiesta separata a https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Nota: i dati chat_gpt sono disponibili solo per gli Stati Uniti.

    • offset
      Tipo: integer

      Offset nell'array dei risultati dei dati sulle menzioni restituiti. Campo facoltativo. Valore predefinito: 0. Esempio: se si specifica il valore 10, i primi dieci oggetti menzione nell'array dei risultati vengono omessi e i dati vengono forniti per gli oggetti successivi. Nota: il valore massimo è 9.000; usare search_after_token se si desidera un offset maggiore.

    • order_by
      Tipo: array string[]

      Regole di ordinamento dei risultati. Campo facoltativo. È possibile usare gli stessi valori dell'array filters per ordinare i risultati. Tipi di ordinamento possibili: asc – i risultati vengono ordinati in ordine crescente; desc – i risultati vengono ordinati in ordine decrescente. Usare una virgola per impostare un tipo di ordinamento. Esempio: ["ai_search_volume,desc"]. Tenere presente che è possibile impostare al massimo tre regole di ordinamento per richiesta; più regole di ordinamento devono essere separate da una virgola.

    • platform
      Tipo: string

      Piattaforma di destinazione. Campo facoltativo. Valori possibili: chat_gpt, google. Valore predefinito: google. Nota: i dati restituiti dipendono dalla piattaforma selezionata. Nota n. 2: i dati chat_gpt sono disponibili solo per gli Stati Uniti e l'inglese.

    • search_after_token
      Tipo: string

      Token per le richieste successive. Campo facoltativo. Fornito nel campo identico della risposta a ogni richiesta. Usare questo parametro per evitare timeout quando si cerca di ottenere più di 20.000 risultati in una singola richiesta. Specificando il valore univoco search_after_token dall'array della risposta, si ottengono i risultati successivi dell'attività iniziale. I valori search_after_token sono univoci per ogni attività successiva. Nota: se search_after_token è specificato nella richiesta, tutti gli altri parametri devono essere identici alla richiesta precedente.

    • tag
      Tipo: string

      Identificatore dell'attività definito dall'utente. Campo facoltativo. Il limite di caratteri è 255. Puoi usare questo parametro per identificare l'attività e associarla al risultato. Il valore tag specificato si trova nell'oggetto data della risposta.

Risposte
  • 200
    Tipo: object

    Risposta riuscita

    • cost
      Tipo: number

      Costo totale delle attività, USD

    • status_code
      Tipo: integer

      Codice di stato generale. L'elenco completo dei codici di risposta è disponibile qui. Nota: consigliamo vivamente di progettare un sistema adeguato per gestire le relative condizioni di eccezione o errore.

    • status_message
      Tipo: string

      Messaggio informativo generale. L'elenco completo dei messaggi informativi generali è disponibile qui.

    • tasks
      Tipo: array string[]

      Array di attività

    • tasks_count
      Tipo: integer

      Il numero di attività nell'array tasks

    • tasks_error
      Tipo: integer

      Il numero di attività nell'array tasks restituite con un errore

    • tasks.cost
      Tipo: number

      Costo dell'attività, USD

    • tasks.data
      Tipo: object

      Contiene gli stessi parametri specificati nella richiesta POST

    • tasks.id
      Tipo: string

      Identificatore dell'attività. Identificatore univoco dell'attività nel nostro sistema in formato UUID.

    • tasks.path
      Tipo: array string[]

      Percorso URL

    • tasks.result
      Tipo: array string[]

      Array di risultati

    • tasks.result_count
      Tipo: integer

      Numero di elementi nell'array dei risultati

    • tasks.result.current_offset
      Tipo: integer

      Il numero di oggetti menzione omessi nell'array items

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

      Contiene dati rilevanti sulle menzioni

    • tasks.result.items_count
      Tipo: integer

      Il numero di risultati restituiti nell'array items

    • tasks.result.items.ai_search_volume
      Tipo: integer

      Volume di ricerca AI corrente di una keyword. Scopri di più su questa metrica qui.

    • tasks.result.items.answer
      Tipo: string

      Risposta pertinente in formato markdown; il contenuto del risultato è formattato nel linguaggio di markup markdown

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

      Array di entità marchio; contiene informazioni sui marchi menzionati nella risposta

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

      Categoria del marchio

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

      Posizione nei risultati

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

      Nome del marchio

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

      Array di query fan-out; contiene query di ricerca correlate derivate dalla query principale per fornire una risposta più completa

    • tasks.result.items.first_response_at
      Tipo: string

      Data e ora in cui i dati della risposta sono stati registrati per la prima volta, in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”. Esempio: 2025-10-21 06:25:30 +00:00

    • tasks.result.items.language_code
      Tipo: string

      Codice lingua in un array POST

    • tasks.result.items.last_response_at
      Tipo: string

      Data e ora in cui i dati della risposta sono stati aggiornati l'ultima volta, in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”. Esempio: 2025-10-21 06:25:30 +00:00

    • tasks.result.items.location_code
      Tipo: integer

      Codice posizione in un array POST

    • tasks.result.items.model_name
      Tipo: string

      Nome del modello AI da cui sono stati recuperati i dati. Nota: per il tipo di piattaforma google il valore è sempre google_ai_overview

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

      Tassi mensili di volume di ricerca AI; array di oggetti con i tassi di volume di ricerca AI in un determinato mese di un anno

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

      Mese

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

      Tasso di volume di ricerca AI in un determinato mese di un anno. Per ulteriori informazioni su questa metrica, consultare questa pagina

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

      Anno

    • tasks.result.items.platform
      Tipo: string

      Piattaforma ricevuta in un array POST

    • tasks.result.items.question
      Tipo: string

      Domanda pertinente

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

      Array di risultati di ricerca; tutti gli output della ricerca web recuperati dal modello durante la ricerca di informazioni, inclusi duplicati e voci non utilizzate

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

      Breadcrumb

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

      Descrizione del risultato

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

      Dominio del risultato

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

      Posizione nei risultati

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

      Data e ora in cui il risultato è stato pubblicato, nel formato: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”. Esempio: 2019-11-15 12:57:46 +00:00

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

      Titolo del risultato

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

      URL del risultato

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

      Array di fonti; le fonti citate o utilizzate dal modello nella risposta finale

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

      Dominio di origine

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

      Contenuto dell'elemento in formato markdown; il contenuto del risultato è formattato nel linguaggio di markup markdown

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

      Posizione nei risultati

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

      Data e ora in cui il risultato è stato pubblicato, nel formato: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”. Esempio: 2019-11-15 12:57:46 +00:00

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

      Descrizione dell'origine

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

      Nome dell'origine

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

      Miniatura dell'origine

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

      Titolo dell'origine

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

      URL dell'origine

    • tasks.result.search_after_token
      Tipo: string

      Token per le richieste successive. Specificando lo search_after_token univoco durante l'impostazione di una nuova attività, si ottengono i risultati successivi dell'attività iniziale. I valori search_after_token sono univoci per ogni attività successiva

    • tasks.result.total_count
      Tipo: integer

      Numero totale di risultati pertinenti alla richiesta

    • tasks.status_code
      Tipo: integer

      Codice di stato dell'attività generata da DataForSEO; può essere compreso nel seguente intervallo: 10000-60000. L'elenco completo dei codici di risposta è disponibile qui.

    • tasks.status_message
      Tipo: string

      Messaggio informativo dell'attività. L'elenco completo dei messaggi informativi generali è disponibile qui.

    • tasks.time
      Tipo: string

      Tempo di esecuzione in secondi

    • time
      Tipo: string

      Tempo di esecuzione in secondi

    • version
      Tipo: string

      La versione corrente dell'API

    application/json
  • 400

    Impossibile elaborare la richiesta. Controlla i parametri della richiesta.

  • 401

    È richiesta una chiave API Felo valida.

  • 402

    Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.

  • 403

    L'account non è autorizzato a eseguire questa operazione.

  • 429

    È stato raggiunto un limite di richieste o di spesa.

  • 502

    Il servizio non è riuscito a completare la richiesta.

  • 503

    L'API o il servizio di fatturazione è temporaneamente non disponibile.

  • 504

    Si è verificato un timeout durante l'elaborazione della richiesta.

  • default

    Risposta di errore; le risposte passthrough upstream possono usare formati del provider

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

Risposta riuscita

Live LLM Mentions