Felo API PlatformFelo API Platform
Alle endpoints van DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

LLM Mentions live

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

DataForSEO

​

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

DataForSEO Operaties

LLM Mentions live

​

De afzonderlijke antwoorden waarin een assistent uw doel vermeldde. Retourneert total_count, current_offset, search_after_token en items - pagina met de token, niet met offset, voorbij de eerste pagina's. ⚠️ target is een array van objecten, elk {"domain": "..."} of {"keyword": "..."}; een kale string wordt als verkeerd type geweigerd en een array van strings met 'Each target item must be an object'. Filtervelden komen uit get_dataforseo_ai_llm_mentions_available_filters. Verpakt in de envelop van DataForSEO: gegevens in tasks[0].result, uitkomst in tasks[0].status_code - een geweigerd verzoek retourneert nog steeds HTTP 200. Voor aantallen in plaats van de vermeldingen zelf gebruikt u post_dataforseo_ai_llm_mentions_aggregated_metrics_live.

Prijsreferentie

  • Meting: Gerapporteerde antwoordkosten.
  • Referentieschatting per verzoek: USD 0.701.
  • Referentiemultiplier voor klanten: 1.0. Pas deze niet opnieuw toe op een al afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Body
verplicht
application/json
  • Type: array object[]
    • target
      Type: array object[]
      verplicht

      Array met objecten die doelentiteiten bevatten. Verplicht veld. Je kunt maximaal 10 entiteiten (objecten) in het veld target opgeven. Eén doelentiteit kan ofwel één domein ofwel één keyword met bijbehorende parameters bevatten. Voorbeelden: target-array met een domeinentiteit [{"domain": "en.wikipedia.org", "search_filter": "exclude"}] target-array met een keyword-entiteit [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}] target-array met meerdere entiteiten [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]

        • domain
          Type: string
          verplicht

          Doeldomein. Verplicht veld als je geen keyword opgeeft. In het veld domain kun je maximaal 63 tekens opgeven; een domein moet worden opgegeven zonder https:// en www.

        • include_subdomains
          Type: boolean

          Geeft aan of de subdomeinen van het doeldomein in de zoekopdracht worden opgenomen. Optioneel veld. Als dit op true staat, worden de subdomeinen in de zoekopdracht opgenomen. Standaardwaarde: false.

        • keyword
          Type: string

          Doel-keyword. Verplicht veld als je geen domain opgeeft. In het veld keyword kun je maximaal 250 tekens opgeven. Alle %## worden gedecodeerd (‘+’ wordt bovendien gedecodeerd naar een spatie). Als je het teken “%” voor je keyword wilt gebruiken, geef het dan op als “%25”; als je het teken “+” voor je keyword wilt gebruiken, geef het dan op als “%2B”. Meer informatie over regels en beperkingen voor de velden keyword en keywords in DataForSEO-API's vind je in dit Help Center-artikel.

        • match_type
          Type: string

          Overeenkomsttype voor doelkeyword; bepaalt hoe het opgegeven keyword wordt gematcht. Optioneel veld. Mogelijke waarden: word_match – zoeken in volledige tekst naar termen die overeenkomen met het opgegeven seed-keyword, met extra woorden vóór, na of binnen de sleutelzin (bijv. de zoekopdracht ‘light’ levert resultaten op met ‘light bulb’, ‘light switch’); partial_match – substringzoekopdracht die alle exemplaren vindt die de opgegeven tekenreeks bevatten, ook als deze in een langer woord voorkomt (bijv. de zoekopdracht ‘light’ levert resultaten op met ‘lighting’, ‘highlight’); standaardwaarde: word_match

        • search_filter
          Type: string

          Filter voor entiteitszoekopdracht: include of exclude; standaard include.

        • search_scope
          Type: array string[]

          Zoekbereik. Domeinentiteiten: any, sources, search_results. Keyword-entiteiten: any, question, answer, brand_entities, fan_out_queries. Standaard: any.

    • filters
      Type: array

      Array met parameters voor het filteren van resultaten. Optioneel veld. U kunt meerdere filters tegelijk toevoegen (maximaal 8 filters). Tussen de voorwaarden moet u een logische operator and of or plaatsen. De volgende operators worden ondersteund: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match. Met de operator % kunt u bij like en not_like elke tekenreeks van nul of meer tekens matchen. Voorbeeld: ["ai_search_volume",">","1000"]. De volledige lijst met mogelijke filters vindt u hier.

    • language_code
      Type: string

      Zoektaalcode. Optioneel veld. Als je dit veld gebruikt, hoef je language_name niet op te geven; de lijst met beschikbare talen van de zoekmachine en hun language_code ontvang je via een apart verzoek aan https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Standaardwaarde: en. Let op: chat_gpt-gegevens zijn alleen beschikbaar voor en.

    • language_name
      Type: string

      Volledige naam van de zoektaal. Optioneel veld. Als je dit veld gebruikt, hoef je language_code niet op te geven; als je dit veld niet opgeeft, wordt standaard de language_code met waarde en gebruikt; de lijst met beschikbare talen van de zoekmachine en hun language_name ontvang je via een apart verzoek aan https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Let op: chat_gpt-gegevens zijn alleen beschikbaar voor Engels.

    • limit
      Type: integer

      Maximumaantal geretourneerde objecten. Optioneel veld. Standaardwaarde: 100. Maximumwaarde: 1000.

    • location_code
      Type: integer

      Zoeklocatiecode. Optioneel veld. Als je dit veld gebruikt, hoef je location_name niet op te geven. De lijst met beschikbare locaties van de zoekmachine en hun location_code ontvang je via een apart verzoek aan https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Standaardwaarde: 2840. Let op: chat_gpt-gegevens zijn alleen beschikbaar voor 2840.

    • location_name
      Type: string

      Volledige naam van de zoeklocatie. Optioneel veld. Als je dit veld gebruikt, hoef je location_code niet op te geven. Als je dit veld niet opgeeft, wordt standaard de location_code met waarde 2840 gebruikt; de lijst met beschikbare locaties van de zoekmachine en hun location_name ontvang je via een apart verzoek aan https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Let op: chat_gpt-gegevens zijn alleen beschikbaar voor de Verenigde Staten.

    • offset
      Type: integer

      Offset in de resultatenarray van de geretourneerde vermeldingsgegevens. Optioneel veld. Standaardwaarde: 0. Voorbeeld: als u de waarde 10 opgeeft, worden de eerste tien vermeldingsobjecten in de resultatenarray overgeslagen en worden de gegevens voor de volgende objecten geleverd. Let op: de maximumwaarde is 9.000; gebruik search_after_token als u een grotere offset wilt.

    • order_by
      Type: array string[]

      Sorteerregels voor resultaten. Optioneel veld. U kunt dezelfde waarden als in de array filters gebruiken om de resultaten te sorteren. Mogelijke sorteertypen: asc – resultaten worden in oplopende volgorde gesorteerd; desc – resultaten worden in aflopende volgorde gesorteerd. Gebruik een komma om een sorteertype in te stellen. Voorbeeld: ["ai_search_volume,desc"]. Let op: u kunt per verzoek maximaal drie sorteerregels instellen; scheid meerdere sorteerregels met een komma.

    • platform
      Type: string

      Doelplatform. Optioneel veld. Mogelijke waarden: chat_gpt, google. Standaardwaarde: google. Let op: de geretourneerde gegevens zijn afhankelijk van het geselecteerde platform. Let op #2: chat_gpt-gegevens zijn alleen beschikbaar voor de Verenigde Staten en Engels.

    • search_after_token
      Type: string

      Token voor vervolgverzoeken. Optioneel veld. Wordt geleverd in het identieke veld van de respons op elk verzoek. Gebruik deze parameter om time-outs te voorkomen bij het ophalen van meer dan 20.000 resultaten in één verzoek. Door de unieke search_after_token-waarde uit de responsarray op te geven, krijgt u de vervolgresultaten van de oorspronkelijke taak. search_after_token-waarden zijn uniek voor elke vervolgtaak. Let op: als search_after_token in het verzoek is opgegeven, moeten alle andere parameters identiek zijn aan die van het vorige verzoek.

    • tag
      Type: string

      Door gebruiker gedefinieerde taak-ID. Optioneel veld. De tekenslimiet is 255. Je kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen. De opgegeven waarde tag vind je in het data-object van de respons.

