v0.2.0-beta

OpenAPI 3.1.0

OnPage API: Zusammenfassung

Felo API Support

MIT

Server

https://openapi.felo.ai

Client-Bibliotheken

Shell Curl

DataForSEO

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

DataForSEO Operationen

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

OnPage API: Zusammenfassung

Zustand und Kennzahlen eines Crawls, anhand von id. Gibt crawl_progress, crawl_status, crawl_gateway_address, crawl_stop_reason, domain_info und page_metrics zurück. Eingebettet in die DataForSEO-Hülle: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage gibt dennoch HTTP 200 zurück. So erfahren Sie auch, ob ein Crawl abgeschlossen ist – fragen Sie ihn ab, bis crawl_progress den Wert finished hat, bevor Sie einen anderen Endpunkt hier lesen, sonst lesen Sie Teilresultate, die wie echte aussehen. 💰 Upstream kostenlos: das Abfragen eines abgeschlossenen Crawls kostet nichts, nur der Crawl selbst.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.012.
Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen abgerechneten Kundenbetrag anwenden.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Pfadparameter

id
Typ: string
erforderlich

Aufgabenbezeichner
Pflichtfeld
Diese ID erhalten Sie in der Antwort des Endpunkts Task POST
Beispiel:
“07131248-1535-0216-1000-17384017ad04”

Antworten

200
Typ: object | null · Response36Afe1097B20_OnPageSummaryResponseInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

status_code
Typ: integer | null

allgemeiner Statuscode die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

allgemeine Informationsmeldung die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

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

Array von Aufgaben

Typ: object | null · Response36Afe1097B20_OnPageSummaryTaskInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

data
Typ: object | null

Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben

propertyName
Typ: object | null
id
Typ: string | null

Aufgaben-ID eindeutige Aufgaben-ID in unserem System im UUID-Format

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

URL-Pfad

result
Typ: array (object | null)[] | null

Array von Ergebnissen

crawl_gateway_address
Typ: string | null

IP-Adresse des Crawlers
zeigt die IP-Adresse an, die vom Crawler zum Starten der aktuellen Crawling-Sitzung verwendet wird
die vollständige Liste der von unserem Crawler verwendeten IPs finden Sie im Abschnitt Übersicht

crawl_progress
Typ: string | null

Status der Crawling-Sitzung
mögliche Werte: in_progress, finished

crawl_status
Typ: object | null · Response36Afe1097B20_CrawlStatusInfo

Details der Crawling-Sitzung

max_crawl_pages
Typ: integer | null Format: int64

maximale Anzahl der zu crawlenden Seiten gibt das max_crawl_pages-Limit an, das Sie beim Festlegen einer Aufgabe gesetzt haben

pages_crawled
Typ: integer | null Format: int64

Anzahl der gecrawlten Seiten

pages_in_queue
Typ: integer | null Format: int64

Anzahl der Seiten, die sich derzeit in der Crawl-Warteschlange befinden

crawl_stop_reason
Typ: string | null

Grund, warum das Crawling beendet wurde
Informationen zum Grund, warum der Crawling-Prozess beendet wurde;
mögliche Werte:
limit_exceeded - das in max_crawl_pages festgelegte Limit wurde überschritten;
empty_queue - alle URLs in der Warteschlange wurden gecrawlt;
force_stopped - der Crawling-Prozess wurde mit der Funktion On Page API Force Stop angehalten;
unexpected_exception - beim Crawlen des target ist ein interner Fehler aufgetreten; wenden Sie sich für weitere Informationen an den Support

domain_info
Typ: object | null · Response36Afe1097B20_DomainInfo

domainweite Informationen
On-Page-Informationen über die Zieldomain und den Crawling-Prozess

canonicalization_status_code
Typ: integer | null

von einer kanonisierten Seite zurückgegebener Statuscode
die Prüfung des Serververhaltens, wenn unser Crawler versucht, über die IP auf die Website zuzugreifen;
in den meisten Fällen wird empfohlen, dass kanonisierte Seiten mit dem Statuscode 301 oder 302 antworten

checks
Typ: object | null

Website-Prüfungen
weitere On-Page-Prüfungen der Website

propertyName
Typ: boolean | null
cms
Typ: string | null

