Google Organic SERP-taken instellen

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 mobile op android;

812 voor mobile op iOS;

Let op: om deze parameter te gebruiken, stelt u calculate_rectangles in op true

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 mobile op android;

3 voor mobile op iOS;

Let op: om deze parameter te gebruiken, stelt u calculate_rectangles in op true

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 mobile op android;

375 voor mobile op iOS;

Let op: om deze parameter te gebruiken, stelt u calculate_rectangles in op true

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,0006 extra in rekening gebracht

parseerdiepte

optioneel veld

aantal resultaten in de SERP

standaardwaarde: 10

maximumwaarde: 700

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.

apparaattype

optioneel veld

resultaten retourneren voor een bepaald apparaattype

kan de waarden hebben:desktop, mobile

standaardwaarde: desktop

ai_overview uitvouwen

optioneel veld

stel in op true om het item ai_overview uit te vouwen;

standaardwaarde: false;

Let op: deze parameter is alleen van toepassing op HTML-taakresultaten

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

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

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

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:’, ‘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

taalcode van de zoekmachine

verplicht veld als u niet opgeeft language_name

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

volledige naam van de taal van de zoekmachine

verplicht veld als u niet opgeeft language_code

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

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,0006 extra in rekening gebracht;

als het element ontbreekt of "asynchronous_ai_overview": false bevat, worden alle extra kosten aan uw accountsaldo terugbetaald

locatiecode van de zoekmachine

verplicht veld als u niet opgeeft location_name of location_coordinate

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

GPS-coördinaten van een locatie

verplicht veld als niet opgegeven location_name of location_code

bij gebruik van dit veld hoef je location_name of location_code niet op te geven

de parameter location_coordinate moet in het formaat "latitude,longitude,radius" worden opgegeven

het 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

volledige naam van de locatie van de zoekmachine

verplicht veld als u niet opgeeft location_code of location_coordinate

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

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

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-*"

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

besturingssysteem van het apparaat

optioneel veld

als u desktop in het veld device opgeeft, kiest u uit de volgende waarden: windows, macos

standaardwaarde: windows

als u mobile in het veld device opgeeft, kiest u uit de volgende waarden: android, ios

standaardwaarde: android

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, ongeacht de taakprioriteit;

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

meldings-URL van een voltooide taak

optioneel veld

wanneer een taak is voltooid, melden we u dit via een GET-verzoek naar de URL die u hebt opgegeven

u 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=$id

http://your-server.com/pingscript?id=$id&tag=$tag

Let op: speciale tekens in pingback_url worden URL-gecodeerd;

d.w.z. het teken # wordt gecodeerd als %23

meer informatie vindt u in ons Help Center

postback_url-datatype

verplicht veld als u postback_url opgeeft

komt overeen met het datatype dat naar uw server wordt verzonden

mogelijke waarden:

regular, advanced, html

URL voor het verzenden van taakresultaten

optioneel veld

zodra de taak is voltooid, sturen wij een POST-verzoek met de resultaten, gecomprimeerd in de gzip-indeling, naar de door u opgegeven postback_url

u kunt de tekenreeks ‘$id’ gebruiken als $id-variabele en ‘$tag’ als url-gecodeerde $tag-variabele. Wij stellen de benodigde waarden in voordat het verzoek wordt verzonden

voorbeeld:

http://your-server.com/postbackscript?id=$id

http://your-server.com/postbackscript?id=$id&tag=$tag

Opmerking: speciale tekens in postback_url worden url-gecodeerd;

o.a. wordt het teken # gecodeerd als %23

meer informatie vindt u in ons Helpcentrum

taakprioriteit

optioneel veld

kan de volgende waarden aannemen:

1 – normale uitvoeringsprioriteit (standaard ingesteld);

2 – hoge uitvoeringsprioriteit

Voor taken met een hoge uitvoeringsprioriteit worden extra kosten in rekening gebracht.

De kosten kunnen worden berekend op de pagina Prijzen.

specifieke parameters uit URL's verwijderen

optioneel veld

met dit veld kunt u maximaal 10 parameters opgeven die uit URL's in het resultaat moeten worden verwijderd

voorbeeld:

"remove_from_url": ["srsltid"]

zoekmachinedomein

optioneel veld

wij kiezen het relevante zoekmachinedomein automatisch op basis van de door u opgegeven locatie en taal

u kunt echter een aangepast zoekmachinedomein instellen in dit veld

voorbeeld:

google.co.uk, google.com.au, google.de, enz.

aanvullende parameters van de zoekopdracht

optioneel veld

bekijk hier de lijst met beschikbare parameters en aanvullende details

Opmerking: de volgende zoekmachineparameters worden niet ondersteund en worden automatisch uitgeschakeld als ze worden opgegeven: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.

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

door gebruiker gedefinieerde taakidentificatie

optioneel veld

de tekenlimiet is 255

u kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen

u vindt de opgegeven tag-waarde in het data-object van de respons

modus voor doelovereenkomst

optioneel veld

om deze parameter in te schakelen, moet stop_crawl_on_match ook 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 zodra één enkel doel is gevonden

standaardwaarde: any

meer informatie over deze parameter vindt u in ons Helpcentrum

directe URL van de zoekopdracht

optioneel veld

u kunt een directe URL opgeven en wij leiden de benodigde velden daaruit af. Houd er rekening mee dat deze methode het moeilijkst is voor onze API om te verwerken en dat u ook de exacte taal en locatie in de URL moet opgeven. In de meeste gevallen raden wij deze methode niet aan.

voorbeeld:

https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS

Opmerking: de volgende zoekmachineparameters worden niet ondersteund en worden automatisch uitgeschakeld als ze in de URL worden opgegeven: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.