v0.2.0-beta

OpenAPI 3.1.0

OnPage-taken instellen

Felo API Support

MIT

Server

https://openapi.felo.ai

Clientbibliotheken

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operaties

post/v1/beta/dataforseo/on_page/task_post

OnPage-taken instellen

Start een crawl van target en retourneert een taak-id in tasks[0].id – die id is de ingang die elk ander hulpmiddel in deze familie nodig heeft, dus bewaar hem. max_crawl_pages begrenst de crawl, start_url, max_crawl_depth, priority_urls en crawl_delay bepalen de vorm, en store_raw_html beslist of post_dataforseo_on_page_raw_html later iets te bieden heeft. Verpakt in de DataForSEO-envelop: gegevens in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200. ⚠️ Dit is niet het gebruikelijke submit/fetch-paar: de crawl is een sessie die een tiental andere tools vervolgens op id bevraagt. Poll get_dataforseo_on_page_summary tot crawl_progress finished aangeeft; een crawl van example.com met één pagina duurde ruim minder dan een minuut.

Prijsreferentie

Metering: Gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.003.
Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Body

application/json

Type: array (object | null)[]
- accept_language
 Type: string | null
 
 taalheader voor toegang tot de website
 optioneel veld
 alle locale-indelingen worden ondersteund (xx, xx-XX, xxx-XX enz.)
 Let op: als u deze parameter niet opgeeft, kunnen sommige websites de toegang weigeren; in dat geval worden pagina's geretourneerd met "type":"broken in de responsarray
- allow_subdomains
 Type: boolean | null
 
 pagina's op subdomeinen opnemen
 optioneel veld
 stel dit in op true als u alle subdomeinen van een doelwebsite wilt crawlen
 standaardwaarde: false
- allowed_subdomains
 Type: array string[] | null
 
 te crawlen subdomeinen
 optioneel veld
 geef de subdomeinen op die u wilt crawlen
 voorbeeld: ["blog.site.com", "my.site.com", "shop.site.com"]
 Let op: om deze parameter te gebruiken, moet de parameter allow_subdomains op false staan;
 anders wordt de inhoud van het veld allowed_subdomains genegeerd en worden de resultaten voor alle subdomeinen geretourneerd
- browser_preset
 Type: string | null
 
 voorinstelling voor schermparameters van de browser
 optioneel veld
 als u dit veld gebruikt, hoeft u browser_screen_width, browser_screen_height en browser_screen_scale_factor niet op te geven mogelijke waarden:
 desktop, mobile, tablet de voorinstelling desktop past de volgende waarden toe:browser_screen_width: 1920
 browser_screen_height: 1080
 browser_screen_scale_factor: 1 de voorinstelling mobile past de volgende waarden toe:browser_screen_width: 390
 browser_screen_height: 844
 browser_screen_scale_factor: 3 de voorinstelling tablet past de volgende waarden toe:browser_screen_width: 1024
 browser_screen_height: 1366
 browser_screen_scale_factor: 2
 Let op: om deze parameter te gebruiken, stelt u enable_javascript of enable_browser_rendering in op true
- browser_screen_height
 Type: integer | null
 
 schermhoogte van de browser
 optioneel veld
 u kunt een aangepaste schermhoogte van de browser instellen om een audit voor een bepaald apparaat uit te voeren;
 als u dit veld gebruikt, hoeft u browser_preset niet op te geven, omdat dit wordt genegeerd;
 Let op: om deze parameter te gebruiken, stelt u enable_javascript of enable_browser_rendering in op true minimale waarde in pixels: 240
 maximale waarde in pixels: 9999
- browser_screen_scale_factor
 Type: number | null
 
 schaalfactor van het browserscherm
 optioneel veld
 u kunt een aangepaste resolutieverhouding van de browser instellen om een audit voor een bepaald apparaat uit te voeren;
 als u dit veld gebruikt, hoeft u browser_preset niet op te geven, omdat dit wordt genegeerd;
 Let op: om deze parameter te gebruiken, stelt u enable_javascript of enable_browser_rendering in op true minimale waarde: 0.5
 maximale waarde: 3
