v0.2.0-beta

OpenAPI 3.1.0

OnPage API: Ressourcen

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

post/v1/beta/dataforseo/on_page/resources

OnPage API: Ressourcen

Die Nicht-Seiten-Assets, die ein Crawl gefunden hat – Bilder, Skripte, Stylesheets – mit ihren Statuscodes und Größen. Seiten mit search_after_token. Liest einen abgeschlossenen Crawl und benötigt daher die id aus post_dataforseo_on_page_submit; gibt crawl_progress sowie einen crawl_status aus max_crawl_pages, pages_in_queue und pages_crawled zurück – prüfen Sie diese, bevor Sie einem kleinen Ergebnis vertrauen, denn ein noch laufender Crawl hat einfach weniger zu berichten. Für die Assets, die der Crawler überhaupt nicht erreichen konnte, verwenden Sie post_dataforseo_on_page_uncrawlable_resources. 💰 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.

Body

application/json

Typ: array (object | null)[]
- filters
  Typ: array (object | null)[] | null
  
  Array von Parametern zum Filtern der Ergebnisse
  Optionales Feld
  Sie können mehrere Filter gleichzeitig hinzufügen (maximal 8 Filter)
  Sie sollten zwischen den Bedingungen einen logischen Operator and, or setzen
  Die folgenden Operatoren werden unterstützt:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  Sie können den Operator % mit like und not_like verwenden, um eine beliebige Zeichenfolge mit null oder mehr Zeichen abzugleichen
  Beispiel:
  ["resource_type","=","stylesheet"]
  
  [["resource_type","=","image"], "and",["checks.is_https","=",false]]
  
  [["fetch_timing.duration_time",">",1],"and",[["total_transfer_size",">",100],"or",["checks.high_loading_time","=",true]]]
  
  Die vollständige Liste der möglichen Filter finden Sie unter diesem Link.
  
  Leeres Objekt
- id
  Typ: string
  
  ID der Aufgabe
  Pflichtfeld
  Diese ID erhalten Sie in der Antwort des Endpunkts Task POST
  Beispiel:
  "07131248-1535-0216-1000-17384017ad04"
- limit
  Typ: integer | null
  
  die maximale Anzahl der zurückgegebenen Ressourcen
  Optionales Feld
  Standardwert: 100
  Maximalwert: 1000
- offset
  Typ: integer | null
  
  Offset im Ergebnis-Array der zurückgegebenen Ressourcen
  Optionales Feld
  Standardwert: 0
  Maximalwert: 2000000
  Wenn Sie den Wert 10 angeben, werden die ersten zehn Ressourcen im Ergebnis-Array ausgelassen und die Daten für die nachfolgenden Ressourcen bereitgestellt
- order_by
  Typ: array string[] | null
  
  Sortierregeln für Ergebnisse
  Optionales Feld
  Sie können dieselben Werte wie im filters-Array verwenden, um die Ergebnisse zu sortieren
  Mögliche Sortierarten:
  asc - Ergebnisse werden in aufsteigender Reihenfolge sortiert
  desc - Ergebnisse werden in absteigender Reihenfolge sortiert
  Sie sollten ein Komma verwenden, um eine Sortierart festzulegen
  Beispiel:
  ["size,desc"]
  Beachten Sie, dass Sie in einer einzigen Anfrage höchstens drei Sortierregeln festlegen können
  Sie sollten mehrere Sortierregeln durch ein Komma trennen
  Beispiel:
  ["size,desc","fetch_timing.fetch_end,desc"]
- relevant_pages_filters
  Typ: array string[] | null
  
  Ressourcen nach relevanten Seiten filtern
  Optionales Feld
  Mit diesem Feld können Sie Ressourcen von Seiten abrufen, die den definierten Parametern entsprechen
  Sie können hier dieselben Filter anwenden, die für den Seiten-Endpunkt verfügbar sind
  Sie können mehrere Filter gleichzeitig hinzufügen (maximal 8 Filter)
  Sie sollten zwischen den Bedingungen einen logischen Operator and, or setzen
  Die folgenden Operatoren werden unterstützt:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  Sie können den Operator % mit like und not_like verwenden, um eine beliebige Zeichenfolge mit null oder mehr Zeichen abzugleichen
  Beispiel:
  ["checks.no_image_title","=",true]
- search_after_token
  Typ: string | null
  
  Token für nachfolgende Anfragen
  Optionales Feld
  wird im identischen Feld der Antwort auf jede Anfrage bereitgestellt;
  mit diesem Parameter vermeiden Sie Timeouts beim Abruf von über 20,000 Ergebnissen in einer einzelnen Anfrage;
  mit dem eindeutigen search_after_token-Wert aus dem Antwortarray erhalten Sie die nachfolgenden Ergebnisse der ursprünglichen Aufgabe;
  search_after_token-Werte sind für jede nachfolgende Aufgabe eindeutig;
  Hinweis: Wenn search_after_token in der Anfrage angegeben ist, müssen alle anderen Parameter mit der vorherigen Anfrage identisch sein
- tag
  Typ: string | null
  
  Benutzerdefinierte Aufgaben-ID
  Optionales Feld
  Zeichenlimit: 255
  Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen
  Den angegebenen Wert tag finden Sie im data-Objekt der Antwort
