DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Keywordoverzicht
Alles wat Labs weet over een lijst keywords in één aanroep: volume, moeilijkheid, intentie, concurrentie en de SERP-functies die ze uitlokken. Retourneert se_type, location_code, language_code, items_count en items. Dit endpoint heeft geen limit-parameter, maar wordt per aanroep in plaats van per item afgerekend; stuur daarom de hele lijst in één keer. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. Begin hier als je keywords hebt; post_dataforseo_labs_google_keyword_ideas_live is waar je naartoe gaat als je er meer nodig hebt.
Prijsreferentie
- Afrekening: gerapporteerde responskosten.
- Referentieschatting per verzoek: USD 0.0254.
- Referentiemultiplier voor klanten: 1.0. Niet opnieuw toepassen op een al afgerekend klantbedrag.
Alleen referentiemetadata, geen accountofferte en geen gegarandeerde prijs of bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.
- Type: array (object | null)[]
- includeType: boolean | null
_clickstream _data gegevens uit clickstream-gebaseerde metrieken in het resultaat opnemen of uitsluiten
optioneel veld
als de parameter optrueis ingesteld, ontvangt u de veldenclickstream_keyword_info,keyword_info_normalized_with_clickstreamenkeyword_info_normalized_with_bingin de respons
standaardwaarde:false
als deze parameter is ingeschakeld, wordt het dubbele tarief voor het verzoek in rekening gebrachtmeer informatie over de berekening van clickstream-gebaseerde metrieken vindt u in dit Help Center-artikel
- includeType: boolean | null
_serp _info gegevens uit de SERP voor elk keyword opnemen
optioneel veld
bijtrueretourneren we een arrayserp_infomet SERP-gegevens (aantal zoekresultaten, relevante URL en SERP-functies) voor elk keyword in de respons
standaardwaarde:false - keywordsType: array string[]
keywords
verplicht veld
het maximale aantal keywords dat u kunt opgeven: 700
het maximale aantal tekens per keyword: 80
het maximale aantal woorden per keyword-frase: 10
de opgegeven keywords worden omgezet naar kleine letters, de gegevens worden in een afzonderlijke array geleverdlet op: als sommige van de in deze array opgegeven keywords ontbreken in de resultaten die u ontvangt, bevat onze database deze keywords niet en kan er geen data over worden geleverd
voor de keywords die in de resultaten ontbreken, worden geen kosten in rekening gebrachtmeer informatie over regels en beperkingen voor de velden
keywordenkeywordsin DataForSEO-API's vindt u in dit Help Center-artikel - languageType: string | null
_code taalcode
verplicht veld als ulanguage_nameniet opgeeft
Let op: u moetlanguage_nameoflanguage_codeopgeven
de lijst met beschikbare locaties metlanguage_codeontvangt u via een afzonderlijk verzoek aanhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
voorbeeld:en - languageType: string
_name volledige naam van de taal
verplicht veld als ulanguage_codeniet opgeeft
Let op: u moetlanguage_nameoflanguage_codeopgeven
de lijst met beschikbare locaties metlanguage_nameontvangt u via een afzonderlijk verzoek aanhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
voorbeeld:English - locationType: integer
_code locatiecode
verplicht veld als ulocation_nameniet opgeeft
Let op: u moetlocation_nameoflocation_codeopgeven
de lijst met beschikbare locaties metlocation_codeontvangt u via een afzonderlijk verzoek aanhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
voorbeeld:2840 - locationType: string
_name volledige naam van de locatie
verplicht veld als ulocation_codeniet opgeeft
Let op: u moetlocation_nameoflocation_codeopgeven
de lijst met beschikbare locaties metlocation_nameontvangt u via een afzonderlijk verzoek aanhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
voorbeeld:United Kingdom - 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_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo200
- 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_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo
- 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: array (object | null)[] | null
array van resultaten
- itemsType: array (object | null)[] | null
bevat keywords en gerelateerde gegevens
- avgType: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info backlinkgegevens voor het geretourneerde keyword
dit object levert het gemiddelde aantal backlinks, verwijzende pagina's en domeinen, evenals de gemiddelde rangwaarden onder de top 10-websites die organisch ranken voor het keyword- backlinksType: number | null
gemiddeld aantal backlinks
- dofollowType: number | null
gemiddeld aantal dofollowlinks
- lastType: string | null
_updated _time datum en tijd waarop de keywordgegevens zijn bijgewerkt
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00“
voorbeeld:2019-11-15 12:57:46 +00:00 - mainType: number | null
_domain _rank - rankType: number | null
- referringType: number | null
_domains gemiddeld aantal verwijzende domeinen
- referringType: number | null
_main _domains gemiddeld aantal verwijzende hoofddomeinen
- referringType: number | null
_pages gemiddeld aantal verwijzende pagina's
- seType: string | null
_type type zoekmachine
- clickstreamType: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info clickstreamgegevens voor het geretourneerde keyword
om resultaten voor dit veld op te halen, moet de parameterinclude_clickstream_dataoptruezijn ingesteld- ageType: object | null
_distribution - propertyType: integer | null Formaat: int64
Name Signed 64-bit integers (long type).
- genderType: object | null
_distribution - propertyType: integer | null Formaat: int64
Name Signed 64-bit integers (long type).
- lastType: string | null
_updated _time datum en tijd waarop de keywordgegevens zijn bijgewerkt
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00“
voorbeeld:2019-11-15 12:57:46 +00:00 - monthlyType: array (object | null)[] | null
_searches maandelijkse zoekopdrachten
vertegenwoordigt het (bij benadering) aantal zoekopdrachten op deze keyword-idee (beschikbaar voor de afgelopen twaalf maanden), gericht op de opgegeven geografische locaties- monthType: integer | null
Maand
- searchType: integer | null
_volume gemiddelde maandelijkse zoekvolumegraad
- yearType: integer | null
Jaar
- searchType: integer | null Formaat: int64
_volume gemiddeld maandelijks zoekvolume
vertegenwoordigt het (bij benadering) aantal zoekopdrachten voor het betreffende keyword-idee op google.com
- keywordType: string | null
keyword
het keyword wordt geretourneerd met gedecodeerde %## (het plusteken '+' wordt gedecodeerd naar een spatie) - keywordType: object | null · Response36Afe1097B20_KeywordInfo
_info keywordgegevens voor het geretourneerde keyword
- categoriesType: array integer[] | null
- competitionType: number | null
concurrentie
geeft de relatieve concurrentie-intensiteit voor het betreffende keyword aan. De waarde is gebaseerd op Google Ads-gegevens en kan tussen 0 en 1 (inclusief) liggen - competitionType: string | null
_level - cpcType: number | null
kosten per klik
geeft de gemiddelde kosten per klik (USD) aan die historisch voor het keyword zijn betaald - highType: number | null
_top _of _page _bid maximaal bod om de advertentie bovenaan de eerste pagina te laten verschijnen
geeft de waarde aan die hoger ligt dan ongeveer 80% van de laagste biedingen waarvoor advertenties zijn weergegeven (op basis van Google Ads-statistieken voor adverteerders)
de waarde kan verschillen afhankelijk van de locatie die in een POST-verzoek is opgegeven - lastType: string | null
_updated _time datum en tijd waarop de keywordgegevens zijn bijgewerkt
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00“
voorbeeld:2019-11-15 12:57:46 +00:00 - lowType: number | null
_top _of _page _bid minimaal bod om de advertentie bovenaan de eerste pagina te laten verschijnen
geeft de waarde aan die hoger ligt dan ongeveer 20% van de laagste biedingen waarvoor advertenties zijn weergegeven (op basis van Google Ads-statistieken voor adverteerders)
de waarde kan verschillen afhankelijk van de locatie die in een POST-verzoek is opgegeven - monthlyType: array (object | null)[] | null
_searches maandelijkse zoekopdrachten
vertegenwoordigt het (bij benadering) aantal zoekopdrachten op deze keyword-idee (beschikbaar voor de afgelopen twaalf maanden), gericht op de opgegeven geografische locaties- monthType: integer | null
Maand
- searchType: integer | null
_volume gemiddelde maandelijkse zoekvolumegraad
- yearType: integer | null
Jaar
- seType: string | null
_type type zoekmachine
- searchType: integer | null Formaat: int64
_volume gemiddeld maandelijks zoekvolume
vertegenwoordigt het (bij benadering) aantal zoekopdrachten voor het betreffende keyword-idee op google.com - searchType: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend veranderingen in de zoektrent
geeft de procentuele verandering van het zoekvolume ten opzichte van de vorige periode aan- monthlyType: integer | null
procentuele verandering van het zoekvolume ten opzichte van de vorige maand
- quarterlyType: integer | null
procentuele verandering van het zoekvolume ten opzichte van het vorige kwartaal
- yearlyType: integer | null
procentuele verandering van het zoekvolume ten opzichte van het vorige jaar
- keywordType: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing bevat keywordzoekvolume genormaliseerd met Bing-zoekvolume
- isType: boolean | null
_normalized keywordgegevens zijn genormaliseerd bij true worden de waarden genormaliseerd met Bing-gegevens
- lastType: string | null
_updated _time datum en tijd waarop de dataset is bijgewerkt in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00” voorbeeld: 2019-11-15 12:57:46 +00:00
- monthlyType: array (object | null)[] | null
_searches maandelijkse zoekvolumegraden array met objecten met zoekvolumegraden in een bepaalde maand van een jaar
- monthType: integer | null
Maand
- searchType: integer | null
_volume gemiddelde maandelijkse zoekvolumegraad
- yearType: integer | null
Jaar
- searchType: integer | null
_volume huidige zoekvolumegraad van een keyword
- keywordType: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream bevat keywordzoekvolume genormaliseerd met clickstreamgegevens
- isType: boolean | null
_normalized keywordgegevens zijn genormaliseerd bij true worden de waarden genormaliseerd met Bing-gegevens
- lastType: string | null
_updated _time datum en tijd waarop de dataset is bijgewerkt in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00” voorbeeld: 2019-11-15 12:57:46 +00:00
- monthlyType: array (object | null)[] | null
_searches maandelijkse zoekvolumegraden array met objecten met zoekvolumegraden in een bepaalde maand van een jaar
- monthType: integer | null
Maand
- searchType: integer | null
_volume gemiddelde maandelijkse zoekvolumegraad
- yearType: integer | null
Jaar
- searchType: integer | null
_volume huidige zoekvolumegraad van een keyword
- keywordType: object | null · Response36Afe1097B20_KeywordProperties
_properties aanvullende informatie over het keyword
- coreType: string | null
_keyword hoofdkeyword in een groep
bevat het hoofdkeyword in een groep die is bepaald door het synoniemclustering-algoritme
als de waardenullis, bevat onze database geen keywords die het betreffende algoritme als synoniem vankeywordkon identificeren - detectedType: string | null
_language gedetecteerde taal van het keyword
geeft de taal van het keyword aan zoals die door ons systeem is geïdentificeerd - isType: boolean | null
_another _language de gedetecteerde taal van het keyword wijkt af van de ingestelde taal
alstrue, komt de in het verzoek ingestelde taal niet overeen met de taal die ons systeem voor een bepaald keyword heeft bepaald - keywordType: integer | null
_difficulty moeilijkheidsgraad van ranking in de top 10 organische resultaten voor een keyword
geeft de kans aan om in de top 10 organische resultaten voor een keyword te komen, op een logaritmische schaal van 0 tot 100;
onder andere berekend door de linkprofielen van de eerste 10 pagina's in de SERP te analyseren;
meer over de metriek lees je in deze Help Center-gids - seType: string | null
_type type zoekmachine
- synonymType: string | null
_clustering _algorithm het algoritme dat wordt gebruikt om synoniemen te identificeren
mogelijke waarden:keyword_metrics- geeft het algoritme op basis vankeyword_info-parameters aantext_processing- geeft het op tekst gebaseerde algoritme aan
als de waardenullis, bevat onze database geen keywords die het betreffende algoritme als synoniem vankeywordkon identificeren - wordsType: integer | null Formaat: int64
_count aantal woorden in het keyword
geeft aan uit hoeveel woorden het keyword bestaat
- languageType: string | null
_code taalcode in een POST-array
- locationType: integer | null
_code locatiecode in een POST-array
- seType: string | null
_type type zoekmachine
- searchType: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignType: array (string | null)[] | null
_intent aanvullende zoekintenties
mogelijke waarden:informational,navigational,commercial,transactional - lastType: string | null
_updated _time datum en tijd waarop de keywordgegevens zijn bijgewerkt
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00“
voorbeeld:2019-11-15 12:57:46 +00:00 - mainType: string | null
_intent hoofdzoekintentie
mogelijke waarden:informational,navigational,commercial,transactional - seType: string | null
_type type zoekmachine
- searchType: boolean | null
_partners geeft aan of gegevens voor Google en partnersites gelden
bijtrueworden de resultaten geretourneerd voor eigen, beheerde en gesyndiceerde netwerken binnen Google en partnersites die Google Zoeken hosten;
bijfalseworden de resultaten alleen voor Google-zoeksites geretourneerd - serpType: object | null · Response36Afe1097B20_SerpInfo
_info SERP-gegevens
de waarde isnullals je het veldinclude_serp_infoniet optruehebt gezet in de POST-array of als er geen SERP-gegevens voor dit keyword in onze database staan- checkType: string | null
_url directe URL naar zoekmachineresultaten
u kunt deze gebruiken om te controleren of we nauwkeurige resultaten hebben geleverd - lastType: string | null
_updated _time datum en tijd waarop de keywordgegevens zijn bijgewerkt
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00“
voorbeeld:2019-11-15 12:57:46 +00:00 - previousType: string | null
_updated _time voorlaatste datum en tijd waarop de SERP-gegevens zijn bijgewerkt
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:2019-10-15 12:57:46 +00:00 - seType: integer | null Formaat: int64
_results _count aantal zoekresultaten voor het geretourneerde keyword
- seType: string | null
_type type zoekmachine
- serpType: array (string | null)[] | null
_item _types soorten zoekresultaten in de SERP
bevat de soorten zoekresultaten (items) die in de SERP zijn gevonden
mogelijke itemtypen:answer_box,app,carousel,multi_carousel,featured_snippet,google_flights,google_reviews,third_party_reviews,google_posts,images,jobs,knowledge_graph,local_pack,hotels_pack,map,organic,paid,people_also_ask,related_searches,people_also_search,shopping,top_stories,twitter,video,events,mention_carousel,recipes,top_sights,scholarly_articles,popular_products,podcasts,questions_and_answers,find_results_on,stocks_box,visual_stories,commercial_units,local_services,google_hotels,math_solver,currency_box,product_considerations,found_on_web,short_videos,refine_products,explore_brands,perspectives,discussions_and_forums,compare_sites,courses,ai_overview;
let op: de werkelijke resultaten worden alleen geretourneerd voor de elementenorganic,paid,featured_snippetenlocal_pack
- itemsType: integer | null Formaat: int64
_count het aantal resultaten dat in de array
itemswordt geretourneerd - languageType: string | null
_code taalcode in een POST-array
- locationType: integer | null
_code locatiecode in een POST-array
- seType: string | null
_type type zoekmachine
- 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/dataforseo_labs/google/keyword_overview/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"include_clickstream_data": true,
"include_serp_info": true,
"keywords": [
"iphone"
]
}
]'
{
"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": [
{
"se_type": null,
"location_code": null,
"language_code": null,
"items_count": null,
"items": [
{
"se_type": null,
"keyword": null,
"location_code": null,
"language_code": null,
"search_partners": null,
"keyword_info": "[Max Depth Exceeded]",
"keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
"keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
"clickstream_keyword_info": "[Max Depth Exceeded]",
"keyword_properties": "[Max Depth Exceeded]",
"serp_info": "[Max Depth Exceeded]",
"avg_backlinks_info": "[Max Depth Exceeded]",
"search_intent_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}