- browser_screen_width
 Type: integer | null Formaat: int64
 
 schermbreedte van de browser
 optioneel veld
 u kunt een aangepaste schermbreedte van de browser instellen om een audit voor een bepaald apparaat uit te voeren;
 als u dit veld gebruikt, hoeft u browser_preset niet op te geven, omdat dit wordt genegeerd;
 Let op: om deze parameter te gebruiken, stelt u enable_javascript of enable_browser_rendering in op true minimale waarde in pixels: 240
 maximale waarde in pixels: 9999
- calculate_keyword_density
 Type: boolean | null
 
 keyworddichtheid voor het doeldomein berekenen
 optioneel veld
 stel dit in op true als u de keyworddichtheid voor websitepagina's wilt berekenen
 standaardwaarde: false
 Let op: als u deze parameter gebruikt, worden extra kosten in rekening gebracht; meer informatie over de kosten van taken met deze parameter vindt u in ons helpartikel
 zodra de crawl is voltooid, kunt u keyworddichtheidswaarden verkrijgen met het endpoint Keyword Density
- check_spell
 Type: boolean | null
 
 spelling controleren
 optioneel veld
 stel dit in op true om de spelling op een website te controleren met de bibliotheek Hunspell
 standaardwaarde: false
- check_spell_exceptions
 Type: array string[] | null
 
 woorden die van de spellingcontrole worden uitgesloten
 optioneel veld
 geef de woorden op die u van de spellingcontrole wilt uitsluiten
 maximale woordlengte: 100 tekens
 maximaal aantal woorden: 1000
 voorbeeld: "SERP", "minifiers", "JavaScript"
- check_spell_language
 Type: string | null
 
 taal van de spellingcontrole
 optioneel veld
 ondersteunde talen: 'hy', 'eu', 'bg', 'ca', 'hr', 'cs', 'da', 'nl', 'en', 'eo', 'et', 'fo', 'fa', 'fr', 'fy', 'gl', 'ka', 'de', 'el', 'he', 'hu', 'is', 'ia', 'ga', 'it', 'rw', 'la', 'lv', 'lt', 'mk', 'mn', 'ne', 'nb', 'nn', 'pl', 'pt', 'ro', 'gd', 'sr', 'sk', 'sl', 'es', 'sv', 'tr', 'tk', 'uk', 'vi'
 Let op: als er geen taal is opgegeven, wordt deze automatisch bepaald op basis van de pagina-inhoud
- checks_threshold
 Type: object | null
 
 aangepaste drempelwaarden voor controles
 optioneel veld
 u kunt aangepaste drempelwaarden opgeven voor de parameters in het object checks van OnPage API-responsen;
 Let op: alleen gehele drempelwaarden kunnen worden gewijzigd;
 de parameters high_loading_time en large_page_size staan bijvoorbeeld standaard op respectievelijk 3 seconden en 1 megabyte;
 als u deze drempelwaarden wilt wijzigen in 1 seconde en 1000 kbytes, gebruikt u het volgende fragment:
 "checks_threshold": { "high_loading_time": 1, "large_page_size": 1000 }
 aanpasbare parameters met standaardwaarden:
 "title_too_short", default value: 30, type: "int" "title_too_long", default value: 65, type: "int" "small_page_size", default value: 1024, type: "int" "large_page_size", default value: 1048576 (1024 * 1024), type: "int" "low_character_count", default value: 1024, type: "int" "high_character_count", default value: 256000 (250 * 1024), type: "int" "low_content_rate", default value: 0.1, type: "float" "high_content_rate", default value: 0.9, type: "float" "high_loading_time", default value: 3000, type: "int" "high_waiting_time", default value: 1500, type: "int" "low_readability_rate", default value: 15.0, type: "float" "irrelevant_description", default value: 0.2, type: "float" "irrelevant_title", default value: 0.3, type: "float" "irrelevant_meta_keywords", default value: 0.6, type: "float"
 
 propertyName
 Type: integer | null Formaat: int64
 
 Signed 64-bit integers (long type).
- crawl_delay
 Type: integer | null
 
 vertraging tussen hits, ms
 optioneel veld
 de aangepaste vertraging tussen crawlerverzoeken aan de server
 standaardwaarde: 2000
