v0.2.0-beta

OpenAPI 3.1.0

Live ChatGPT LLM Scraper

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

post/v1/beta/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/advanced

Live ChatGPT LLM Scraper

Stelt ChatGPT een keyword zoals een gebruiker dat zou doen en retourneert het geparseerde antwoord. Retourneert keyword, location_code, language_code, model, datetime, markdown, sources, fan_out_queries en brand_entities – markdown is het antwoord zoals de assistent het weergaf, sources de geciteerde pagina's en brand_entities de genoemde merken. force_web_search laat het browsen in plaats van uit de training te antwoorden. Verpakt in de DataForSEO-envelop: gegevens in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200. Dit is het endpoint voor 'wat zegt ChatGPT over ons'; om vermeldingen over veel antwoorden te tellen gebruik je post_dataforseo_ai_llm_mentions_aggregated_metrics_live in plaats van herhaaldelijk te scrapen. De ruwe vorm is post_dataforseo_ai_chat_gpt_llm_scraper_live_html.

Prijsreferentie

Metering: Gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.004.
Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een 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

application/json

Type: array (object | null)[]
- force_web_search
  Type: boolean | null
  
  AI-agent dwingen webzoekopdrachten te gebruiken
  optioneel veld
  indien ingeschakeld, wordt het AI-model gedwongen actuele webinformatie te raadplegen en te citeren;
  standaardwaarde: false;
  Let op: zelfs als de parameter op true staat, is niet gegarandeerd dat webbronnen in de respons worden geciteerd
- keyword
  Type: string
  
  keyword
  verplicht veld
  je kunt maximaal 2000 tekens in het veld keyword 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
- language_code
  Type: string
  
  taalcode van de zoekmachine
  verplicht veld als je language_name niet opgeeft;
  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/chat_gpt/llm_scraper/languages
- language_name
  Type: string
  
  volledige naam van de taal van de zoekmachine
  verplicht veld als je language_code niet opgeeft;
  als je dit veld gebruikt, hoef je language_code niet op te geven;
  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/chat_gpt/llm_scraper/languages
- location_code
  Type: integer
  
  locatiecode van de zoekmachine
  verplicht veld als niet opgegeven location_name
  bij gebruik van dit veld hoef je location_name niet op te geven
  de lijst met beschikbare locaties van de zoekmachines en hun location_code ontvang je via een apart verzoek aan https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations
  voorbeeld:
  2840
- location_name
  Type: string
  
  volledige naam van de locatie van de zoekmachine
  verplicht veld als niet opgegeven location_code
  bij gebruik van dit veld hoef je location_code niet op te geven
  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/chat_gpt/llm_scraper/locations
  voorbeeld:
  United States
- tag
  Type: string | null
  
  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 | null · Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedResponseInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

status_code
Type: integer | null

algemene statuscode de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier

tasks
Type: array (object | null)[] | null

array van taken

Type: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedTaskInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

data
Type: object | null

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

propertyName
Type: object | null
id
Type: string | null

taak-id eenduidige taak-id in ons systeem in UUID-indeling

path
Type: array (string | null)[] | null

URL-pad

result
Type: array (object | null)[] | null

array van resultaten

brand_entities
Type: array (object | null)[] | null

array van merkentiteiten
bevat informatie over merken die in de respons worden genoemd

category
Type: string | null

categorie van het merk

markdown
Type: string | null

merknaam in markdown-indeling
bevat de merknaam in de markdown-opmaaktaal

title
Type: string | null

naam van het merk

type
Type: string | null

elementtype

urls
Type: object | null

array met URL's en domeinen die relevant zijn voor het merk

check_url
Type: string | null

directe URL naar zoekmachineresultaten
u kunt deze gebruiken om te controleren of we exacte resultaten hebben geleverd

datetime
Type: string | null

datum en tijd waarop het resultaat is ontvangen
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

fan_out_queries
Type: array (string | null)[] | null