Responsen
  • 200
    Type: object

    Geslaagde respons

    • cost
      Type: number

      Totale kosten van taken, USD

    • status_code
      Type: integer

      Algemene statuscode. De volledige lijst met responscodes vind je hier. Let op: we raden sterk aan een passend systeem te ontwerpen voor het afhandelen van gerelateerde uitzonderings- of foutsituaties.

    • status_message
      Type: string

      Algemeen informatief bericht. De volledige lijst met algemene informatieve berichten vind je hier.

    • tasks
      Type: array string[]

      Array met taken

    • tasks_count
      Type: integer

      Het aantal taken in de tasks-array

    • tasks_error
      Type: integer

      Het aantal taken in de tasks-array dat met een fout is geretourneerd

    • tasks.cost
      Type: number

      Kosten van de taak, USD

    • tasks.data
      Type: object

      Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven

    • tasks.id
      Type: string

      Taak-ID. Unieke taak-ID in ons systeem in UUID-formaat.

    • tasks.path
      Type: array string[]

      URL-pad

    • tasks.result
      Type: array string[]

      Array met resultaten

    • tasks.result_count
      Type: integer

      Aantal elementen in de result-array

    • tasks.result.current_offset
      Type: integer

      Het aantal vermeldingsobjecten dat in de array items wordt overgeslagen

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

      Bevat relevante vermeldingsgegevens

    • tasks.result.items_count
      Type: integer

      Het aantal resultaten dat in de array items wordt geretourneerd

    • tasks.result.items.ai_search_volume
      Type: integer

      Huidig AI-zoekvolume van een keyword. Meer informatie over deze metriek vind je hier.

    • tasks.result.items.answer
      Type: string

      Relevant antwoord in markdown-indeling; de inhoud van het resultaat is opgemaakt in de opmaaktaal markdown

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

      Array met merkentiteiten; bevat informatie over merken die in de respons worden vermeld

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

      Categorie van het merk

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

      Positie in de resultaten

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

      Naam van het merk

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

      Array met fan-outquery's; bevat gerelateerde zoekopdrachten die van de hoofdquery zijn afgeleid om een uitgebreider antwoord te geven

    • tasks.result.items.first_response_at
      Type: string

      Datum en tijd waarop de responsgegevens voor het eerst zijn vastgelegd, in UTC-indeling: ‘yyyy-mm-dd hh-mm-ss +00:00’. Voorbeeld: 2025-10-21 06:25:30 +00:00

    • tasks.result.items.language_code
      Type: string

      Taalcode in een POST-array

    • tasks.result.items.last_response_at
      Type: string

      Datum en tijd waarop de responsgegevens voor het laatst zijn bijgewerkt, in UTC-indeling: ‘yyyy-mm-dd hh-mm-ss +00:00’. Voorbeeld: 2025-10-21 06:25:30 +00:00

    • tasks.result.items.location_code
      Type: integer

      Locatiecode in een POST-array

    • tasks.result.items.model_name
      Type: string

      Naam van het AI-model waaruit de gegevens zijn opgehaald. Let op: voor het platformtype google is de waarde altijd google_ai_overview

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

      Maandelijkse AI-zoekvolumepercentages; array met objecten met AI-zoekvolumepercentages in een bepaalde maand van een jaar

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

      Maand

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

      AI-zoekvolumepercentage in een bepaalde maand van een jaar. Meer over deze metriek vindt u hier

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

      Jaar

    • tasks.result.items.platform
      Type: string

      Platform, ontvangen in een POST-array

    • tasks.result.items.question
      Type: string

      Relevante vraag

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

      Array met zoekresultaten; alle webzoekuitvoer die het model heeft opgehaald bij het opzoeken van informatie, inclusief duplicaten en ongebruikte vermeldingen

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

      Breadcrumb

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

      Resultaatbeschrijving

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

      Resultaatdomein

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

      Positie in de resultaten

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

      Datum en tijd waarop het resultaat is gepubliceerd, in de indeling: ‘year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes’. Voorbeeld: 2019-11-15 12:57:46 +00:00

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

      Resultaattitel

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

      Resultaat-URL

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

      Array met bronnen; de bronnen die het model in zijn definitieve antwoord heeft geciteerd of gebruikt

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

      Brondomein

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

      Inhoud van het element in markdown-indeling; de inhoud van het resultaat is opgemaakt in de opmaaktaal markdown

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

      Positie in de resultaten

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

      Datum en tijd waarop het resultaat is gepubliceerd, in de indeling: ‘year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes’. Voorbeeld: 2019-11-15 12:57:46 +00:00

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

      Bronbeschrijving

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

      Bronnaam

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

      Bronminiatuur

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

      Brontitel

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

      Bron-URL

    • tasks.result.search_after_token
      Type: string

      Token voor vervolgverzoeken. Als u bij het instellen van een nieuwe taak de unieke search_after_token opgeeft, krijgt u de vervolgresultaten van de oorspronkelijke taak. search_after_token-waarden zijn uniek voor elke vervolgtaak

    • tasks.result.total_count
      Type: integer

      Totaal aantal resultaten dat relevant is voor het verzoek

    • tasks.status_code
      Type: integer

      Statuscode van de door DataForSEO gegenereerde taak; kan binnen het volgende bereik liggen: 10000-60000. De volledige lijst met responscodes vind je hier.

    • tasks.status_message
      Type: string

      Informatief bericht van de taak. De volledige lijst met algemene informatieve berichten vind je hier.

    • tasks.time
      Type: string

      Uitvoeringstijd in seconden

    • time
      Type: string

      Uitvoeringstijd in seconden

    • version
      Type: string

      De huidige versie van de API

    application/json
  • 400

    Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.

  • 401

    Een geldige Felo-API-sleutel is vereist.

  • 402

    Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.

  • 403

    Het account mag deze bewerking niet uitvoeren.

  • 429

    Een verzoek- of bestedingslimiet is bereikt.

  • 502

    De dienst kon het verzoek niet voltooien.

  • 503

    De API of factureringsdienst is tijdelijk niet beschikbaar.

  • 504

    Er is een time-out opgetreden bij het verwerken van het verzoek.

  • default

    Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

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

Geslaagde respons

Live LLM Mentions