DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Keywordideeën
Breidt seed-keywords uit naar ideeën die dezelfde semantische ruimte delen. Retourneert seed_keywords, total_count, items_count, offset, offset_token en items. Paginering met limit, offset en offset_token; gebruik voorbij de eerste pagina's het token. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. Geef dit endpoint de voorkeur. Voor varianten van één frase in plaats van de bredere ruimte gebruik je post_dataforseo_labs_google_keyword_suggestions_live.
Prijsreferentie
- Afrekening: gerapporteerde responskosten.
- Referentieschatting per verzoek: USD 0.132.
- 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)[]
- closelyType: boolean | null
_variants zoekmodus
optioneel veld
bijtruezijn de resultaten gebaseerd op het phrase-match-zoekalgoritme
bijfalsezijn de resultaten gebaseerd op het broad-match-zoekalgoritme
standaardwaarde:false - filtersType: array (object | null)[] | null
array met filterparameters voor resultaten
optioneel veld
u kunt meerdere filters tegelijk toevoegen (maximaal 8 filters)
tussen de voorwaarden zet u een logische operatorandofor
de volgende operators worden ondersteund:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,match,not_match,ilike,not_ilike,like,not_like
u kunt de operator%metlikeennot_like, evenals metilikeennot_ilikegebruiken om elke tekenreeks van nul of meer tekens te matchen
let op: de resultaten kunnen niet oprelevanceworden gefilterd
voorbeeld:["keyword_info.search_volume",">",0][["keyword_info.search_volume","in",[0,1000]],
"and",
["keyword_info.competition_level","=","LOW"]][["keyword_info.search_volume",">",100],
"and",
[["keyword_info.cpc","<",0.5],
"or",["keyword_info.high_top_of_page_bid","<=",0.5]]]
meer informatie over filters vindt u bij Dataforseo Labs - Filters of in deze handleiding in het Help CenterLeeg object - ignoreType: boolean | null
_synonyms sterk vergelijkbare keywords negeren
optioneel veld
bijtrueworden alleen kernkeywords geretourneerd, alle sterk vergelijkbare keywords worden uitgesloten;
standaardwaarde:false - 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[]
- languageType: string | null
_code taalcode
optioneel veld
bij gebruik van dit veld hoeft ulanguage_nameniet op te geven
de lijst met beschikbare talen en hunlanguage_codeontvangt u via een apart verzoek aan dehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
voorbeeld:en
Let op: als dit veld niet wordt opgegeven, worden standaard resultaten geretourneerd in de taal met de meeste keyword-records op de opgegeven locatie;
raadpleeg het veldavailable_languages.keywordsvan het Locations and Languages endpoint om de standaardtaal te bepalen - languageType: string | null
_name volledige naam van de taal
optioneel veld
bij gebruik van dit veld hoeft ulanguage_codeniet op te geven
de lijst met beschikbare talen en hunlanguage_nameontvangt u via een apart verzoek aan dehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
voorbeeld:English
Let op: als dit veld niet wordt opgegeven, worden standaard resultaten geretourneerd in de taal met de meeste keyword-records op de opgegeven locatie;
raadpleeg het veldavailable_languages.keywordsvan het Locations and Languages endpoint om de standaardtaal te bepalen - limitType: integer | null
maximaal aantal keywords in de resultatenarray
optioneel veld
standaardwaarde:700
maximumwaarde:1000 - locationType: integer
_code unieke locatie-identificatie
verplicht veld als niet opgegevenlocation_name
Let op: u moetlocation_nameoflocation_codeopgeven
de lijst met beschikbare locaties en hunlocation_codeontvangt u via een apart verzoek aan dehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
voorbeeld:2840 - locationType: string
_name volledige naam van de locatie
verplicht veld als niet opgegevenlocation_code
Let op: u moetlocation_nameoflocation_codeopgeven
de lijst met beschikbare locaties en hunlocation_nameontvangt u via een apart verzoek aan dehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
voorbeeld:United Kingdom - offsetType: integer | null
offset in de resultatenarray van geretourneerde keywords
optioneel veld
standaardwaarde:0
als u de waarde10opgeeft, worden de eerste tien keywords in de resultatenarray overgeslagen en worden de gegevens voor de volgende keywords geleverd
Let op: we raden aan deze parameter alleen te gebruiken bij het ophalen van maximaal 10.000 resultaten
gebruik voor meer dan 10.000 resultaten in plaats daarvanoffset_token. - offsetType: string | null
_token offset-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 10.000 resultaten in één verzoek;
door de unieke waardeoffset_tokenuit de responsarray op te geven, ontvangt u de vervolgresultaten van de oorspronkelijke taak;offset_token-waarden zijn uniek voor elke vervolgtaak
Let op: alsoffset_tokenin het verzoek wordt opgegeven, blijven alle andere parameters behalvelimitbuiten beschouwing bij de verwerking van een taak.
lees meer over deze parameter in ons Help Center - orderType: array string[] | null
_by sorteerregels voor resultaten
optioneel veld
u kunt dezelfde waarden als in de arrayfiltersgebruiken om de resultaten te sorteren
mogelijke sorteertypen:asc– resultaten worden in oplopende volgorde gesorteerddesc– resultaten worden in aflopende volgorde gesorteerd
gebruik een komma om een sorteerparameter in te stellenstandaardregel:
["relevance,desc"]
relevance wordt gebruikt als standaard-sorteerregel om u de meest nabije keyword-ideeën te bieden. We raden deze sorteerregel aan voor zeer relevante zoektermen. Let op:relevanceis alleen onze interne systeemidentificatie, dus kan niet als filter worden gebruikt, en u vindt dit veld niet in deresult-array. De relevantiescore is gebaseerd op een vergelijkbaar principe als bij het Keywords For Keywords-endpoint.Let op: u kunt per verzoek maximaal drie sorteerregels instellen
meerdere sorteerregels scheidt u met een komma
voorbeeld:["relevance,desc","keyword_info.search_volume,desc"] - 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_DataforseoLabsGoogleKeywordIdeasLiveResponseInfo200
- 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_DataforseoLabsGoogleKeywordIdeasLiveTaskInfo
- 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 keywordideeën en gerelateerde gegevens
- avgType: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info backlinkgegevens voor het geretourneerde keyword
dit object biedt het gemiddelde aantal backlinks, verwijzende pagina's en domeinen, evenals de gemiddelde rangwaarden onder de top 10 webpagina's 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
geretourneerd keywordidee
- keywordType: object | null · Response36Afe1097B20_KeywordInfo
_info keywordgegevens voor het geretourneerde keywordidee
- 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
- 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 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
- offsetType: integer | null
huidige offsetwaarde
- offsetType: string | null
_token offsettoken voor vervolgaanvragen
u kunt de tekenreeks in dit veld gebruiken om de vervolgresultaten van de oorspronkelijke taak op te halen;
opmerking:offset_token-waarden zijn uniek voor elke vervolgtaak - seType: string | null
_type type zoekmachine
- seedType: array (string | null)[] | null
_keywords keywords in een POST-array
keywords worden geretourneerd met gedecodeerde %## (het plusteken '+' wordt gedecodeerd naar een spatie) - totalType: integer | null Formaat: int64
_count totaal aantal resultaten in onze database dat relevant is voor uw verzoek
- 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_ideas/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keywords": [
"phone",
"watch"
],
"location_code": 2840,
"language_code": "en",
"include_serp_info": true,
"limit": 3
}
]'
{
"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,
"seed_keywords": [
null
],
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"offset": null,
"offset_token": null,
"items": [
{
"se_type": null,
"keyword": null,
"location_code": null,
"language_code": 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]"
}
]
}
]
}
]
}