v0.2.0-beta

OpenAPI 3.1.0

Zagregowane metryki porównawcze LLM Mentions na żywo

Felo API Support

MIT

Serwer

https://openapi.felo.ai

Biblioteki klienckie

Shell Curl

DataForSEO

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

DataForSEO Operacje

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

Zagregowane metryki porównawcze LLM Mentions na żywo

Porównuje metryki wzmianek dla kilku celów w jednym wywołaniu, grupowane według aggregation_key. Przyjmuje targets jako listę tablic celów, a nie pojedynczy target jak pozostałe endpointy z tej rodziny — kształty się różnią, a pomylenie ich jest odrzucane jako nieznane pole. ⚠️ target to tablica obiektów, każdy {"domain": "..."} lub {"keyword": "..."}; sam ciąg znaków jest odrzucany jako nieprawidłowy typ, a tablica ciągów z komunikatem „Each target item must be an object”. Pola filtrów pochodzą z get_dataforseo_ai_llm_mentions_available_filters. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. Wywołanie post_dataforseo_ai_llm_mentions_aggregated_metrics_live raz dla każdego celu kosztuje tyle samo za wywołanie, więc użyj tego endpointu, gdy celem jest samo porównanie.

Cennik referencyjny

Rozliczanie: zgłoszony koszt odpowiedzi.
Szacunek referencyjny dla żądania: USD 0.101.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej już kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść

wymagane

application/json

