DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Gemini LLM-scraper instellen
Zet een Gemini-scrape in de wachtrij in plaats van te wachten en retourneert een taak-id. priority schuift deze naar voren in de wachtrij. 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. Haal op met get_dataforseo_ai_gemini_llm_scraper_fetch, of de HTML-vorm met get_dataforseo_ai_gemini_llm_scraper_fetch_html. Gebruik het wanneer een reeks keywords het geduld van een tool-aanroep zou overstijgen; het live-endpoint is eenvoudiger voor één.
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.
- Type: array (object | null)[]
- expandType: boolean | null
_citations uitgebreide citatiebalk in HTML-resultaten retourneren
optioneel veld
indien ingeschakeld, retourneert het HTML-endpoint gegevens uit de uitgebreide citatiebalk;
standaardwaarde:false - keywordType: string
keyword
verplicht veld
je kunt maximaal 2000 tekens in het veldkeywordopgeven
alle %## worden gedecodeerd (‘+’ wordt bovendien gedecodeerd naar een spatie)
als je het teken “%” voor jekeywordwilt gebruiken, geef het dan op als “%25”;
als je het teken “+” voor jekeywordwilt gebruiken, geef het dan op als “%2B”meer informatie over regels en beperkingen voor de velden
keywordenkeywordsin DataForSEO-API's vind je in dit Help Center-artikel - languageType: string
_code taalcode van de zoekmachine
verplicht veld als jelanguage_nameniet opgeeft;
als je dit veld gebruikt, hoef jelanguage_nameniet op te geven;
de lijst met beschikbare talen van de zoekmachine en hunlanguage_codeontvang je via een apart verzoek aanhttps://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
voorbeeld:en - languageType: string
_name volledige naam van de taal van de zoekmachine
verplicht veld als jelanguage_codeniet opgeeft;
als je dit veld gebruikt, hoef jelanguage_codeniet op te geven;
de lijst met beschikbare talen van de zoekmachine en hunlanguage_nameontvang je via een apart verzoek aanhttps://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages
voorbeeld:English - locationType: integer
_code locatiecode van de zoekmachine
verplicht veld als niet opgegevenlocation_nameoflocation_coordinate
bij gebruik van dit veld hoef jelocation_nameoflocation_coordinateniet op te geven
de lijst met beschikbare locaties van de zoekmachines en hunlocation_codeontvang je via een apart verzoek aanhttps://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations
voorbeeld:2840 - locationType: string
_coordinate GPS-coördinaten van een locatie
verplicht veld als niet opgegeven
location_nameoflocation_codebij gebruik van dit veld hoef je
location_nameoflocation_codeniet op te gevende parameter
location_coordinatemoet in het formaat "latitude,longitude,radius" worden opgegevenhet maximale aantal decimalen voor "latitude" en "longitude": 7
de minimumwaarde voor "radius": 199 (mm)
de maximumwaarde voor "radius": 199999 (mm)
voorbeeld:
53.476225,-2.243572,200 - locationType: string
_name volledige naam van de locatie van de zoekmachine
verplicht veld als niet opgegevenlocation_codeoflocation_coordinate
bij gebruik van dit veld hoef jelocation_codeoflocation_coordinateniet op te geven
de lijst met beschikbare locaties van de zoekmachine en hunlocation_nameontvang je via een apart verzoek aanhttps://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations
voorbeeld:United States - pingbackType: string | null
_url meldings-URL van een voltooide taak
optioneel veld
wanneer een taak is voltooid, melden we je dit via een GET-verzoek naar de URL die je hebt opgegeven
je kunt de tekenreeks ‘$id’ als$id-variabele en ‘$tag’ als URL-gecodeerde$tag-variabele gebruiken. We stellen de benodigde waarden in voordat we het verzoek versturen.
voorbeeld:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Let op: speciale tekens inpingback_urlworden URL-gecodeerd;
d.w.z. het teken#wordt gecodeerd als%23 - postbackType: string
_data postback_url-gegevenstype
verplicht veld als jepostback_urlopgeeft
komt overeen met de functie die je hebt gebruikt om een taak in te stellen
mogelijke waarden:advanced,html - postbackType: string | null
_url URL voor het verzenden van taakresultaten
optioneel veld
zodra de taak is voltooid, sturen we een POST-verzoek met de resultaten gecomprimeerd ingzip-formaat naar de opgegevenpostback_url
je kunt de tekenreeks ‘$id’ als$id-variabele en ‘$tag’ als URL-gecodeerde$tag-variabele gebruiken. We stellen de benodigde waarden in voordat we het verzoek versturen.
voorbeeld:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Let op: speciale tekens inpostback_urlworden URL-gecodeerd;
d.w.z. het teken#wordt gecodeerd als%23 - priorityType: integer | null
- tagType: 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 waardetagvind je in hetdata-object van de respons
- Type: object | null · Response36Afe1097B20_AiOptimizationGeminiLlmScraperTaskPostResponseInfo200
- Type: number | null Formaat: doublecost
Totale kosten van taken, USD
- Type: integer | nullstatus
_code algemene statuscode de volledige lijst met responscodes vindt u hier
- Type: string | nullstatus
_message algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier
- Type: array (object | null)[] | nulltasks
array van taken
- Type: object | null · Response36Afe1097B20_AiOptimizationGeminiLlmScraperTaskPostTaskInfo
- costType: number | null Formaat: double
Totale kosten van taken, USD
- dataType: object | null
Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven
- propertyType: object | null
Name
- idType: string | null
taak-id eenduidige taak-id in ons systeem in UUID-indeling
- pathType: array (string | null)[] | null
URL-pad
- resultType: object | null
array van resultaten
in dit geval is de waardenull - resultType: integer | null Formaat: int64
_count Aantal elementen in de result-array
- statusType: integer | null
_code statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier
- statusType: string | null
_message informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier
- timeType: string | null
Uitvoeringstijd in seconden
- Type: integer | null Formaat: int64tasks
_count Het aantal taken in de tasks-array
- Type: integer | null Formaat: int64tasks
_error Het aantal taken in de tasks-array dat met een fout is geretourneerd
- Type: string | nulltime
totale uitvoeringstijd, seconden
- Type: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/gemini/llm_scraper/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein"
}
]'
{
"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": null
}
]
}