- crawl_sitemap_only
 Type: boolean | null
 
 alleen pagina's crawlen die in de sitemap staan
 optioneel veld
 stel in op true als u alleen de pagina's wilt crawlen die in de sitemap staan
 als u deze parameter op true instelt en custom_sitemap niet opgeeft, crawlen we de standaardsitemap
 standaardwaarde: false
 Let op: als u deze parameter wilt gebruiken, moet respect_sitemap true zijn
- custom_js
 Type: string | null
 
 aangepaste JavaScript
 optioneel veld
 Let op: de uitvoeringstijd voor het script dat u hier invoert, mag maximaal 700 ms bedragen; met het volgende JS-fragment kunt u bijvoorbeeld controleren of de website Google Tag Manager bevat als scr-attribuut:
 let meta = { haveGoogleAnalytics: false, haveTagManager: false };rnfor (var i = 0; i < document.scripts.length; i++) {rn let src = document.scripts[i].getAttribute("src");rn if (src != undefined) {rn if (src.indexOf("analytics.js") >= 0)rn meta.haveGoogleAnalytics = true;rntif (src.indexOf("gtm.js") >= 0)rn meta.haveTagManager = true;rn }rn}rnmeta;de geretourneerde waarde hangt af van wat u in dit veld hebt opgegeven. Als u bijvoorbeeld het volgende script opgeeft:
 meta = {}; meta.url = document.URL; meta.test = 'test'; meta;
 dan ontvangt u als antwoord de volgende gegevens:
 "custom_js_response": { "url": "https://dataforseo.com/", "test": "test" }
 Let op: de lengte van het ingevoerde script mag niet meer dan 2000 tekens bedragen
- custom_robots_txt
 Type: string | null
 
 aangepaste robots.txt-instellingen
 optioneel veld
 voorbeeld: Disallow: /directory1/
- custom_sitemap
 Type: string | null
 
 URL van aangepaste sitemap
 optioneel veld
 de URL van de pagina waar de alternatieve sitemap staat
 Let op: als u deze parameter wilt gebruiken, moet respect_sitemap true zijn
- custom_user_agent
 Type: string | null
 
 aangepaste user-agent
 optioneel veld
 aangepaste user-agent voor het crawlen van een website
 voorbeeld: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
 standaardwaarde: Mozilla/5.0 (compatible; RSiteAuditor)
- disable_cookie_popup
 Type: boolean | null
 
 cookiepop-up uitschakelen
 optioneel veld
 stel in op true als u de pop-up voor cookietoestemming van de gebruiker wilt uitschakelen;
 standaardwaarde:
 false
- disable_page_checks
 Type: array string[] | null
 
 bepaalde paginacontroles verhinderen
 optioneel veld
 geef bepaalde checks op om te voorkomen dat ze worden uitgevoerd en de onpage_score beïnvloeden. voorbeeld:
 "disable_page_checks": ["is_5xx_code", "is_4xx_code"]
- disable_sitewide_checks
 Type: array string[] | null
 
 bepaalde sitebrede controles verhinderen
 optioneel veld
 geef de volgende checks op om te voorkomen dat ze op de website target worden uitgevoerd:
 "test_page_not_found"
 "test_canonicalization"
 "test_https_redirect"
 "test_directory_browsing"voorbeeld:
 "disable_sitewide_checks": ["test_directory_browsing", "test_page_not_found"]meer informatie in ons Help Center
- disallowed_subdomains
 Type: array string[] | null
 
 subdomeinen die niet gecrawld mogen worden
 optioneel veld
 geef subdomeinen op die u niet wilt crawlen
 voorbeeld: ["status.site.com", "docs.site.com"]
 Let op: om deze parameter te gebruiken, moet de parameter allow_subdomains op true zijn ingesteld
- enable_browser_rendering
 Type: boolean | null
 
 browserrendering emuleren om Core Web Vitals te meten
 optioneel veld
 met deze parameter kunt u een browser emuleren bij het laden van een webpagina;
 enable_browser_rendering laadt stijlen, afbeeldingen, lettertypen, animaties, video's en andere bronnen op een pagina;
 standaardwaarde: false
 stel in op true om Core Web Vitals-metrics (FID, CLS, LCP) in de respons te ontvangen;
 als u dit veld gebruikt, moeten de parameters enable_javascript en load_resources op true zijn ingesteld
 Let op: als u deze parameter gebruikt, worden extra kosten in rekening gebracht; meer informatie over de kosten van taken met deze parameter vindt u in ons helpartikel; de kosten kunnen worden berekend op de prijspagina
