Felo API PlatformFelo API Platform
Wszystkie endpointy DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

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

LLM Mentions na żywo

​

Pojedyncze odpowiedzi, w których asystent wspomniał twój cel. Zwraca total_count, current_offset, search_after_token i items — po pierwszych stronach stronicuj za pomocą tokenu, a nie offset. ⚠️ 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. Jeśli potrzebujesz liczby, a nie samych wzmianek, użyj post_dataforseo_ai_llm_mentions_aggregated_metrics_live.

Cennik referencyjny

  • Rozliczanie: zgłoszony koszt odpowiedzi.
  • Szacunek referencyjny dla żądania: USD 0.701.
  • 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[]
    • target
      Typ: array object[]
      wymagane

      tablica obiektów zawierających encje docelowe — pole wymagane. W polu target możesz podać do 10 encji (obiektów). Jedna encja docelowa może zawierać jedną domenę albo jedno słowo kluczowe i powiązane parametry. Przykłady: tablica target z encją domenową [{"domain": "en.wikipedia.org", "search_filter": "exclude"}] tablica target z encją słowa kluczowego [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}] tablica target z wieloma encjami [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]

        • domain
          Typ: string
          wymagane

          domena docelowa — pole wymagane, jeśli nie podasz keyword. W polu domain możesz podać do 63 znaków; domenę należy podać 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 podasz domain. W polu keyword możesz podać do 250 znaków. Wszystkie sekwencje %## zostaną zdekodowane (znak „+” zostanie zdekodowany jako spacja). Jeśli w słowie kluczowym potrzebujesz użyć znaku „%”, podaj go jako „%25”; jeśli potrzebujesz użyć 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.

    • filters
      Typ: array

      Tablica parametrów filtrowania wyników. Pole opcjonalne. Możesz dodać kilka filtrów jednocześnie (maksymalnie 8). Między warunkami należy ustawić operator logiczny and lub or. Obsługiwane 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.

    • 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

    • limit
      Typ: integer

      Maksymalna liczba zwracanych obiektów. Pole opcjonalne. Wartość domyślna: 100. Wartość maksymalna: 1000.

    • 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

    • offset
      Typ: integer

      Przesunięcie w tablicy wyników zwracanych danych o wzmiankach. Pole opcjonalne. Wartość domyślna: 0. Przykład: jeśli podasz wartość 10, pierwsze dziesięć obiektów wzmianek w tablicy wyników zostanie pominiętych, a dane zostaną zwrócone dla kolejnych obiektów. Uwaga: wartość maksymalna to 9000; jeśli chcesz pominąć więcej wyników, użyj search_after_token.

    • order_by
      Typ: array string[]

      Zasady sortowania wyników. Pole opcjonalne. Do sortowania wyników możesz użyć tych samych wartości co w tablicy filters. Możliwe typy sortowania: asc — wyniki zostaną posortowane rosnąco; desc — wyniki zostaną posortowane malejąco. Typ sortowania ustawia się przecinkiem. Przykład: ["ai_search_volume,desc"]. Pamiętaj, że w jednym żądaniu można ustawić nie więcej niż trzy zasady sortowania; kilka zasad sortowania należy oddzielić przecinkiem.

    • 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

    • search_after_token
      Typ: string

      Token do kolejnych żądań. Pole opcjonalne. Jest zwracany w tym samym polu odpowiedzi na każde żądanie. Użyj tego parametru, aby uniknąć przekroczeń czasu przy próbie pobrania ponad 20 000 wyników w jednym żądaniu. Podając unikalną wartość search_after_token z tablicy odpowiedzi, otrzymasz kolejne wyniki początkowego zadania. Wartości search_after_token są unikalne dla każdego kolejnego zadania. Uwaga: jeśli w żądaniu podano search_after_token, wszystkie pozostałe parametry muszą być identyczne jak w poprzednim żądaniu.

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

      Liczba obiektów wzmianek pominiętych w tablicy items.

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

      Zawiera odpowiednie dane o wzmiankach.

    • tasks.result.items_count
      Typ: integer

      Liczba wyników zwróconych w tablicy items.

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

      Odpowiedź w formacie Markdown. Treść wyniku sformatowana w języku znaczników Markdown.

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

      Tablica encji marek. Zawiera informacje o markach wymienionych w odpowiedzi.

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

      Kategoria marki.

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

      Pozycja w wynikach.

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

      Nazwa marki.

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

      Tablica zapytań fan-out. Zawiera powiązane zapytania wyszukiwania wyprowadzone z głównego zapytania, aby zapewnić pełniejszą odpowiedź.

    • tasks.result.items.first_response_at
      Typ: string

      Data i godzina pierwszego zapisania danych odpowiedzi w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”. Przykład: 2025-10-21 06:25:30 +00:00.

    • tasks.result.items.language_code
      Typ: string

      Kod języka w tablicy POST.

    • tasks.result.items.last_response_at
      Typ: string

      Data i godzina ostatniej aktualizacji danych odpowiedzi w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”. Przykład: 2025-10-21 06:25:30 +00:00.

    • tasks.result.items.location_code
      Typ: integer

      Kod lokalizacji w tablicy POST.

    • tasks.result.items.model_name
      Typ: string

      Nazwa modelu AI, z którego pobrano dane. Uwaga: dla typu platformy google wartość to zawsze google_ai_overview.

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

      Miesięczne wskaźniki wyszukiwań AI. Tablica obiektów ze wskaźnikami wyszukiwań AI w danym miesiącu roku.

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

      Miesiąc.

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

      Wskaźnik wyszukiwań AI w danym miesiącu roku. Więcej o tym wskaźniku znajdziesz tutaj.

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

      Rok.

    • tasks.result.items.platform
      Typ: string

      Platforma otrzymana w tablicy POST.

    • tasks.result.items.question
      Typ: string

      Powiązane pytanie.

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

      Tablica wyników wyszukiwania. Wszystkie wyniki wyszukiwania w sieci pobrane przez model podczas wyszukiwania informacji, w tym duplikaty i niewykorzystane pozycje.

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

      Ścieżka nawigacji.

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

      Opis wyniku.

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

      Domena wyniku.

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

      Pozycja w wynikach.

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

      Data i godzina publikacji wyniku w formacie: „year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”. Przykład: 2019-11-15 12:57:46 +00:00.

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

      Tytuł wyniku.

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

      URL wyniku.

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

      Tablica źródeł. Źródła, które model zacytował lub na których oparł się w końcowej odpowiedzi.

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

      Domena źródła.

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

      Treść elementu w formacie Markdown. Treść wyniku sformatowana w języku znaczników Markdown.

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

      Pozycja w wynikach.

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

      Data i godzina publikacji wyniku w formacie: „year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”. Przykład: 2019-11-15 12:57:46 +00:00.

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

      Opis źródła.

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

      Nazwa źródła.

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

      Miniatura źródła.

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

      Tytuł źródła.

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

      URL źródła.

    • tasks.result.search_after_token
      Typ: string

      Token do kolejnych żądań. Podając unikalny search_after_token podczas ustawiania nowego zadania, otrzymasz kolejne wyniki początkowego zadania. Wartości search_after_token są unikalne dla każdego kolejnego zadania.

    • tasks.result.total_count
      Typ: integer

      Łączna liczba wyników pasujących do żądania.

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

Pomyślna odpowiedź

Live LLM Mentions