v0.2.0-beta

OpenAPI 3.1.0

OnPage API: pagina-schermafbeelding

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/page_screenshot

OnPage API: pagina-schermafbeelding

Rendert een willekeurige url en retourneert een schermafbeelding, met full_page_screenshot voor de volledige scrolhoogte en browser_screen_width en browser_screen_height voor de viewport. Op zichzelf staand – geen crawl nodig. Verpakt in de DataForSEO-envelop: gegevens in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200. ⚠️ Een afbeelding is een groot toolresultaat, nog voordat een agent er iets mee kan; vraag alleen om een schermafbeelding als het visuele het punt is, en gebruik post_dataforseo_on_page_content_parsing_live als het om de tekst gaat.

Prijsreferentie

Metering: Gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.0051.
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 ontvangt u "error_message":"Screenshot is empty" in de responsarray
- 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: in dit endpoint zijn de parameters enable_browser_rendering, enable_javascript, load_resources en enable_xhr altijd ingeschakeld.
- 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;
  
  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;
  
  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;
  
  minimale waarde in pixels: 240
  maximale waarde in pixels: 9999
- 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
  
  cookiepopup uitschakelen
  optioneel veld
  stel dit in op true als u de popup wilt uitschakelen waarin de gebruiker om cookie-toestemming wordt gevraagd;
  standaardwaarde:
  false
- full_page_screenshot
  Type: boolean | null
  
  een schermafbeelding van de volledige pagina maken
  optioneel veld
  stel dit in op false als u alleen het deel van de pagina wilt vastleggen dat vóór het scrollen wordt weergegeven
  standaardwaarde: true
- ip_pool_for_scan
  Type: string | null
  
  proxypool
  optioneel veld
  u kunt een locatie kiezen voor de proxypool die wordt gebruikt om de opgevraagde gegevens te verkrijgen;
  de parameter kan worden gebruikt als pagina-inhoud op een van de locaties niet toegankelijk is, wat leidt tot incidentele site_unreachable-fouten
  mogelijke waarden: us, de
- 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
- url
  Type: string
  
  pagina-URL
  verplicht veld
  absolute URL van de pagina die moet worden vastgelegd
  Let op: als de hier opgegeven URL een statuscode 404 retourneert of de opgegeven waarde geen geldige URL is, ontvangt u "error_message":"Screenshot is empty" in de responsarray

Responsen

200
Type: object | null · Response36Afe1097B20_OnPagePageScreenshotResponseInfo
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_OnPagePageScreenshotTaskInfo
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: array (object | null)[] | null

array van resultaten

crawl_progress
Type: string | null

status van de crawlsessie
mogelijke waarden: in_progress, finished

error_message
Type: string | null

foutmelding
als de door u opgegeven url statuscode 404 retourneert of geen geldige URL is, krijgt u "error_message":"Screenshot is empty"
als er geen fout optreedt, is de waarde null

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

items-array

image
Type: string | null

screenshot van de opgevraagde pagina
URL van de paginascreenshot in de DataForSEO-opslag
let op: de paginascreenshot die in de DataForSEO-opslag is opgeslagen, blijft slechts één dag na het maken van de aanvraag toegankelijk

items_count
Type: integer | null Formaat: int64

aantal items in de resultatenarray

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/page_screenshot

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/page_screenshot \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "url": "https://dataforseo.com/apis"
  }
]'

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": [
        {
          "crawl_progress": null,
          "error_message": null,
          "items_count": null,
          "items": [
            {
              "image": null
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

OnPage API: pagina-schermafbeelding

AuthenticatieRequired

DataForSEO

OnPage API: pagina-schermafbeelding

Prijsreferentie