- enable_content_parsing
 Type: boolean | null
 
 inhoud van gecrawlde pagina's parseren
 optioneel veld
 stel in op true om het OnPage Content Parsing-endpoint te gebruiken
 standaardwaarde: false
- enable_javascript
 Type: boolean | null
 
 JavaScript op een pagina laden
 optioneel veld
 stel in op true als u de scripts wilt laden die op een pagina beschikbaar zijn
 standaardwaarde: false
 Let op: als u deze parameter gebruikt, worden extra kosten in rekening gebracht; meer informatie over de kosten van taken met deze parameter vindt u in ons helpartikel; de kosten kunnen worden berekend op de prijspagina
- enable_www_redirect_check
 Type: boolean | null
 
 controleren of het domein de www-doorverwijzing heeft geïmplementeerd
 optioneel veld
 stel in op true als u wilt controleren of het opgevraagde domein de doorverwijzing van www naar non-www of van non-www naar www heeft geïmplementeerd;
 standaardwaarde: false
- enable_xhr
 Type: boolean | null
 
 XMLHttpRequest op een pagina inschakelen
 optioneel veld
 stel in op true als u wilt dat onze crawler gegevens opvraagt bij een webserver via het XMLHttpRequest-object
 standaardwaarde: false;als u dit veld gebruikt, moet enable_javascript op true zijn ingesteld;
- force_sitewide_checks
 Type: boolean | null
 
 sitebrede controles inschakelen bij het crawlen van één pagina
 optioneel veld
 stel in op true om gegevens over sitebrede controles te ontvangen bij het crawlen van één pagina;
 standaardwaarde: false
- load_resources
 Type: boolean | null
 
 bronnen laden
 optioneel veld
 stel in op true als u afbeeldingen, stylesheets, scripts en defecte bronnen wilt laden
 standaardwaarde: false
 Let op: als u deze parameter gebruikt, worden extra kosten in rekening gebracht; meer informatie over de kosten van taken met deze parameter vindt u in ons helpartikel; de kosten kunnen worden berekend op de prijspagina
- max_crawl_depth
 Type: integer | null
 
 crawldiepte
 optioneel veld
 de koppelingsdiepte van de te crawlen pagina's;
 de startpagina van de crawl is bijvoorbeeld niveau 0, pagina's met links vanaf die pagina zijn niveau 1, enz.
- max_crawl_pages
 Type: integer
 
 limiet voor gecrawlde pagina's
 verplicht veld
 het aantal pagina's dat op het opgegeven domein wordt gecrawld
 Let op:
 als u max_crawl_pages op 1 instelt en start_url niet opgeeft of daarin een startpagina instelt, worden de volgende sitebrede controles uitgeschakeld:
 test_canonicalization, enable_www_redirect_check, test_hidden_server_signature, test_page_not_found, test_directory_browsing, test_https_redirect
 om ze toch in te schakelen, stelt u force_sitewide_checks in op trueals u max_crawl_pages op 1 instelt en een andere start_url dan een startpagina opgeeft, worden alle sitebrede controles uitgeschakeld;
 om ze toch in te schakelen, stelt u force_sitewide_checks in op true
- pingback_url
 Type: string | null
 
 meldings-URL van een voltooide taak
 optioneel veld
 wanneer een taak is voltooid, melden we je dit via een GET-verzoek naar de URL die je hebt opgegeven
 je 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 vind je in ons Help Center
- priority_urls
 Type: array string[] | null
 
 URL's die met omzeiling van de wachtrij worden gecrawld
 optioneel veld
 URL's in deze array worden als eerste gecrawld, met omzeiling van de crawlwachtrij;
 Let op: u moet de absolute URL opgeven;
 u kunt maximaal 20 URL's opgeven;
 alle URL's in de array moeten bij het domein target horen;
 subdomeinen worden genegeerd tenzij de parameter allow_subdomains op true is ingesteldvoorbeeld:
 "priority_urls": [ "https://dataforseo.com/apis/serp-api", "https://dataforseo.com/contact" ]
