DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live: uitgebreide Google Organic SERP
Retourneert synchroon de gerangschikte resultaten voor een keyword op Google. Retourneert keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count en items. advanced is de standaardkeuze; gebruik regular als alleen de ranglijst telt en html alleen om te controleren wat de parser heeft weggegooid. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200.
Prijsreferentie
- Afrekening: gerapporteerde responskosten.
- Referentieschatting per verzoek: USD 0.0175.
- 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)[]
- browserType: integer | null
_screen _height schermhoogte van de browser optioneel veld u kunt een aangepaste schermhoogte van de browser instellen om pixelrankings voor een bepaald apparaat te berekenen; kan binnen het volgende bereik worden opgegeven: 240-9999; standaard is de parameter ingesteld op: 1080 voor desktop; 640 voor mobiel op android; 812 voor mobiel op iOS; Let op: om deze parameter te gebruiken, stelt u calculate_rectangles in op true
- browserType: integer | null
_screen _resolution _ratio resolutieverhouding van het browserscherm optioneel veld u kunt een aangepaste resolutieverhouding van het browserscherm instellen om pixelrankings voor een bepaald apparaat te berekenen; kan binnen het volgende bereik worden opgegeven: 0.5-3; standaard is de parameter ingesteld op: 1 voor desktop; 3 voor mobiel op android; 3 voor mobiel op iOS; Let op: om deze parameter te gebruiken, stelt u calculate_rectangles in op true
- browserType: integer | null Formaat: int64
_screen _width schermbreedte van de browser optioneel veld u kunt een aangepaste schermbreedte van de browser instellen om pixelrankings voor een bepaald apparaat te berekenen; kan binnen het volgende bereik worden opgegeven: 240-9999; standaard is de parameter ingesteld op: 1920 voor desktop; 360 voor mobiel op android; 375 voor mobiel op iOS; Let op: om deze parameter te gebruiken, stelt u calculate_rectangles in op true
- calculateType: boolean | null
_rectangles pixelrankings voor SERP-elementen in uitgebreide resultaten berekenen optioneel veld pixelranking verwijst naar de afstand tussen het resultatensnippet en de linkerbovenhoek van het scherm; Ga naar het Help Center voor meer informatie>> standaard is de parameter ingesteld op false; Let op: voor het gebruik van deze parameter wordt $ 0,002 extra in rekening gebracht
- depthType: integer | null
parseerdiepte optioneel veld aantal resultaten in de SERP standaardwaarde: 10 maximumwaarde: 200 uw account wordt gefactureerd per SERP met maximaal 10 resultaten; een diepte boven 10 kan extra kosten veroorzaken als de zoekmachine meer dan 10 resultaten retourneert; de kosten kunnen worden berekend op de pagina Pricing.
- deviceType: string | null
apparaattype optioneel veld resultaten retourneren voor een bepaald apparaattype kan de waarden hebben: desktop, mobile standaardwaarde: desktop
- findType: array string[] | null
_targets _in SERP-elementtypen die op doelen worden gecontroleerd optioneel veld om deze parameter in te schakelen, moet ook stop_crawl_on_match zijn ingeschakeld geeft aan welke SERP-elementtypen op doelovereenkomsten moeten worden gecontroleerd als niet opgegeven, worden alle elementen van het eerste niveau met de velden url en domain op doelen gecontroleerd mogelijke waarden: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Let op: mag niet dezelfde elementtypen bevatten als ignore_targets_in voorbeeld: "find_targets_in": ["organic", "featured_snippet"] meer informatie over deze parameter vindt u in ons Help Center
- groupType: boolean | null
_organic _results verwante resultaten weergeven optioneel veld bij instelling op true wordt het element related_result in de respons geleverd als een snippet van het bovenliggende organische resultaat; bij instelling op false wordt het element related_result geleverd als een afzonderlijk organisch resultaat; standaardwaarde: true
- ignoreType: array string[] | null
_targets _in SERP-elementtypen die van de doelzoekopdracht worden uitgesloten optioneel veld om deze parameter in te schakelen, moet ook stop_crawl_on_match zijn ingeschakeld geeft aan welke SERP-elementtypen moeten worden uitgesloten bij het zoeken naar doelovereenkomsten mogelijke waarden: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Let op: mag niet dezelfde elementtypen bevatten als find_targets_in voorbeeld: "ignore_targets_in": ["paid", "images"] meer informatie over deze parameter vindt u in ons Help Center
- keywordType: string
keyword verplicht veld u kunt in het veld keyword maximaal 700 tekens opgeven alle %## worden gedecodeerd (het teken ‘+’ wordt gedecodeerd naar een spatie) als u het teken “%” voor uw keyword nodig hebt, geeft u het op als “%25”; als u het teken “+” voor uw keyword nodig hebt, geeft u het op als “%2B”; als dit veld parameters bevat zoals ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘definition:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, worden de kosten per taak met 5 vermenigvuldigd meer informatie over de regels en beperkingen van de velden keyword en keywords in DataForSEO-API's vindt u in dit Help Center-artikel
- languageType: string | null
_code taalcode van de zoekmachine optioneel veld als u language_name opgeeft als u dit veld gebruikt, hoeft u language_name niet op te geven de lijst met beschikbare talen van de zoekmachine met hun language_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/serp/google/languages voorbeeld: en
- languageType: string | null
_name volledige naam van de taal van de zoekmachine optioneel veld als u language_code opgeeft als u dit veld gebruikt, hoeft u language_code niet op te geven de lijst met beschikbare talen van de zoekmachine met hun language_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/serp/google/languages voorbeeld: English
- loadType: boolean | null
_async _ai _overview asynchrone ai_overview laden optioneel veld stel in op true om ai_overview-items in SERP's te verkrijgen, ook als ze asynchroon worden geladen; bij instelling op false verkrijgt u ai_overview-items alleen uit de cache; standaardwaarde: false Let op: voor het gebruik van deze parameter wordt $ 0,002 extra in rekening gebracht; als het element ontbreekt of "asynchronous_ai_overview": false bevat, worden alle extra kosten aan uw accountsaldo terugbetaald
- locationType: integer | null
_code locatiecode van de zoekmachine verplicht veld als u location_name of location_coordinate niet opgeeft als u dit veld gebruikt, hoeft u location_name of location_coordinate niet op te geven de lijst met beschikbare locaties van de zoekmachines met hun location_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/serp/google/locations voorbeeld: 2840
- locationType: string | null
_coordinate GPS-coördinaten van een locatie optioneel veld als u location_name of location_code opgeeft als u dit veld gebruikt, hoeft u location_name of location_code niet op te geven de parameter location_coordinate moet worden opgegeven in de indeling "latitude,longitude,radius" het maximum 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 | null
_name volledige naam van de locatie van de zoekmachine verplicht veld als u location_code of location_coordinate niet opgeeft als u dit veld gebruikt, hoeft u location_code of location_coordinate niet op te geven de lijst met beschikbare locaties van de zoekmachine met hun location_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/serp/google/locations voorbeeld: London,England,United Kingdom
- matchType: string | null
_type type doelovereenkomst verplicht veld als stop_crawl_on_match is opgegeven type overeenkomst voor de match_value mogelijke waarden: domain – specifiek domein of subdomein with_subdomains – hoofddomein en subdomeinen wildcard – wildcardpatroon
- matchType: string | null
_value doeldomein, subdomein of jokertekenwaarde verplicht veld als stop_crawl_on_match is opgegeven geef een doeldomein, subdomein of jokertekenwaarde op; Let op: domein of subdomein moet worden opgegeven zonder aanvraagprotocol; voorbeeld: "match_value": "dataforseo.com", "match_value": "/blog/post-*"
- maxType: integer | null
_crawl _pages crawllimiet voor pagina's optioneel veld aantal te crawlen pagina's met zoekresultaten maximumwaarde: 100 Let op: voor elke gecrawlde pagina worden kosten in rekening gebracht (10 organische resultaten per pagina); meer informatie over de prijzen vindt u op onze pagina Pricing; Let op #2: de parameters max_crawl_pages en depth vullen elkaar aan; meer informatie vindt u in ons Help Center
- osType: string | null
besturingssysteem van het apparaat optioneel veld als u in het veld device desktop opgeeft, kiest u uit de volgende waarden: windows, macos standaardwaarde: windows als u in het veld device mobile opgeeft, kiest u uit de volgende waarden: android, ios standaardwaarde: android
- peopleType: integer | null
_also _ask _click _depth klikken op het bijbehorende element optioneel veld geef de klikdiepte op het element people_also_ask op om extra people_also_ask_element-items te verkrijgen; Let op: uw account wordt voor elke klik $ 0,00015 extra in rekening gebracht; als het element ontbreekt of we minder klikken uitvoeren dan u hebt opgegeven, worden alle extra kosten aan uw accountsaldo terugbetaald mogelijke waarden: van 1 tot 4
- removeType: array string[] | null
_from _url specifieke parameters uit URL's verwijderen optioneel veld met dit veld kunt u maximaal 10 parameters opgeven die uit de URL's in het resultaat moeten worden verwijderd voorbeeld: "remove_from_url": ["srsltid"] Let op: als het veld target is opgegeven, worden de opgegeven URL-parameters vóór de zoekopdracht verwijderd
- seType: string | null
_domain zoekmachinedomein optioneel veld we kiezen het relevante zoekmachinedomein automatisch op basis van de locatie en taal die u opgeeft u kunt in dit veld echter een aangepast zoekmachinedomein instellen voorbeeld: google.co.uk, google.com.au, google.de, enz.
- searchType: string | null
_param aanvullende parameters van de zoekopdracht optioneel veld de lijst met beschikbare parameters en meer details vindt u hier Let op: de volgende zoekmachineparameters worden niet ondersteund en worden automatisch uitgeschakeld als ze worden opgegeven: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- stopType: array (object | null)[] | null
_crawl _on _match array van doelen waarop het crawlen moet stoppen optioneel veld indien opgegeven, bevat de respons SERP-resultaten tot en met de opgegeven match_value; u kunt maximaal 10 doelwaarden in deze array opgeven voorbeeld: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] meer informatie over deze parameter vindt u in ons Helpcentrum - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api uw account wordt gefactureerd voor elke SERP die via de opgegeven doelen wordt gecrawld
- matchType: string | null
_type type doelovereenkomst verplicht veld als stop_crawl_on_match is opgegeven; type overeenkomst voor de match_value mogelijke waarden: domain, with_subdomains, wildcard
- matchType: string | null
_value doeldomein of wildcardwaarde verplicht veld als stop_crawl_on_match is opgegeven; geef een doeldomein of wildcardwaarde op; Opmerking: de domeinnaam moet worden opgegeven zonder aanvraagprotocol; voorbeeld: dataforseo.com
- tagType: string | null
Door de gebruiker gedefinieerde taakidentificatie. Optioneel veld. De tekenlimiet is 255. Met deze parameter kunt u de taak identificeren en aan het resultaat koppelen. De opgegeven tag-waarde vindt u in het data-object van de respons.
- targetType: string | null
doeldomein, subdomein of webpagina waarvoor resultaten worden opgehaald optioneel veld een domein of subdomein moet worden opgegeven zonder https:// en www. Let op: de resultaten van taakspecifieke taken bevatten alleen SERP-elementen die een URL-tekenreeks bevatten; u kunt ook een jokerteken (‘’) gebruiken om het zoekpatroon in de SERP op te geven en de resultaten te verfijnen; voorbeelden: example.com - retourneert resultaten voor de startpagina van de website met URL's zoals https://example.com, of https://www.example.com/, of https://example.com/; example.com - retourneert resultaten voor het domein, inclusief al zijn pagina's; example.com - retourneert resultaten voor het hele domein, inclusief al zijn pagina's en subdomeinen; example.com - retourneert resultaten voor de startpagina, ongeacht het subdomein, zoals https://en.example.com; example.com/example-page - retourneert resultaten voor de exacte URL; example.com/example-page - retourneert resultaten voor alle URL's van het domein die met de opgegeven tekenreeks beginnen
- targetType: string | null
_search _mode modus voor doelovereenkomsten optioneel veld om deze parameter in te schakelen, moet ook stop_crawl_on_match zijn ingeschakeld bepaalt hoe het crawlen moet stoppen wanneer meerdere doelen in stop_crawl_on_match zijn opgegeven mogelijke waarden: all, any all – het crawlen stopt pas wanneer alle opgegeven doelen zijn gevonden any – het crawlen stopt wanneer één enkel doel is gevonden standaardwaarde: any meer informatie over deze parameter vindt u in ons Help Center
- urlType: string | null
directe URL van de zoekopdracht optioneel veld u kunt een directe URL opgeven en wij sorteren deze uit naar de benodigde velden. Houd er rekening mee dat deze methode het moeilijkst is voor onze API om te verwerken en dat u de exacte taal en locatie in de URL moet opgeven. In de meeste gevallen raden we deze methode niet aan. voorbeeld: https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS Let op: de volgende zoekmachineparameters worden niet ondersteund en worden automatisch uitgeschakeld als ze worden opgegeven: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- Type: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo200
- 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 met taken
- Type: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo
- 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 met resultaten
- checkType: string | null
_url directe URL naar de zoekmachineresultaten. U kunt deze gebruiken om te controleren of we nauwkeurige resultaten hebben geleverd
- datetimeType: string | null
datum en tijd waarop het resultaat is ontvangen in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00” voorbeeld: 2019-11-15 12:57:46 +00:00
- itemType: array (string | null)[] | null
_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, 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, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box,product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview
- itemsType: array (object | null)[] | null
items van het element
- pageType: integer | null
paginanummer van de zoekresultaten
geeft het nummer aan van de SERP-pagina waarop het element zich bevindt - positionType: string | null
de uitlijning van het element in de SERP
kan de volgende waarden aannemen:left,right - rectangleType: object | null · Response36Afe1097B20_AiModeRectangleInfo
rechthoekparameters
bevat cartesische coördinaten en pixeldimensies van het snippet van het resultaat in de SERP
gelijk aannullalscalculate_rectanglesin het POST-verzoek niet optruestaat- heightType: number | null Formaat: double
hoogte van het element in pixels
- widthType: number | null Formaat: double
breedte van het element in pixels
- xType: number | null Formaat: double
x-ascoördinaat de x-ascoördinaat van de linkerbovenhoek van het snippet van het resultaat, waarbij de linkerbovenhoek van het scherm de oorsprong is
- yType: number | null Formaat: double
y-ascoördinaat de y-ascoördinaat van de linkerbovenhoek van het snippet van het resultaat, waarbij de linkerbovenhoek van het scherm de oorsprong is
- typeType: string | null
elementtype
- xpathType: string | null
het XPath van het element
- itemsType: integer | null Formaat: int64
_count Het aantal resultaten dat in de array items wordt geretourneerd
- keywordType: string | null
Keyword ontvangen in een POST-array. Het keyword wordt geretourneerd met gedecodeerde %## (het plusteken '+' wordt gedecodeerd naar een spatie)
- languageType: string | null
_code Taalcode in een POST-array
- locationType: integer | null
_code Locatiecode in een POST-array
- pagesType: integer | null Formaat: int64
_count Totaal opgehaalde pagina's met zoekresultaten. Totaal aantal opgehaalde SERP's in het resultaat
- refinementType: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips Chips voor zoekverfijning
- itemsType: array (object | null)[] | null
items van het element
- domainType: string | null
domein in SERP
- optionsType: array (object | null)[] | null
verdere opties voor zoekverfijning
- domainType: string | null
domein in SERP
- titleType: string | null
titel van het element
- typeType: string | null
elementtype
- urlType: string | null
zoek-URL met verfijningsparameters
- titleType: string | null
titel van het element
- typeType: string | null
elementtype
- urlType: string | null
zoek-URL met verfijningsparameters
- typeType: string | null
elementtype
- xpathType: string | null
de XPath van het element
- seType: string | null
_domain zoekmachinedomein in een POST-array
- seType: integer | null Formaat: int64
_results _count totaal aantal resultaten in SERP
- spellType: object | null · Response36Afe1097B20_SpellInfo
autocorrectie van de zoekmachine als de zoekmachine resultaten heeft geleverd voor een gecorrigeerd keyword, geven we het door de zoekmachine gecorrigeerde keyword en het type autocorrectie op
- keywordType: string | null
keyword verkregen als resultaat van de autocorrectie van de zoekmachine de resultaten worden geleverd voor het gecorrigeerde keyword
- typeType: string | null
type autocorrectie mogelijke waarden: did_you_mean, showing_results_for, no_results_found_for, including_results_for let op: Yahoo en Yandex ondersteunen alleen het volgende type autocorrectie: including_results_for
- typeType: string | null
elementtype
- 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/serp/google/organic/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",
"calculate_rectangles": true
}
]'
{
"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,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"refinement_chips": {
"type": null,
"xpath": null,
"items": [
"[Max Depth Exceeded]"
]
},
"item_types": [
null
],
"se_results_count": null,
"pages_count": null,
"items_count": null,
"items": [
{
"type": null,
"page": null,
"position": null,
"xpath": null,
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}