v0.2.0-beta

OpenAPI 3.1.0

OnPage API: samenvatting

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

get/v1/beta/dataforseo/on_page/summary/{id}

OnPage API: samenvatting

De status en kerncijfers van één crawl, op id. Retourneert crawl_progress, crawl_status, crawl_gateway_address, crawl_stop_reason, domain_info en page_metrics. 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 ook de manier om te weten dat een crawl klaar is – poll tot crawl_progress de waarde finished heeft voordat je een ander endpoint hier leest, anders lees je gedeeltelijke resultaten die op echte lijken. 💰 Gratis upstream: een voltooide crawl bevragen kost niets, alleen de crawl zelf.

Prijsreferentie

Metering: Gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.012.
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.

Padparameters

id
Type: string
verplicht

taakidentificatie
verplicht veld
deze ID vindt u in de respons van het endpoint Task POST
voorbeeld:
“07131248-1535-0216-1000-17384017ad04”

Responsen

200
Type: object | null · Response36Afe1097B20_OnPageSummaryResponseInfo
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_OnPageSummaryTaskInfo
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_gateway_address
Type: string | null

IP-adres van de crawler
toont het IP-adres dat de crawler gebruikt om de huidige crawlsessie te starten
de volledige lijst met IP's die onze crawler gebruikt, vindt u in de sectie Overzicht

crawl_progress
Type: string | null

status van de crawlsessie
mogelijke waarden: in_progress, finished

crawl_status
Type: object | null · Response36Afe1097B20_CrawlStatusInfo

details van de crawlsessie

max_crawl_pages
Type: integer | null Formaat: int64

maximaal aantal te crawlen pagina's geeft de max_crawl_pages-limiet aan die u hebt opgegeven bij het instellen van een taak

pages_crawled
Type: integer | null Formaat: int64

aantal gecrawlde pagina's

pages_in_queue
Type: integer | null Formaat: int64

aantal pagina's dat momenteel in de crawlwachtrij staat

crawl_stop_reason
Type: string | null

reden waarom het crawlen is gestopt
informatie over de reden waarom het crawlproces is gestopt;
mogelijke waarden:
limit_exceeded - de limiet die in max_crawl_pages is ingesteld, is overschreden;
empty_queue - alle URL's in de wachtrij zijn gecrawld;
force_stopped - het crawlproces is gestopt met de functie On Page API Force Stop;
unexpected_exception - er is een interne fout opgetreden tijdens het crawlen van de target; neem contact op met support voor meer informatie

domain_info
Type: object | null · Response36Afe1097B20_DomainInfo

domeinbrede informatie
on-page-informatie over het doeldomein en het crawlproces

canonicalization_status_code
Type: integer | null

statuscode die door een geconicaliseerde pagina wordt geretourneerd
de controle van het servergedrag wanneer onze crawler de website via IP probeert te bereiken;
in de meeste gevallen wordt aanbevolen dat geconicaliseerde pagina's met een statuscode 301 of 302 reageren

checks
Type: object | null

websitecontroles
overige on-page controles met betrekking tot de website

propertyName
Type: boolean | null
cms
Type: string | null

contentmanagementsysteem
contentmanagementsysteem dat op een website is gedetecteerd
de inhoud van de metatag generator
de gegevens zijn afkomstig van de eerste willekeurige pagina die responscode 200 retourneert
als onze crawler het CMS niet kon identificeren, is de waarde null

crawl_end
Type: string | null

tijd waarop het crawlen is beëindigd
datum en tijd waarop het crawlen is voltooid
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00
Opmerking: alleen informatief als "crawl_progress" gelijk is aan "finished"
als "crawl_progress" gelijk is aan in_progress, is de waarde null

crawl_start
Type: string | null

tijd waarop het crawlen is gestart
datum en tijd waarop de website voor het crawlen is verzonden
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

directory_browsing_status_code
Type: integer | null

statuscode die door een directory wordt geretourneerd
de statuscode die door een directorypagina op een doelwebsite wordt geretourneerd
in de meeste gevallen wordt aanbevolen dat directory's met een statuscode 403 of 401 reageren

extended_crawl_status
Type: string | null

crawlstatus en fouten
geeft de reden aan waarom een website niet is gecrawld;
kan de volgende waarden hebben:
no_errors - er zijn geen crawlfouten gedetecteerd;
site_unreachable - onze crawler kon een website niet bereiken en dus geen statuscode ophalen;
invalid_page_status_code - statuscode van de eerste gecrawlde pagina >= 400;
forbidden_meta_tag - de eerste gecrawlde pagina bevat de tag <meta robots="noindex">;
forbidden_robots - robots.txt verbiedt het crawlen van de pagina;
forbidden_http_header - de HTTP-header van de pagina bevat "X-Robots-Tag: noindex" ;
too_many_redirects - de eerste gecrawlde pagina heeft meer dan 10 redirects;
unknown - de reden is onbekend

ip
Type: string | null

IP-adres van het domein

main_domain
Type: string | null

rootdomeinnaam

name
Type: string | null

domeinnaam

page_not_found_status_code
Type: integer | null

statuscode die door een niet-bestaande pagina wordt geretourneerd
in de meeste gevallen wordt aanbevolen dat een server een 404-responscode retourneert

server
Type: string | null

websiteserver
de op een website gedetecteerde serverversie
de inhoud van de header server
de informatie is afkomstig van de eerste pagina met responscode 200

ssl_info
Type: object | null · Response36Afe1097B20_SslInfo