- respect_sitemap
 Type: boolean | null
 
 sitemap respecteren bij het crawlen
 optioneel veld
 stel in op true als u bij het crawlen de volgorde wilt volgen van de pagina's die in de primaire sitemap staan;
 standaardwaarde: false
 Let op: bij true is de waarde van click_depth in de API-respons gelijk aan 0;
 het veld max_crawl_depth van het verzoek wordt genegeerd; u kunt het aantal te crawlen pagina's opgeven met de parameter max_crawl_pages
- return_despite_timeout
 Type: boolean | null
 
 gegevens over pagina's retourneren ondanks de time-outfout
 optioneel veld
 bij true worden gegevens geleverd voor pagina's die binnen 120 seconden niet konden worden geladen en met een time-outfout hebben geantwoord;
 standaardwaarde: false
- robots_txt_merge_mode
 Type: string | null
 
 robots.txt-instellingen samenvoegen of overschrijven
 optioneel veld
 mogelijke waarden: merge, override;
 stel in op override als u de crawlbeperkingen van de website en andere robots.txt-instellingen wilt negeren
 standaardwaarde: merge;
 Let op: geef bij override de parameter custom_robots_txt op
- start_url
 Type: string | null
 
 de eerste te crawlen URL
 optioneel veld
 Let op: u moet een absolute URL opgeven
 als u één pagina wilt crawlen, geeft u de URL ervan in dit veld op en stelt u bovendien de parameter max_crawl_pages in op 1
 u kunt ook het live Instant Pages-endpoint gebruiken om paginaspecifieke gegevens te verkrijgen
- store_raw_html
 Type: boolean | null
 
 HTML van gecrawlde pagina's opslaan
 optioneel veld
 stel in op true als u de HTML van de pagina wilt ophalen via het OnPage Raw HTML-endpoint
 standaardwaarde: false
- support_cookies
 Type: boolean | null
 
 cookies op gecrawlde pagina's ondersteunen
 optioneel veld
 stel in op true om cookies te ondersteunen bij het crawlen van de pagina's
 standaardwaarde: false
- switch_pool
 Type: boolean | null
 
 van proxypool wisselen
 optioneel veld
 als dit true is, worden aanvullende proxypools gebruikt om de opgevraagde gegevens te verkrijgen;
 de parameter kan worden gebruikt als veel taken tegelijk worden ingesteld, wat leidt tot incidentele rate-limit- en/of site_unreachable-fouten
- tag
 Type: 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 waarde tag vind je in het data-object van de respons
- target
 Type: string
 
 doeldomein
 verplicht veld
 de domeinnaam moet worden opgegeven zonder https:// en www.
 als u de pagina-URL opgeeft, worden de resultaten geretourneerd voor het domein in de URL
- validate_micromarkup
 Type: boolean | null
 
 microdata-validatie inschakelen
 optioneel veld
 stel in op true als u het OnPage API Microdata-endpoint wilt gebruiken
 standaardwaarde: false

Responsen

200
Type: object | null · Response36Afe1097B20_OnPageTaskPostResponseInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

status_code
Type: integer | null

algemene statuscode de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier

tasks
Type: array (object | null)[] | null

array van taken

Type: object | null · Response36Afe1097B20_OnPageTaskPostTaskInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

data
Type: object | null

Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven

propertyName
Type: object | null
id
Type: string | null

taak-id eenduidige taak-id in ons systeem in UUID-indeling

path
Type: array (string | null)[] | null

URL-pad

result
Type: object | null

array van resultaten
in dit geval is de waarde null

result_count
Type: integer | null Formaat: int64

Aantal elementen in de result-array

status_code
Type: integer | null

statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier

time
Type: string | null

Uitvoeringstijd in seconden

tasks_count
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array

tasks_error
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array dat met een fout is geretourneerd

time
Type: string | null

totale uitvoeringstijd, seconden

version
Type: string | null

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

post/v1/beta/dataforseo/on_page/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "max_crawl_pages": 10,
    "load_resources": true,
    "enable_javascript": true,
    "custom_js": "meta = {}; meta.url = document.URL; meta;",
    "tag": "some_string_123",
    "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
  }
]'

Schema tonen

{
  "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": null
    }
  ]
}

Geslaagde bewerking

OnPage-taken instellen

AuthenticatieRequired

DataForSEO

OnPage-taken instellen

Prijsreferentie