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

Metriche aggregate incrociate di LLM Mentions live

Server:https://openapi.felo.ai
Librerie client

DataForSEO

​

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

Metriche aggregate incrociate di LLM Mentions live

​

Confronta le metriche delle menzioni su più target in un'unica chiamata, raggruppate per aggregation_key. Accetta targets come elenco di array di target anziché il singolo target dei suoi fratelli: le forme sono diverse e scambiarle viene rifiutato come campo sconosciuto. ⚠️ 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. Eseguire post_dataforseo_ai_llm_mentions_aggregated_metrics_live una volta per target costa lo stesso per chiamata, quindi usare questo quando il confronto stesso è l'obiettivo.

Riferimento prezzi

  • Misurazione: costo della risposta comunicato.
  • Stima di riferimento per richiesta: USD 0.101.
  • 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[]
    • targets
      Tipo: array object[]
      obbligatorio

      Array di oggetti contenenti entità di destinazione con chiavi di aggregazione. Campo obbligatorio. Puoi specificare fino a 10, ma non meno di 2 set di parametri di destinazione, ciascuno con il relativo aggregation_key; esempio di array targets con più entità: [{"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
        Tipo: string
        obbligatorio

        Chiave di aggregazione per il raggruppamento dei risultati. Campo obbligatorio. Raggruppa i risultati per il confronto e funge da etichetta per il gruppo; nel campo aggregation_key puoi specificare fino a 250 caratteri.

      • target
        Tipo: array object[]
        obbligatorio

        Array di oggetti contenenti entità di destinazione. Campo obbligatorio. Un singolo target può contenere fino a 10 entità dominio e/o keyword.

          • domain
            Tipo: string
            obbligatorio

            Dominio di destinazione. Campo obbligatorio se non si specifica una keyword. Nel campo domain è possibile 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 si specifica un dominio. Nel campo keyword è possibile specificare fino a 250 caratteri. Tutti i %## vengono decodificati (il carattere ‘+’ viene inoltre decodificato in uno spazio). Se è necessario usare il carattere ‘%’ per la keyword, specificarlo come ‘%25’; se è necessario usare il carattere ‘+’, specificarlo come ‘%2B’. Per ulteriori informazioni sulle regole e sui limiti dei campi keyword e keywords nelle API DataForSEO, consultare questo articolo dell'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.

    • initial_dataset_filters
      Tipo: array

      Array di espressioni di filtro applicate prima dell'aggregazione. Campo facoltativo. Puoi usare questo array per filtrare le espressioni applicate al database grezzo delle menzioni prima dell'aggregazione, per limitare le righe che contribuiscono al risultato; puoi aggiungere più filtri contemporaneamente (massimo 8 filtri). Tra le condizioni devi impostare un operatore logico and oppure or. Sono supportati i seguenti operatori: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match. Con like e not_like puoi usare l'operatore % per trovare qualsiasi stringa di zero o più caratteri. Esempio: ["ai_search_volume",">","1000"]. L'elenco completo dei filtri possibili è disponibile qui. Per saperne di più sui filtri del dataset iniziale, consulta questo articolo del Help Center.

    • internal_list_limit
      Tipo: integer

      Numero massimo di elementi all'interno degli array interni. Campo facoltativo. Puoi usare questo campo per limitare il numero di elementi nei seguenti array: sources_domain, search_results_domain. Valore minimo: 1. Valore massimo: 10. Valore predefinito: 5.

    • 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.

    • 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.

    • 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.

    • 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.items
      Tipo: array string[]

      Contiene dati rilevanti sulle menzioni

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

      Dati sulle entità marchio pertinenti al target. Array di oggetti contenenti dati sulle categorie di entità marchio che compaiono nei risultati di ricerca relativi alle query LLM.

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

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

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

      Impressioni AI correnti di una keyword

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

      Identificatore di raggruppamento. L'identificatore specifico per la dimensione di raggruppamento. In questo caso il campo mostra una categoria di entità marchio trovata.

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

      Conteggio totale delle menzioni LLM. Il numero di volte in cui la keyword o il dominio di destinazione sono stati menzionati in relazione al dominio specifico.

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

      Tipo dell'elemento = 'group_element'

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

      Dati sulle entità marchio pertinenti al target. Array di oggetti contenenti dati sui titoli di entità marchio che compaiono nei risultati di ricerca relativi alle query LLM.

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

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

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

      Impressioni AI correnti di una keyword

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

      Identificatore di raggruppamento. L'identificatore specifico per la dimensione di raggruppamento. In questo caso il campo mostra un titolo di entità marchio trovato.

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

      Conteggio totale delle menzioni LLM. Il numero di volte in cui la keyword o il dominio di destinazione sono stati menzionati in relazione al dominio specifico.

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

      Tipo dell'elemento = 'group_element'

    • tasks.result.items.key
      Tipo: string

      Chiave di aggregazione ricevuta in un array POST

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

      Raggruppamento per lingua. Array di oggetti contenenti metriche delle menzioni segmentate per lingua dei contenuti.

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

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

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

      Impressioni AI correnti di una keyword

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

      Identificatore di raggruppamento. L'identificatore specifico per la dimensione di raggruppamento.

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

      Conteggio totale delle menzioni LLM. Il numero di volte in cui la keyword o il dominio di destinazione sono stati menzionati in relazione a questa specifica chiave di raggruppamento.

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

      Tipo dell'elemento = 'group_element'

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

      Raggruppamento per località. Array di oggetti contenenti metriche delle menzioni segmentate per località geografica.

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

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

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

      Impressioni AI correnti di una keyword

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

      Identificatore di raggruppamento. L'identificatore specifico per la dimensione di raggruppamento.

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

      Conteggio totale delle menzioni LLM. Il numero di volte in cui la keyword o il dominio di destinazione sono stati menzionati in relazione a questa specifica chiave di raggruppamento.

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

      Tipo dell'elemento = 'group_element'

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

      Raggruppamento per piattaforma. Array di elementi di gruppo contenenti metriche delle menzioni segmentate per piattaforma AI.

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

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

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

      Impressioni AI correnti di una keyword

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

      Identificatore di raggruppamento. L'identificatore specifico per la dimensione di raggruppamento.

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

      Conteggio totale delle menzioni LLM. Il numero di volte in cui la keyword o il dominio di destinazione sono stati menzionati in relazione a questa specifica chiave di raggruppamento.

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

      Tipo dell'elemento = 'group_element'

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

      Domini principali dei risultati di ricerca trovati, pertinenti al target. Array di oggetti contenenti dati sui domini principali che compaiono nei risultati di ricerca relativi alle query LLM.

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

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

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

      Impressioni AI correnti di una keyword

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

      Identificatore di raggruppamento. L'identificatore specifico per la dimensione di raggruppamento. In questo caso il campo mostra un nome di dominio trovato.

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

      Conteggio totale delle menzioni LLM. Il numero di volte in cui la keyword o il dominio di destinazione sono stati menzionati in relazione al dominio specifico.

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

      Tipo dell'elemento = 'group_element'

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

      Domini di origine principali trovati, pertinenti al target. Array di oggetti contenenti dati sui domini principali citati come fonti nelle risposte LLM.

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

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

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

      Impressioni AI correnti di una keyword

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

      Identificatore di raggruppamento. L'identificatore specifico per la dimensione di raggruppamento. In questo caso il campo mostra un nome di dominio trovato.

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

      Conteggio totale delle menzioni LLM. Il numero di volte in cui la keyword o il dominio di destinazione sono stati menzionati in relazione al dominio specifico.

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

      Tipo dell'elemento = 'group_element'

    • tasks.result.total
      Tipo: object

      Riepilogo delle metriche aggregate delle menzioni. Contiene le metriche aggregate complessive delle menzioni LLM per tutti i domini trovati, raggruppate per varie dimensioni.

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

      Dati sulle entità marchio pertinenti al target. Array di oggetti contenenti dati sulle categorie di entità marchio che compaiono nei risultati di ricerca relativi alle query LLM.

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

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

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

      Impressioni AI correnti di una keyword

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

      Identificatore di raggruppamento. L'identificatore specifico per la dimensione di raggruppamento. In questo caso il campo mostra una categoria di entità marchio trovata.

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

      Conteggio totale delle menzioni LLM. Il numero di volte in cui la keyword o il dominio di destinazione sono stati menzionati in relazione al dominio specifico.

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

      Tipo dell'elemento = 'group_element'

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

      Dati sulle entità marchio pertinenti al target. Array di oggetti contenenti dati sui titoli di entità marchio che compaiono nei risultati di ricerca relativi alle query LLM.

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

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

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

      Impressioni AI correnti di una keyword

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

      Identificatore di raggruppamento. L'identificatore specifico per la dimensione di raggruppamento. In questo caso il campo mostra un titolo di entità marchio trovato.

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

      Conteggio totale delle menzioni LLM. Il numero di volte in cui la keyword o il dominio di destinazione sono stati menzionati in relazione al dominio specifico.

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

      Tipo dell'elemento = 'group_element'

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

      Raggruppamento per lingua. Array di oggetti contenenti metriche delle menzioni segmentate per lingua dei contenuti.

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

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

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

      Impressioni AI correnti di una keyword

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

      Identificatore di raggruppamento. L'identificatore specifico per la dimensione di raggruppamento.

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

      Conteggio totale delle menzioni LLM. Il numero di volte in cui la keyword o il dominio di destinazione sono stati menzionati in relazione a questa specifica chiave di raggruppamento.

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

      Tipo dell'elemento = 'group_element'

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

      Raggruppamento per località. Array di oggetti contenenti metriche delle menzioni segmentate per località geografica.

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

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

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

      Impressioni AI correnti di una keyword

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

      Identificatore di raggruppamento. L'identificatore specifico per la dimensione di raggruppamento.

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

      Conteggio totale delle menzioni LLM. Il numero di volte in cui la keyword o il dominio di destinazione sono stati menzionati in relazione a questa specifica chiave di raggruppamento.

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

      Tipo dell'elemento = 'group_element'

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

      Raggruppamento per piattaforma. Array di elementi di gruppo contenenti metriche delle menzioni segmentate per piattaforma AI.

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

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

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

      Impressioni AI correnti di una keyword

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

      Identificatore di raggruppamento. L'identificatore specifico per la dimensione di raggruppamento.

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

      Conteggio totale delle menzioni LLM. Il numero di volte in cui la keyword o il dominio di destinazione sono stati menzionati in relazione a questa specifica chiave di raggruppamento.

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

      Tipo dell'elemento = 'group_element'

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

      Domini principali dei risultati di ricerca trovati, pertinenti al target. Array di oggetti contenenti dati sui domini principali che compaiono nei risultati di ricerca relativi alle query LLM.

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

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

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

      Impressioni AI correnti di una keyword

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

      Identificatore di raggruppamento. L'identificatore specifico per la dimensione di raggruppamento. In questo caso il campo mostra un nome di dominio trovato.

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

      Conteggio totale delle menzioni LLM. Il numero di volte in cui la keyword o il dominio di destinazione sono stati menzionati in relazione al dominio specifico.

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

      Tipo dell'elemento = 'group_element'

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

      Domini di origine principali trovati, pertinenti al target. Array di oggetti contenenti dati sui domini principali citati come fonti nelle risposte LLM.

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

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

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

      Impressioni AI correnti di una keyword

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

      Identificatore di raggruppamento. L'identificatore specifico per la dimensione di raggruppamento. In questo caso il campo mostra un nome di dominio trovato.

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

      Conteggio totale delle menzioni LLM. Il numero di volte in cui la keyword o il dominio di destinazione sono stati menzionati in relazione al dominio specifico.

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

      Tipo dell'elemento = 'group_element'

    • 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/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
}
Live LLM Mentions Cross Aggregated Metrics