ssl-certificaatinformatie
informatie over het op een website gedetecteerde Secure Sockets Layer-protocol

certificate_expiration_date
Type: string | null

vervaldatum van het SSL-certificaat
de datum en tijd waarop het SSL-certificaat verloopt
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

certificate_hash
Type: string | null

hash van het SSL-certificaat
de versie van de hashfunctie van het SSL-certificaat

certificate_issuer
Type: string | null

certificaatautoriteit van het SSL-certificaat
de entiteit die het gedetecteerde SSL-certificaat heeft uitgegeven

certificate_subject
Type: string | null

subject van het SSL-certificaat
de entiteit die aan de openbare sleutel is gekoppeld

certificate_version
Type: integer | null

versie van het SSL-certificaat
geeft de versie van X.509 aan die door een SSL-certificaat wordt gebruikt

valid_certificate
Type: boolean | null

geldigheid van het SSL-certificaat
geeft aan of het op een website gedetecteerde SSL-certificaat niet verlopen, opgeschort, ingetrokken of ongeldig is

total_pages
Type: integer | null Formaat: int64

totaal aantal gecrawlde pagina's
het totale aantal gecrawlde pagina's

total_uncrawlable_resources
Type: integer | null Formaat: int64

totaal aantal niet-crawlbare bronnen
het totale aantal bronnen dat niet kon worden gecrawld;
een bron wordt als niet-crawlbaar beschouwd wanneer het werkelijke inhoudstype van de bron niet overeenkomt met het inhoudstype dat de crawler verwacht

www_redirect_status_code
Type: integer | null

redirectstatuscode
de statuscode van de redirect van www naar non-www
in de meeste gevallen wordt aanbevolen dat de redirect een statuscode 301 retourneert

page_metrics
Type: object | null · Response36Afe1097B20_PageMetrics

paginaspecifieke informatie
metriekinformatie over de pagina's van de doelwebsite

broken_links
Type: integer | null

aantal kapotte links
aantal kapotte links op alle gecrawlde pagina's van een doelwebsite

broken_resources
Type: integer | null

aantal kapotte resources
het aantal afbeeldingen en andere resources met kapotte links

checks
Type: object | null

paginaspecifieke on-pagecontroles

propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

duplicate_content
Type: integer | null

aantal pagina's met dubbele inhoud

duplicate_description
Type: integer | null

aantal pagina's met dubbele beschrijvingen

duplicate_title
Type: integer | null

aantal pagina's met dubbele titels

links_external
Type: integer | null

aantal externe links
het aantal links dat naar andere websites verwijst

links_internal
Type: integer | null

aantal interne links
het aantal links dat naar andere pagina's binnen de doelwebsite verwijst

links_relation_conflict
Type: integer | null

aantal links op de doelwebsite dat mogelijk een conflict heeft
als bijvoorbeeld "links_relation_conflict": 2 geldt, verwijst de doelwebsite met ten minste één interne link met het attribuut rel="nofollow" en met ten minste één dofollow-link naar dezelfde bron

non_indexable
Type: integer | null

aantal niet-indexeerbare pagina's
aantal pagina's waarvan indexering door Google en andere zoekmachines wordt geblokkeerd via robots.txt, HTTP-headers of metataginstellingen;
een lijst met niet-indexeerbare URL's kunt u opvragen met dit endpoint

onpage_score
Type: number | null

toont hoe de website is geoptimaliseerd op een schaal van 100 punten
dit veld toont hoe de website is geoptimaliseerd rekening houdend met kritieke on-pageproblemen en gedetecteerde waarschuwingen;
100 is de hoogst mogelijke score en betekent dat de website geen kritieke on-pageproblemen en belangrijke waarschuwingen heeft;
Let op: deze waarde is afhankelijk van het aantal gecrawlde pagina's;
meer over hoe de metriek wordt berekend in dit helpcentrumartikel

redirect_loop
Type: integer | null

aantal redirectketens die bij dezelfde URL beginnen en eindigen
aantal redirectketens waarbij de doel-URL terugverwijst naar de oorspronkelijke URL

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

get/v1/beta/dataforseo/on_page/summary/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/summary/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

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,
          "crawl_status": {
            "max_crawl_pages": null,
            "pages_in_queue": null,
            "pages_crawled": null
          },
          "crawl_gateway_address": null,
          "crawl_stop_reason": null,
          "domain_info": {
            "name": null,
            "cms": null,
            "ip": null,
            "server": null,
            "crawl_start": null,
            "crawl_end": null,
            "extended_crawl_status": null,
            "ssl_info": "[Max Depth Exceeded]",
            "checks": null,
            "total_pages": null,
            "total_uncrawlable_resources": null,
            "page_not_found_status_code": null,
            "canonicalization_status_code": null,
            "directory_browsing_status_code": null,
            "www_redirect_status_code": null,
            "main_domain": null
          },
          "page_metrics": {
            "links_external": null,
            "links_internal": null,
            "duplicate_title": null,
            "duplicate_description": null,
            "duplicate_content": null,
            "broken_links": null,
            "broken_resources": null,
            "links_relation_conflict": null,
            "redirect_loop": null,
            "onpage_score": null,
            "non_indexable": null,
            "checks": null
          }
        }
      ]
    }
  ]
}

Geslaagde bewerking

OnPage API: samenvatting

AuthenticatieRequired

DataForSEO

OnPage API: samenvatting

Prijsreferentie