Content-Management-System
auf einer Website erkanntes Content-Management-System
der Inhalt des generator-Meta-Tags
die Daten stammen von der ersten zufälligen Seite, die den Antwortcode 200 zurückgibt
wenn unser Crawler das CMS nicht identifizieren konnte, ist der Wert null

crawl_end
Typ: string | null

Zeitpunkt des Endes des Crawlings
Datum und Uhrzeit, zu denen das Crawling abgeschlossen wurde
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:
2019-11-15 12:57:46 +00:00
Hinweis: nur aussagekräftig, wenn "crawl_progress" den Wert "finished" hat
wenn "crawl_progress" den Wert in_progress hat, ist der Wert null

crawl_start
Typ: string | null

Zeitpunkt des Starts des Crawlings
Datum und Uhrzeit, zu denen die Website zum Crawling gesendet wurde
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:
2019-11-15 12:57:46 +00:00

directory_browsing_status_code
Typ: integer | null

von einem Verzeichnis zurückgegebener Statuscode
der von einer Verzeichnisseite auf einer Ziel-Website zurückgegebene Statuscode
in den meisten Fällen wird empfohlen, dass Verzeichnisse mit dem Statuscode 403 oder 401 antworten

extended_crawl_status
Typ: string | null

Crawl-Status und Fehler
gibt den Grund an, warum eine Website nicht gecrawlt wurde;
kann folgende Werte annehmen:
no_errors - es wurden keine Crawling-Fehler erkannt;
site_unreachable - unser Crawler konnte eine Website nicht erreichen und daher keinen Statuscode abrufen;
invalid_page_status_code - Statuscode der ersten gecrawlten Seite >= 400;
forbidden_meta_tag - die erste gecrawlte Seite enthält das Tag <meta robots="noindex">;
forbidden_robots - robots.txt verbietet das Crawlen der Seite;
forbidden_http_header - der HTTP-Header der Seite enthält "X-Robots-Tag: noindex" ;
too_many_redirects - die erste gecrawlte Seite hat mehr als 10 Weiterleitungen;
unknown - der Grund ist unbekannt

ip
Typ: string | null

IP-Adresse der Domain

main_domain
Typ: string | null

Root-Domainname

name
Typ: string | null

Domainname

page_not_found_status_code
Typ: integer | null

von einer nicht existierenden Seite zurückgegebener Statuscode
in den meisten Fällen wird empfohlen, dass ein Server den Antwortcode 404 zurückgibt

server
Typ: string | null

Website-Server
die auf einer Website erkannte Serverversion
der Inhalt des Headers server
die Informationen stammen von der ersten Seite, deren Antwortcode 200 ist

ssl_info
Typ: object | null · Response36Afe1097B20_SslInfo

SSL-Zertifikatsinformationen
Informationen über das auf einer Website erkannte Secure Sockets Layer-Protokoll

certificate_expiration_date
Typ: string | null

Ablaufdatum des SSL-Zertifikats
Datum und Uhrzeit, zu der das SSL-Zertifikat abläuft
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:
2019-11-15 12:57:46 +00:00

certificate_hash
Typ: string | null

SSL-Zertifikats-Hash
die Version der Hashfunktion des SSL-Zertifikats

certificate_issuer
Typ: string | null

SSL-Zertifizierungsstelle
die Stelle, die das erkannte SSL-Zertifikat ausgestellt hat

certificate_subject
Typ: string | null

SSL-Zertifikats-Subject
die mit dem öffentlichen Schlüssel verbundene Entität

certificate_version
Typ: integer | null

SSL-Zertifikatsversion
gibt die von einem SSL-Zertifikat verwendete Version von X.509 an

valid_certificate
Typ: boolean | null

Gültigkeit des SSL-Zertifikats
gibt an, ob das auf einer Website erkannte SSL-Zertifikat nicht abgelaufen, ausgesetzt, widerrufen oder ungültig ist

total_pages
Typ: integer | null Format: int64

Gesamtzahl der gecrawlten Seiten
die Gesamtzahl der gecrawlten Seiten

total_uncrawlable_resources
Typ: integer | null Format: int64