array van fan-out-query's
bevat gerelateerde zoekopdrachten die van de hoofdquery zijn afgeleid om een uitgebreider antwoord te geven

item_types
Type: array (string | null)[] | null

typen zoekresultaten
bevat de typen zoekresultaten (items) die in de SERP zijn gevonden.
mogelijke itemtypen:
chat_gpt_text, chat_gpt_table, chat_gpt_navigation_list, chat_gpt_images, chat_gpt_local_businesses, chat_gpt_products

items
Type: array (object | null)[] | null

elementen van ChatGPT-resultaten

rank_absolute
Type: integer | null

absolute rang in SERP
absolute positie onder alle elementen

rank_group
Type: integer | null

groepsrang in de SERP
positie binnen een groep elementen met identieke type-waarden
posities van elementen met andere type-waarden worden uit rank_group weggelaten

type
Type: string | null

elementtype

items_count
Type: integer | null Formaat: int64

het aantal resultaten dat in de array items wordt geretourneerd

keyword
Type: string | null

keyword ontvangen in een POST-array
het keyword wordt geretourneerd met gedecodeerde %## (het plusteken '+' wordt gedecodeerd naar een spatie)

language_code
Type: string | null

taalcode in een POST-array

location_code
Type: integer | null

locatiecode in een POST-array

markdown
Type: string | null

inhoud van het element in markdown-indeling
de inhoud van het resultaat, opgemaakt in de markdown-opmaaktaal

model
Type: string | null

geeft de modelversie aan

se_results_count
Type: integer | null Formaat: int64

totaal aantal resultaten

search_results
Type: array (object | null)[] | null

array van zoekresultaten
alle webzoekresultaten die het model heeft opgehaald bij het opzoeken van informatie, inclusief duplicaten en ongebruikte items

breadcrumb
Type: string | null

breadcrumb

description
Type: string | null

beschrijving van het resultaat

domain
Type: string | null

domein van het resultaat

title
Type: string | null

titel van het resultaat

type
Type: string | null

elementtype

url
Type: string | null

URL van het resultaat

sources
Type: array (object | null)[] | null

array van bronnen
de bronnen die het model in zijn definitieve antwoord daadwerkelijk heeft geciteerd of gebruikt

domain
Type: string | null

brondomein in SERP

markdown
Type: string | null

inhoud van het element in markdown-indeling
de inhoud van het resultaat, opgemaakt in de markdown-opmaaktaal

publication_date
Type: string | null

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

snippet
Type: string | null

beschrijving van de bron

source_name
Type: string | null

naam van de bron

thumbnail
Type: string | null

miniatuur van de bron

title
Type: string | null

titel van de bron

type
Type: string | null

elementtype

url
Type: string | null

bron-URL

result_count
Type: integer | null Formaat: int64

Aantal elementen in de result-array

status_code
Type: integer | null

statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier

time
Type: string | null

Uitvoeringstijd in seconden

tasks_count
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array

tasks_error
Type: integer | null Formaat: int64

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

time
Type: string | null

totale uitvoeringstijd, seconden

version
Type: string | null

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

post/v1/beta/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

Schema tonen

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "keyword": null,
          "location_code": null,
          "language_code": null,
          "model": null,
          "check_url": null,
          "datetime": null,
          "markdown": null,
          "search_results": [
            {
              "type": null,
              "url": null,
              "domain": null,
              "title": null,
              "description": null,
              "breadcrumb": null
            }
          ],
          "sources": [
            {
              "type": null,
              "title": null,
              "snippet": null,
              "domain": null,
              "url": null,
              "thumbnail": null,
              "source_name": null,
              "publication_date": null,
              "markdown": null
            }
          ],
          "fan_out_queries": [
            null
          ],
          "brand_entities": [
            {
              "type": null,
              "title": null,
              "category": null,
              "markdown": null,
              "urls": null
            }
          ],
          "se_results_count": null,
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Live ChatGPT LLM Scraper

AuthenticatieRequired

DataForSEO

Live ChatGPT LLM Scraper

Prijsreferentie