DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live: uitgebreide Yahoo Organic SERP
Retourneert synchroon de gerangschikte resultaten voor een keyword op Yahoo. 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.02.
- 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)[]
- depthType: integer | null
parsingdiepte
optioneel veld
aantal resultaten in de SERP
standaardwaarde:6
maximale waarde:200
Uw account wordt gefactureerd per SERP;
Elke Yahoo-SERP kan minder dan 10 resultaten bevatten, dus een diepte boven de standaardwaarde kan extra kosten opleveren ;
De kosten kunnen worden berekend op de pagina Prijzen. - deviceType: string | null
apparaattype
optioneel veld
resultaten retourneren voor een bepaald apparaattype
kan de waarden hebben:desktop,mobile
standaardwaarde:desktop - keywordType: string
keyword
verplicht veld
u kunt in het veldkeywordmaximaal 700 tekens opgeven
alle %## worden gedecodeerd (het teken ‘+’ wordt gedecodeerd naar een spatie)
als u het teken “%” in uwkeywordwilt gebruiken, geeft u dit op als “%25”;
als u het teken “+” in uwkeywordwilt gebruiken, geeft u dit op als “%2B”meer informatie over de regels en beperkingen van de velden
keywordenkeywordsin DataForSEO-API's vindt u in dit Helpcentrum-artikel - languageType: string
_code taalcode van de zoekmachine
verplicht veld als ulanguage_nameniet opgeeft
als u dit veld gebruikt, hoeft ulanguage_nameniet op te geven
u kunt de lijst met beschikbare talen van de zoekmachine met hunlanguage_codeopvragen met een afzonderlijk verzoek aanhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
voorbeeld:enn - languageType: string
_name volledige naam van de taal van de zoekmachine
verplicht veld als ulanguage_codeniet opgeeft
als u dit veld gebruikt, hoeft ulanguage_codeniet op te geven
u kunt de lijst met beschikbare talen van de zoekmachine met hunlanguage_nameopvragen met een afzonderlijk verzoek aanhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
voorbeeld:English - locationType: integer
_code locatiecode van de zoekmachine
verplicht veld als u niet opgeeftlocation_nameoflocation_coordinate
als u dit veld gebruikt, hoeft ulocation_nameoflocation_coordinateniet op te geven
de lijst met beschikbare locaties van de zoekmachines met hunlocation_codeontvangt u via een afzonderlijk verzoek aanhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
voorbeeld:2840 - locationType: string
_coordinate GPS-coördinaten van een locatie
verplicht veld als ulocation_nameoflocation_codeniet opgeeft
als u dit veld gebruikt, hoeft ulocation_nameoflocation_codeniet op te geven
de parameterlocation_coordinatemoet in het formaat "latitude,longitude,radius" worden opgegeven
het maximale aantal decimalen voor "latitude" en "longitude": 7
de minimale waarde voor "radius": 199.9 (mm)
de maximale waarde voor "radius": 199999 (mm)
voorbeeld:53.476225,-2.243572,200 - locationType: string
_name volledige naam van de locatie van de zoekmachine
verplicht veld als u niet opgeeftlocation_codeoflocation_coordinate
als u dit veld gebruikt, hoeft ulocation_codeoflocation_coordinateniet op te geven
de lijst met beschikbare locaties van de zoekmachine met hunlocation_nameontvangt u via een afzonderlijk verzoek aanhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
voorbeeld:London,England,United Kingdom - maxType: integer | null
_crawl _pages - osType: string | null
besturingssysteem van het apparaat
optioneel veld
als u in het velddevicedesktopopgeeft, kiest u uit de volgende waarden:windows,macos
standaardwaarde:windows
als u in het velddevicemobileopgeeft, kiest u uit de volgende waarden:android,ios
standaardwaarde:android - seType: string | null
_domain 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:au.search.yahoo.com,uk.search.yahoo.com,ca.search.yahoo.com, enz. - searchType: string | null
_param aanvullende parameters van de zoekopdracht
optioneel veld
bekijk hier de lijst met beschikbare parameters en aanvullende details - 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 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 - targetType: string | null
doeldomein, subdomein of webpagina waarvoor resultaten moeten worden opgehaald
optioneel veld
een domein of subdomein moet worden opgegeven zonderhttps://enwww.
houd er rekening mee dat de resultaten vantarget-specifieke taken alleen SERP-elementen bevatten die eenurl-tekenreeks bevatten;
u kunt ook het 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 zoalshttps://example.com,https://www.example.com/ofhttps://example.com/;example.com- retourneert resultaten voor het domein, inclusief alle pagina's ervan;example.com- retourneert resultaten voor het hele domein, inclusief alle pagina's en subdomeinen;example.com- retourneert resultaten voor de startpagina, ongeacht het subdomein, zoalshttps://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 - urlType: string | null
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://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8
- Type: object | null · Response36Afe1097B20_SerpYahooOrganicLiveAdvancedResponseInfo200
- 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_SerpYahooOrganicLiveAdvancedTaskInfo
- 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
- checkType: string | null
_url directe URL naar 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-indeling: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:2019-11-15 12:57:46 +00:00 - itemType: array (string | null)[] | null
_types - itemsType: array (object | null)[] | null
elementen van zoekresultaten die in de SERP zijn gevonden
- 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
itemswordt geretourneerd - keywordType: string | null
keyword ontvangen in een POST-array
het keyword wordt gedecodeerd geretourneerd (%##; 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
totaal aantal opgehaalde SERP's in het resultaat - refinementType: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips chips voor zoekverfijning
is gelijk aannull- 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 de SERP
- spellType: object | null · Response36Afe1097B20_SpellInfo
autocorrectie van de zoekmachine
als de zoekmachine resultaten heeft geleverd voor een keyword dat is gecorrigeerd, specificeren we het door de zoekmachine gecorrigeerde keyword en het type autocorrectie- 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/yahoo/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"
}
]'
{
"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]"
}
]
}
]
}
]
}