Typ: array object[]
- targets
  Typ: array object[]
  wymagane
  
  tablica obiektów zawierających encje docelowe z kluczami agregacji — pole wymagane. Możesz podać do 10, ale nie mniej niż 2 zestawy parametrów docelowych, każdy z własnym aggregation_key; przykład tablicy targets z wieloma encjami: [{"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
  Typ: string
  wymagane
  
  klucz agregacji do grupowania wyników — pole wymagane. Grupuje wyniki do porównania i służy jako etykieta grupy; w polu aggregation_key możesz podać do 250 znaków
  
  target
  Typ: array object[]
  wymagane
  
  tablica obiektów zawierających encje docelowe — pole wymagane. Pojedynczy cel może zawierać do 10 encji domenowych i/lub słów kluczowych
  
  domain
  Typ: string
  wymagane
  
  Domena docelowa. Pole wymagane, jeśli nie podano słowa kluczowego. W polu domain można podać do 63 znaków; domenę należy podawać bez https:// i www.
  
  include_subdomains
  Typ: boolean
  
  określa, czy poddomeny domeny docelowej będą uwzględniane w wyszukiwaniu — pole opcjonalne. Po ustawieniu na true poddomeny będą uwzględniane w wyszukiwaniu. Wartość domyślna: false
  
  keyword
  Typ: string
  
  Słowo kluczowe docelowe. Pole wymagane, jeśli nie podano domeny. W polu keyword można podać do 250 znaków. Wszystkie ciągi %## zostaną zdekodowane (znak „+” zostanie zdekodowany jako spacja). Jeśli w słowie kluczowym potrzebujesz znaku „%”, podaj go jako „%25”; jeśli potrzebujesz znaku „+”, podaj go jako „%2B”. Więcej o zasadach i ograniczeniach pól keyword i keywords w interfejsach API DataForSEO znajdziesz w tym artykule Centrum pomocy.
  
  match_type
  Typ: string
  
  Typ dopasowania docelowego słowa kluczowego. Określa sposób dopasowania podanego słowa kluczowego. Pole opcjonalne. Możliwe wartości: word_match — wyszukiwanie pełnotekstowe terminów zgodnych z podanym słowem kluczowym, z dodatkowymi słowami przed, po lub w obrębie frazy (np. wyszukiwanie „light” zwróci wyniki zawierające „light bulb”, „light switch”); partial_match — wyszukiwanie podciągu znajdującego wszystkie wystąpienia podanego ciągu znaków, nawet jeśli występuje wewnątrz dłuższego słowa (np. wyszukiwanie „light” zwróci wyniki zawierające „lighting”, „highlight”); wartość domyślna: word_match.
  
  search_filter
  Typ: string
  
  Filtr wyszukiwania encji: include lub exclude; domyślnie include.
  
  search_scope
  Typ: array string[]
  
  Zakres wyszukiwania. Encje domenowe: any, sources, search_results. Encje słów kluczowych: any, question, answer, brand_entities, fan_out_queries. Domyślnie: any.
- initial_dataset_filters
  Typ: array
  
  tablica wyrażeń filtrów stosowanych przed agregacją — pole opcjonalne. Tej tablicy możesz użyć do filtrowania wyrażeń stosowanych do surowej bazy wzmianek przed agregacją, aby ograniczyć wiersze wchodzące w skład wyniku; możesz dodać kilka filtrów jednocześnie (maksymalnie 8 filtrów); między warunkami należy ustawić operator logiczny and lub or; obsługiwane są następujące operatory: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match; operatora % możesz użyć z like i not_like, aby dopasować dowolny ciąg złożony z zera lub więcej znaków; przykład: ["ai_search_volume",">","1000"]; pełna lista możliwych filtrów jest dostępna tutaj. Więcej o filtrach początkowego zbioru danych znajdziesz w tym artykule Centrum pomocy.
- internal_list_limit
  Typ: integer
  
  maksymalna liczba elementów w tablicach wewnętrznych — pole opcjonalne. Tego pola możesz użyć do ograniczenia liczby elementów w następujących tablicach: sources_domain, search_results_domain. Wartość minimalna: 1. Wartość maksymalna: 10. Wartość domyślna: 5
- language_code
  Typ: string
  
  kod języka wyszukiwania — pole opcjonalne. Jeśli używasz tego pola, nie musisz podawać language_name; listę dostępnych języków wyszukiwarki wraz z ich language_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages wartość domyślna: en. Uwaga: dane chat_gpt są dostępne tylko dla en
- language_name
  Typ: string
  
  pełna nazwa języka wyszukiwania — pole opcjonalne. Jeśli używasz tego pola, nie musisz podawać language_code; jeśli nie podasz tego pola, domyślnie zostanie użyty language_code o wartości en; listę dostępnych języków wyszukiwarki wraz z ich language_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages Uwaga: dane chat_gpt są dostępne tylko dla języka angielskiego
- location_code
  Typ: integer
  
  kod lokalizacji wyszukiwania — pole opcjonalne. Jeśli używasz tego pola, nie musisz podawać location_name. Listę dostępnych lokalizacji wyszukiwarki wraz z ich location_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages wartość domyślna: 2840. Uwaga: dane chat_gpt są dostępne tylko dla 2840
- location_name
  Typ: string
  
  pełna nazwa lokalizacji wyszukiwania — pole opcjonalne. Jeśli używasz tego pola, nie musisz podawać location_code; jeśli nie podasz tego pola, domyślnie zostanie użyty location_code o wartości 2840; listę dostępnych lokalizacji wyszukiwarki wraz z ich location_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages Uwaga: dane chat_gpt są dostępne tylko dla Stanów Zjednoczonych
- platform
  Typ: string
  
  platforma docelowa — pole opcjonalne. Możliwe wartości: chat_gpt, google. Wartość domyślna: google. Uwaga: zwracane dane zależą od wybranej platformy. Uwaga 2: dane chat_gpt są dostępne tylko dla Stanów Zjednoczonych i języka angielskiego
- tag
  Typ: string
  
  identyfikator zadania zdefiniowany przez użytkownika — pole opcjonalne. Limit znaków: 255. Ten parametr służy do identyfikacji zadania i dopasowania go do wyniku. Podaną wartość tag znajdziesz w obiekcie data odpowiedzi

Odpowiedzi

200
Typ: object

Pomyślna odpowiedź
cost
Typ: number

łączny koszt zadań, USD

status_code
Typ: integer

ogólny kod statusu. Pełną listę kodów odpowiedzi znajdziesz tutaj. Uwaga: zdecydowanie zalecamy zaprojektowanie systemu obsługi powiązanych warunków wyjątkowych lub błędów

status_message
Typ: string

ogólny komunikat informacyjny. Pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

tasks
Typ: array string[]

tablica zadań

tasks_count
Typ: integer

liczba zadań w tablicy tasks

tasks_error
Typ: integer

liczba zadań w tablicy tasks zwróconych z błędem

tasks.cost
Typ: number

koszt zadania, USD

tasks.data
Typ: object

zawiera te same parametry, które podano w żądaniu POST

tasks.id
Typ: string

identyfikator zadania. Unikalny identyfikator zadania w naszym systemie w formacie UUID

tasks.path
Typ: array string[]

ścieżka URL

tasks.result
Typ: array string[]

tablica wyników

tasks.result_count
Typ: integer

liczba elementów w tablicy result

tasks.result.items
Typ: array string[]

Zawiera odpowiednie dane o wzmiankach.

tasks.result.items.brand_entities_category
Typ: array string[]

dane o encjach marki powiązanych z celem. Tablica obiektów zawierających dane o kategoriach encji marki, które pojawiają się w wynikach wyszukiwania powiązanych z zapytaniami LLM

tasks.result.items.brand_entities_category.ai_search_volume
Typ: integer

bieżący wskaźnik wyszukiwań AI dla słowa kluczowego. Więcej o tym wskaźniku znajdziesz tutaj

tasks.result.items.brand_entities_category.impressions
Typ: integer

bieżący wskaźnik wyświetleń AI dla słowa kluczowego

tasks.result.items.brand_entities_category.key
Typ: string

identyfikator grupowania. Konkretny identyfikator wymiaru grupowania. W tym przypadku pole wyświetla znalezioną kategorię encji marki

tasks.result.items.brand_entities_category.mentions
Typ: integer

łączna liczba wzmianek LLM. Liczba wystąpień docelowego słowa kluczowego lub domeny w odniesieniu do konkretnej domeny

tasks.result.items.brand_entities_category.type
Typ: string

typ elementu = 'group_element'

tasks.result.items.brand_entities_title
Typ: array string[]

dane o encjach marki powiązanych z celem. Tablica obiektów zawierających dane o tytułach encji marki, które pojawiają się w wynikach wyszukiwania powiązanych z zapytaniami LLM

tasks.result.items.brand_entities_title.ai_search_volume
Typ: integer

bieżący wskaźnik wyszukiwań AI dla słowa kluczowego. Więcej o tym wskaźniku znajdziesz tutaj

tasks.result.items.brand_entities_title.impressions
Typ: integer

bieżący wskaźnik wyświetleń AI dla słowa kluczowego

tasks.result.items.brand_entities_title.key
Typ: string

identyfikator grupowania. Konkretny identyfikator wymiaru grupowania. W tym przypadku pole wyświetla znaleziony tytuł encji marki

tasks.result.items.brand_entities_title.mentions
Typ: integer

łączna liczba wzmianek LLM. Liczba wystąpień docelowego słowa kluczowego lub domeny w odniesieniu do konkretnej domeny

tasks.result.items.brand_entities_title.type
Typ: string

typ elementu = 'group_element'

tasks.result.items.key
Typ: string

Klucz agregacji otrzymany w tablicy POST.

tasks.result.items.language
Typ: array string[]

grupowanie według języka. Tablica obiektów zawierających metryki wzmianek w podziale na język treści

tasks.result.items.language.ai_search_volume
Typ: integer

bieżący wskaźnik wyszukiwań AI dla słowa kluczowego. Więcej o tym wskaźniku znajdziesz tutaj

tasks.result.items.language.impressions
Typ: integer

bieżący wskaźnik wyświetleń AI dla słowa kluczowego

tasks.result.items.language.key
Typ: string

identyfikator grupowania. Konkretny identyfikator wymiaru grupowania

tasks.result.items.language.mentions
Typ: integer

łączna liczba wzmianek LLM. Liczba wystąpień docelowego słowa kluczowego lub domeny w odniesieniu do tego konkretnego klucza grupowania

tasks.result.items.language.type
Typ: string

typ elementu = 'group_element'

tasks.result.items.location
Typ: array string[]

grupowanie według lokalizacji. Tablica obiektów zawierających metryki wzmianek w podziale na lokalizację geograficzną

tasks.result.items.location.ai_search_volume
Typ: integer

bieżący wskaźnik wyszukiwań AI dla słowa kluczowego. Więcej o tym wskaźniku znajdziesz tutaj

tasks.result.items.location.impressions
Typ: integer

bieżący wskaźnik wyświetleń AI dla słowa kluczowego

tasks.result.items.location.key
Typ: string

identyfikator grupowania. Konkretny identyfikator wymiaru grupowania

tasks.result.items.location.mentions
Typ: integer

łączna liczba wzmianek LLM. Liczba wystąpień docelowego słowa kluczowego lub domeny w odniesieniu do tego konkretnego klucza grupowania

tasks.result.items.location.type
Typ: string

typ elementu = 'group_element'

tasks.result.items.platform
Typ: array string[]

grupowanie według platformy. Tablica elementów grup zawierających metryki wzmianek w podziale na platformę AI

tasks.result.items.platform.ai_search_volume
Typ: integer

bieżący wskaźnik wyszukiwań AI dla słowa kluczowego. Więcej o tym wskaźniku znajdziesz tutaj

tasks.result.items.platform.impressions
Typ: integer

bieżący wskaźnik wyświetleń AI dla słowa kluczowego

tasks.result.items.platform.key
Typ: string

identyfikator grupowania. Konkretny identyfikator wymiaru grupowania

tasks.result.items.platform.mentions
Typ: integer

łączna liczba wzmianek LLM. Liczba wystąpień docelowego słowa kluczowego lub domeny w odniesieniu do tego konkretnego klucza grupowania

tasks.result.items.platform.type
Typ: string

typ elementu = 'group_element'

tasks.result.items.search_results_domain
Typ: array string[]

znalezione czołowe domeny wyników wyszukiwania powiązane z celem. Tablica obiektów zawierających dane o czołowych domenach, które pojawiają się w wynikach wyszukiwania powiązanych z zapytaniami LLM

tasks.result.items.search_results_domain.ai_search_volume
Typ: integer

bieżący wskaźnik wyszukiwań AI dla słowa kluczowego. Więcej o tym wskaźniku znajdziesz tutaj

tasks.result.items.search_results_domain.impressions
Typ: integer

bieżący wskaźnik wyświetleń AI dla słowa kluczowego

tasks.result.items.search_results_domain.key
Typ: string

identyfikator grupowania. Konkretny identyfikator wymiaru grupowania. W tym przypadku pole wyświetla znalezioną nazwę domeny

tasks.result.items.search_results_domain.mentions
Typ: integer

łączna liczba wzmianek LLM. Liczba wystąpień docelowego słowa kluczowego lub domeny w odniesieniu do konkretnej domeny

tasks.result.items.search_results_domain.type
Typ: string

typ elementu = 'group_element'

tasks.result.items.sources_domain
Typ: array string[]

znalezione czołowe domeny źródłowe powiązane z celem. Tablica obiektów zawierających dane o czołowych domenach cytowanych jako źródła w odpowiedziach LLM

tasks.result.items.sources_domain.ai_search_volume
Typ: integer

bieżący wskaźnik wyszukiwań AI dla słowa kluczowego. Więcej o tym wskaźniku znajdziesz tutaj

tasks.result.items.sources_domain.impressions
Typ: integer

bieżący wskaźnik wyświetleń AI dla słowa kluczowego

tasks.result.items.sources_domain.key
Typ: string

identyfikator grupowania. Konkretny identyfikator wymiaru grupowania. W tym przypadku pole wyświetla znalezioną nazwę domeny

tasks.result.items.sources_domain.mentions
Typ: integer

łączna liczba wzmianek LLM. Liczba wystąpień docelowego słowa kluczowego lub domeny w odniesieniu do konkretnej domeny

tasks.result.items.sources_domain.type
Typ: string

typ elementu = 'group_element'

tasks.result.total
Typ: object

podsumowanie zagregowanych metryk wzmianek. Zawiera ogólne zagregowane metryki wzmianek LLM dla wszystkich znalezionych domen, pogrupowane według różnych wymiarów

tasks.result.total.brand_entities_category
Typ: array string[]

dane o encjach marki powiązanych z celem. Tablica obiektów zawierających dane o kategoriach encji marki, które pojawiają się w wynikach wyszukiwania powiązanych z zapytaniami LLM

tasks.result.total.brand_entities_category.ai_search_volume
Typ: integer

bieżący wskaźnik wyszukiwań AI dla słowa kluczowego. Więcej o tym wskaźniku znajdziesz tutaj

tasks.result.total.brand_entities_category.impressions
Typ: integer

bieżący wskaźnik wyświetleń AI dla słowa kluczowego

tasks.result.total.brand_entities_category.key
Typ: string

identyfikator grupowania. Konkretny identyfikator wymiaru grupowania. W tym przypadku pole wyświetla znalezioną kategorię encji marki

tasks.result.total.brand_entities_category.mentions
Typ: integer

łączna liczba wzmianek LLM. Liczba wystąpień docelowego słowa kluczowego lub domeny w odniesieniu do konkretnej domeny

tasks.result.total.brand_entities_category.type
Typ: string

typ elementu = 'group_element'

tasks.result.total.brand_entities_title
Typ: array string[]

dane o encjach marki powiązanych z celem. Tablica obiektów zawierających dane o tytułach encji marki, które pojawiają się w wynikach wyszukiwania powiązanych z zapytaniami LLM

tasks.result.total.brand_entities_title.ai_search_volume
Typ: integer

bieżący wskaźnik wyszukiwań AI dla słowa kluczowego. Więcej o tym wskaźniku znajdziesz tutaj

tasks.result.total.brand_entities_title.impressions
Typ: integer

bieżący wskaźnik wyświetleń AI dla słowa kluczowego

tasks.result.total.brand_entities_title.key
Typ: string

identyfikator grupowania. Konkretny identyfikator wymiaru grupowania. W tym przypadku pole wyświetla znaleziony tytuł encji marki

tasks.result.total.brand_entities_title.mentions
Typ: integer

łączna liczba wzmianek LLM. Liczba wystąpień docelowego słowa kluczowego lub domeny w odniesieniu do konkretnej domeny

tasks.result.total.brand_entities_title.type
Typ: string

typ elementu = 'group_element'

tasks.result.total.language
Typ: array string[]

grupowanie według języka. Tablica obiektów zawierających metryki wzmianek w podziale na język treści

tasks.result.total.language.ai_search_volume
Typ: integer

bieżący wskaźnik wyszukiwań AI dla słowa kluczowego. Więcej o tym wskaźniku znajdziesz tutaj

tasks.result.total.language.impressions
Typ: integer

bieżący wskaźnik wyświetleń AI dla słowa kluczowego

tasks.result.total.language.key
Typ: string

identyfikator grupowania. Konkretny identyfikator wymiaru grupowania

tasks.result.total.language.mentions
Typ: integer

łączna liczba wzmianek LLM. Liczba wystąpień docelowego słowa kluczowego lub domeny w odniesieniu do tego konkretnego klucza grupowania

tasks.result.total.language.type
Typ: string

typ elementu = 'group_element'

tasks.result.total.location
Typ: array string[]

grupowanie według lokalizacji. Tablica obiektów zawierających metryki wzmianek w podziale na lokalizację geograficzną

tasks.result.total.location.ai_search_volume
Typ: integer

bieżący wskaźnik wyszukiwań AI dla słowa kluczowego. Więcej o tym wskaźniku znajdziesz tutaj

tasks.result.total.location.impressions
Typ: integer

bieżący wskaźnik wyświetleń AI dla słowa kluczowego

tasks.result.total.location.key
Typ: string

identyfikator grupowania. Konkretny identyfikator wymiaru grupowania

tasks.result.total.location.mentions
Typ: integer

łączna liczba wzmianek LLM. Liczba wystąpień docelowego słowa kluczowego lub domeny w odniesieniu do tego konkretnego klucza grupowania

tasks.result.total.location.type
Typ: string

typ elementu = 'group_element'

tasks.result.total.platform
Typ: array string[]

grupowanie według platformy. Tablica elementów grup zawierających metryki wzmianek w podziale na platformę AI

tasks.result.total.platform.ai_search_volume
Typ: integer

bieżący wskaźnik wyszukiwań AI dla słowa kluczowego. Więcej o tym wskaźniku znajdziesz tutaj

tasks.result.total.platform.impressions
Typ: integer

bieżący wskaźnik wyświetleń AI dla słowa kluczowego

tasks.result.total.platform.key
Typ: string

identyfikator grupowania. Konkretny identyfikator wymiaru grupowania

tasks.result.total.platform.mentions
Typ: integer

łączna liczba wzmianek LLM. Liczba wystąpień docelowego słowa kluczowego lub domeny w odniesieniu do tego konkretnego klucza grupowania

tasks.result.total.platform.type
Typ: string

typ elementu = 'group_element'

tasks.result.total.search_results_domain
Typ: array string[]

znalezione czołowe domeny wyników wyszukiwania powiązane z celem. Tablica obiektów zawierających dane o czołowych domenach, które pojawiają się w wynikach wyszukiwania powiązanych z zapytaniami LLM

tasks.result.total.search_results_domain.ai_search_volume
Typ: integer

bieżący wskaźnik wyszukiwań AI dla słowa kluczowego. Więcej o tym wskaźniku znajdziesz tutaj

tasks.result.total.search_results_domain.impressions
Typ: integer

bieżący wskaźnik wyświetleń AI dla słowa kluczowego

tasks.result.total.search_results_domain.key
Typ: string

identyfikator grupowania. Konkretny identyfikator wymiaru grupowania. W tym przypadku pole wyświetla znalezioną nazwę domeny

tasks.result.total.search_results_domain.mentions
Typ: integer

łączna liczba wzmianek LLM. Liczba wystąpień docelowego słowa kluczowego lub domeny w odniesieniu do konkretnej domeny

tasks.result.total.search_results_domain.type
Typ: string

typ elementu = 'group_element'

tasks.result.total.sources_domain
Typ: array string[]

znalezione czołowe domeny źródłowe powiązane z celem. Tablica obiektów zawierających dane o czołowych domenach cytowanych jako źródła w odpowiedziach LLM

tasks.result.total.sources_domain.ai_search_volume
Typ: integer

bieżący wskaźnik wyszukiwań AI dla słowa kluczowego. Więcej o tym wskaźniku znajdziesz tutaj

tasks.result.total.sources_domain.impressions
Typ: integer

bieżący wskaźnik wyświetleń AI dla słowa kluczowego

tasks.result.total.sources_domain.key
Typ: string

identyfikator grupowania. Konkretny identyfikator wymiaru grupowania. W tym przypadku pole wyświetla znalezioną nazwę domeny

tasks.result.total.sources_domain.mentions
Typ: integer

łączna liczba wzmianek LLM. Liczba wystąpień docelowego słowa kluczowego lub domeny w odniesieniu do konkretnej domeny

tasks.result.total.sources_domain.type
Typ: string

typ elementu = 'group_element'

tasks.status_code
Typ: integer

kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w zakresie: 10000-60000. Pełną listę kodów odpowiedzi znajdziesz tutaj

tasks.status_message
Typ: string

komunikat informacyjny zadania. Pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

tasks.time
Typ: string

czas wykonania, sekundy

time
Typ: string

czas wykonania, sekundy

version
Typ: string

bieżąca wersja interfejsu API
application/json
400

Nie można przetworzyć żądania. Sprawdź parametry żądania.
401

Wymagany jest prawidłowy klucz API Felo.
402

Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
403

Konto nie ma uprawnień do wykonania tej operacji.
429

Osiągnięto limit żądań lub wydatków.
502

Usługa nie mogła ukończyć żądania.
503

API lub usługa rozliczeniowa jest tymczasowo niedostępna.
504

Upłynął limit czasu usługi podczas przetwarzania żądania.
default

Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

application/json

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

Pokaż schemat

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

Pomyślna odpowiedź

Zagregowane metryki porównawcze LLM Mentions na żywo

UwierzytelnianieRequired

DataForSEO

Zagregowane metryki porównawcze LLM Mentions na żywo

Cennik referencyjny