- url
  Typ: string | null
  
  Seiten-URL
  Optionales Feld
  Geben Sie dieses Feld an, wenn Sie die Ressourcen für eine bestimmte Seite abrufen möchten
  Beachten Sie, dass Sie die URL in diesem Feld angeben müssen, um meta einer Ressource von einer bestimmten URL zu erhalten;
  Wenn Sie beim Setzen einer Aufgabe keine url angeben, wird meta der Ressource in den Ergebnissen anhand der Daten der Seite zurückgegeben, auf der unser Crawler die Ressource erstmals gesehen hat

Antworten

200
Typ: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo
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_OnPageResourcesTaskInfo
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_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

current_offset
Typ: integer | null

Integer numbers.

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

Array der Einträge

cache_control
Typ: object | null · Response36Afe1097B20_CacheControl

Anweisungen zum Caching

cachable
Typ: boolean | null

gibt an, ob die Seite cachefähig ist

ttl
Typ: integer | null

Time-to-Live. die Zeitspanne, für die der Browser eine Ressource zwischenspeichert

checks
Typ: object | null

Website-Prüfungen. On-Page-Prüfungen mit Bezug auf die Seite

propertyName
Typ: boolean | null
content_encoding
Typ: string | null

Kodierungstyp

encoded_size
Typ: integer | null

Seitengröße nach der Kodierung. Gibt die Größe der kodierten Seite in Bytes an

fetch_time
Typ: string | null

Datum und Uhrzeit, an dem eine Ressource abgerufen wurde. Im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“. Beispiel: 2019-11-15 12:57:46 +00:00

last_modified
Typ: object | null · Response36Afe1097B20_LastModified

enthält Daten zu Änderungen an der Ressource. Wenn keine Daten vorliegen, ist der Wert null

header
Typ: string | null

Datum und Uhrzeit der letzten Änderung des Headers im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“; Beispiel: 2019-11-15 12:57:46 +00:00; liegen keine Daten vor, ist der Wert null

meta_tag
Typ: string | null

Datum und Uhrzeit der letzten Änderung des Meta-Tags im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“; Beispiel: 2019-11-15 12:57:46 +00:00; liegen keine Daten vor, ist der Wert null

sitemap
Typ: string | null

Datum und Uhrzeit der letzten Änderung der Sitemap im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“; Beispiel: 2019-11-15 12:57:46 +00:00; liegen keine Daten vor, ist der Wert null

location
Typ: string | null

Location-Header. Gibt die URL an, auf die eine Seite weitergeleitet wird

media_type
Typ: string | null

Medientypen, die zur Anzeige einer Seite verwendet werden

resource_errors
Typ: object | null · Response36Afe1097B20_OnPageResourceIssueInfo

Fehler und Warnungen der Ressource

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

Ressourcenfehler

column
Typ: integer | null

Spalte, in der der Fehler gefunden wurde

line
Typ: integer | null

Zeile, in der der Fehler gefunden wurde

message
Typ: string | null

Textmeldung des Fehlers: Die vollständige Liste möglicher HTML-Fehler finden Sie hier

status_code
Typ: integer | null

Allgemeiner Statuscode. Die vollständige Liste der Antwortcodes finden Sie hier. Hinweis: Wir empfehlen dringend, ein System zur Behandlung der zugehörigen Ausnahme- und Fehlerbedingungen zu entwerfen

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

Ressourcenwarnungen

column
Typ: integer | null

Spalte, in der der Fehler gefunden wurde

line
Typ: integer | null

Zeile, in der der Fehler gefunden wurde

message
Typ: string | null

Textmeldung des Fehlers: Die vollständige Liste möglicher HTML-Fehler finden Sie hier

status_code
Typ: integer | null

Allgemeiner Statuscode. Die vollständige Liste der Antwortcodes finden Sie hier. Hinweis: Wir empfehlen dringend, ein System zur Behandlung der zugehörigen Ausnahme- und Fehlerbedingungen zu entwerfen

resource_type
Typ: string | null

Elementtyp

server
Typ: string | null

Serverversion

size
Typ: integer | null

Ressourcengröße. Gibt die Größe einer Seite in Bytes an

status_code
Typ: integer | null

Allgemeiner Statuscode. Die vollständige Liste der Antwortcodes finden Sie hier. Hinweis: Wir empfehlen dringend, ein System zur Behandlung der zugehörigen Ausnahme- und Fehlerbedingungen zu entwerfen

total_transfer_size
Typ: integer | null Format: int64

Komprimierte Seitengröße. Gibt die komprimierte Größe einer Seite an

url
Typ: string | null

Seiten-URL

items_count
Typ: integer | null Format: int64

Anzahl der Einträge im Ergebnis-Array

search_after_token
Typ: string | null
total_items_count
Typ: integer | null Format: int64

Gesamtzahl der gecrawlten relevanten Elemente

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

post/v1/beta/dataforseo/on_page/resources

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/resources \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "id": "07281559-0695-0216-0000-c269be8b7592",
    "filters": [
      [
        "resource_type",
        "=",
        "image"
      ],
      "and",
      [
        "size",
        ">",
        100000
      ]
    ],
    "order_by": [
      "size,desc"
    ],
    "limit": 10
  }
]'

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
          },
          "search_after_token": null,
          "current_offset": null,
          "total_items_count": null,
          "items_count": null,
          "items": [
            {
              "resource_type": null,
              "status_code": null,
              "location": null,
              "url": null,
              "resource_errors": "[Max Depth Exceeded]",
              "size": null,
              "encoded_size": null,
              "total_transfer_size": null,
              "fetch_time": null,
              "cache_control": "[Max Depth Exceeded]",
              "checks": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "last_modified": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

OnPage API: Ressourcen

AuthentifizierungRequired

DataForSEO

OnPage API: Ressourcen

Preisreferenz