Gesamtzahl der nicht crawl baren Ressourcen
die Gesamtzahl der Ressourcen, die nicht gecrawlt werden konnten;
eine Ressource gilt als nicht crawlbar, wenn der tatsächliche Inhaltstyp der Ressource nicht dem vom Crawler erwarteten Inhaltstyp entspricht

www_redirect_status_code
Typ: integer | null

Weiterleitungs-Statuscode
der Statuscode der Weiterleitung von www auf non-www
in den meisten Fällen wird empfohlen, dass die Weiterleitung den Statuscode 301 zurückgibt

page_metrics
Typ: object | null · Response36Afe1097B20_PageMetrics

seitenspezifische Informationen
Metrikinformationen zu den Seiten der Ziel-Website

broken_links
Typ: integer | null

Anzahl defekter Links
Anzahl defekter Links über alle gecrawlten Seiten einer Ziel-Website hinweg

broken_resources
Typ: integer | null

Anzahl defekter Ressourcen
die Anzahl der Bilder und anderen Ressourcen mit defekten Links

checks
Typ: object | null

seitenspezifische On-Page-Prüfungen

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

duplicate_content
Typ: integer | null

Anzahl der Seiten mit doppeltem Inhalt

duplicate_description
Typ: integer | null

Anzahl der Seiten mit doppelten Beschreibungen

duplicate_title
Typ: integer | null

Anzahl der Seiten mit doppelten Titeln

links_external
Typ: integer | null

Anzahl externer Links
die Anzahl der Links, die auf andere Websites verweisen

links_internal
Typ: integer | null

Anzahl interner Links
die Anzahl der Links, die auf andere Seiten innerhalb der Ziel-Website verweisen

links_relation_conflict
Typ: integer | null

Anzahl der Links auf der Ziel-Website, die einen Konflikt haben können
wenn zum Beispiel "links_relation_conflict": 2 gilt, verweist die Ziel-Website mit mindestens einem internen Link mit dem Attribut rel="nofollow" und mit mindestens einem Dofollow-Link auf dieselbe Quelle

non_indexable
Typ: integer | null

Anzahl nicht indexierbarer Seiten
Anzahl der Seiten, deren Indexierung durch Google und andere Suchmaschinen über robots.txt, HTTP-Header oder Meta-Tag-Einstellungen blockiert wird;
eine Liste nicht indexierbarer URLs erhalten Sie über diesen Endpunkt

onpage_score
Typ: number | null

zeigt, wie gut die Website auf einer Skala von 100 Punkten optimiert ist
dieses Feld zeigt, wie die Website unter Berücksichtigung kritischer On-Page-Probleme und erkannter Warnungen optimiert ist;
100 ist die höchstmögliche Punktzahl und bedeutet, dass die Website keine kritischen On-Page-Probleme und wichtigen Warnungen aufweist;
Beachten Sie: Dieser Wert hängt von der Anzahl der gecrawlten Seiten ab;
mehr zur Berechnung dieser Metrik in diesem Hilfeartikel

redirect_loop
Typ: integer | null

Anzahl der Weiterleitungsketten, die an derselben URL beginnen und enden
Anzahl der Weiterleitungsketten, bei denen die Ziel-URL zurück auf die ursprüngliche URL weiterleitet

result_count
Typ: integer | null Format: int64

Anzahl der Elemente im Ergebnis-Array

status_code
Typ: integer | null

Statuscode der Aufgabe von DataForSEO erzeugt, kann im folgenden Bereich liegen: 10000-60000 die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

Informationsmeldung der Aufgabe die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

time
Typ: string | null

Ausführungszeit in Sekunden

tasks_count
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array

tasks_error
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden

time
Typ: string | null

Gesamtausführungszeit, Sekunden

version
Typ: string | null

Die aktuelle Version der API
application/json
400

Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
401

Ein gültiger Felo-API-Schlüssel ist erforderlich.
402

Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
403

Das Konto ist für diesen Vorgang nicht berechtigt.
429

Ein Anfrage- oder Ausgabenlimit wurde erreicht.
502

Der Dienst konnte die Anfrage nicht abschließen.
503

Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
504

Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
default

Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

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 anzeigen

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

Erfolgreicher Vorgang

OnPage API: Zusammenfassung

AuthentifizierungRequired

DataForSEO

OnPage API: Zusammenfassung

Preisreferenz