Felo API PlatformFelo API Platform
Alle Endpoints von DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Lighthouse-Aufgaben einstellen

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

Lighthouse-Aufgaben einstellen

​

Stellt ein Lighthouse-Audit in die Warteschlange, statt auf eines zu warten, und gibt eine Aufgaben-id zurück. Verwenden Sie es, wenn das Audit die Geduld eines Tool-Aufrufs übersteigen würde; rufen Sie mit get_dataforseo_on_page_lighthouse_task_get_json ab und sehen Sie mit get_dataforseo_on_page_lighthouse_ready, was bereit ist. 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. ⚠️ Am Ende derselbe 245-KB-Bericht, die Kontextkosten werden also aufgeschoben, nicht vermieden – grenzen Sie ihn hier mit categories oder audits ein, nicht später.

Preisreferenz

  • Abrechnung: Gemeldete Antwortkosten.
  • Referenzschätzung pro Anfrage: USD 0.0051.
  • 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)[]
    • audits
      Typ: array string[] | null

      Lighthouse-Audits
      Optionales Feld
      Audits sind einzelne Tests, die Lighthouse für jedes spezifische Feature, jede Optimierung und jede Metrik ausführt, um eine numerische Bewertung zu erzeugen (siehe offizielle Definition)Wenn Sie dieses Feld ignorieren, geben wir Daten für alle Audits zurück
      Verwenden Sie dieses Feld, um Daten für bestimmte Audits zu erhalten, die Sie hier angeben

      Hinweis: Einige Audits gehören zu keiner bestimmten Kategorie und sind eigenständige Messungen der Seitenqualität

      Im Allgemeinen gibt es mehrere Anwendungsfälle:

      1. Wenn Sie categories ignorieren, können Sie dieses Feld verwenden, um nur Daten für die angegebenen Audits zu erhalten
      Wenn Sie beispielsweise "categories" ignorieren und "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"] angeben, erhalten Sie nur Daten für diese Audits

      2. Wenn Sie eine Kategorie angeben, können Sie mit diesem Feld zusätzlich Audits erhalten, die nicht zu der oder den angegebenen Kategorien gehören
      Wenn Sie beispielsweise "categories": ["seo"] und "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"] angeben, erhalten Sie nur diese Audits unter „performance“ und alle Audits unter „seo“

      Die vollständige Liste der möglichen Audits finden Sie hier

    • browser_cpu_throttling_multiplier
      Typ: number | null

      Multiplikator für CPU-Drosselung im Browser
      Erforderlich, wenn browser_network_throttling_method auf devtools gesetzt ist;
      Legen Sie den CPU-Drosselungsmultiplikator fest, um die Leistungsbedingungen eines Geräts während des Lighthouse-Audits zu simulieren;
      Kann im folgenden Bereich angegeben werden: 1–4;
      Hinweis: Dieser Parameter wird nur angewendet, wenn browser_network_throttling_method auf devtools gesetzt ist;

    • browser_network_throttling
      Typ: string | null

      Netzwerkdrosselung im Browser
      Erforderlich, wenn browser_network_throttling_method auf devtools gesetzt ist;
      Legen Sie das Netzwerkdrosselungsprofil fest, um die Verbindungsgeschwindigkeit während des Lighthouse-Audits zu simulieren;
      Mögliche Werte: no_throttling, fast_4g, slow_4g, regular_3g, pc;
      Hinweis: Dieser Parameter wird nur angewendet, wenn browser_network_throttling_method auf devtools gesetzt ist;

    • browser_network_throttling_method
      Typ: string | null

      Methode für die Netzwerkdrosselung im Browser
      Optionales Feld
      Definiert die Methode, die während des Lighthouse-Audits für die Drosselung verwendet wird;
      Mögliche Werte:
      simulate - berechnet geschätzte Leistungsmetriken ohne explizite Drosselung;
      devtools - wendet die in browser_network_throttling und browser_cpu_throttling_multiplier angegebenen Drosselungseinstellungen an;
      provided - verwendet die Netzwerkbedingungen der Crawling-Umgebung;

    • browser_screen_height
      Typ: integer | null

      Bildschirmhöhe des Browsers
      Optionales Feld
      Legen Sie die Bildschirmhöhe des für das Lighthouse-Audit verwendeten Browsers fest, um ein bestimmtes Gerät zu emulieren;
      Kann im folgenden Bereich angegeben werden: 240–9999;

    • browser_screen_scale_factor
      Typ: number | null

      Skalierungsfaktor des Browserbildschirms
      Optionales Feld
      Legen Sie das Gerätepixelverhältnis des für das Lighthouse-Audit verwendeten Browsers fest;
      Kann im folgenden Bereich angegeben werden: 0.5–3;

    • browser_screen_width
      Typ: integer | null Format: int64

      Bildschirmbreite des Browsers
      Optionales Feld
      Legen Sie die Bildschirmbreite des für das Lighthouse-Audit verwendeten Browsers fest, um ein bestimmtes Gerät zu emulieren;
      Kann im folgenden Bereich angegeben werden: 240–9999;

    • categories
      Typ: array string[] | null

      Kategorien von Lighthouse-Audits
      Optionales Feld
      Jede Kategorie ist eine Sammlung von Audits und Audit-Gruppen, die eine Gewichtung und Bewertung auf den Abschnitt anwendet (siehe offizielle Definition)Wenn Sie dieses Feld ignorieren, geben wir Daten für alle Kategorien zurück, sofern Sie audits nicht angeben
      Verwenden Sie dieses Feld, um Daten für bestimmte Kategorien zu erhalten, die Sie hier angeben

      Mögliche Werte:
      seo, performance, best_practices, accessibility

    • custom_user_agent
      Typ: string | null

      benutzerdefinierter User-Agent
      Optionales Feld
      Geben Sie den benutzerdefinierten User-Agent an, den der Browser beim Ausführen des Lighthouse-Audits verwendet;
      Kann mit bis zu 254 Zeichen angegeben werden;

    • for_mobile
      Typ: boolean | null

      mobile Emulation anwenden
      Optionales Feld
      Bei true verwendet Lighthouse die Emulation von Mobilgerät und Bildschirm, um die Seite in einer mobilen Umgebung zu testen
      Bei false werden die Ergebnisse für Desktop bereitgestellt
      Standardwert: false

    • language_code
      Typ: string | null

      Lighthouse-Sprachcode
      Optionales Feld
      Sie können die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_code durch eine separate Anfrage an https://api.dataforseo.com/v3/on_page/lighthouse/languages erhalten
      Standardwert:
      en

    • language_name
      Typ: string | null

      Lighthouse-Sprachbezeichnung
      Optionales Feld
      Sie können die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_name durch eine separate Anfrage an https://api.dataforseo.com/v3/on_page/lighthouse/languages erhalten
      Standardwert:
      English

    • pingback_url
      Typ: string | null

      Benachrichtigungs-URL für eine abgeschlossene Aufgabe
      Optionales Feld
      Wenn eine Aufgabe abgeschlossen ist, benachrichtigen wir Sie per GET-Anfrage an die von Ihnen angegebene URL
      Sie können die Zeichenfolge ‘$id’ als $id-Variable und ‘$tag’ als urlencodierte $tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage.
      Beispiel:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Hinweis: Sonderzeichen in pingback_url werden urlencodiert;
      d. h. das Zeichen # wird in %23 kodiert. Weitere Informationen finden Sie in unserem Help Center

    • 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

      Ziel-URL
      Pflichtfeld
      Die Zielseite sollte mit ihrer absoluten URL angegeben werden (einschließlich http:// oder https://)
      Beispiel:
      https://dataforseo.com/

    • version
      Typ: string | null

      Lighthouse-Version
      Optionales Feld
      Sie können die Ergebnisse für eine bestimmte Lighthouse-Version abrufen, indem Sie deren Nummer angeben
      Die Liste der verfügbaren Versionen ist über den Endpunkt Lighthouse Versions verfügbar

Antworten
  • 200
    Typ: object | null · Response36Afe1097B20_OnPageLighthouseTaskPostResponseInfo
    • 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_OnPageLighthouseTaskPostTaskInfo
        • 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
          • propertyName
            Typ: object | null
        • 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
Request Example for post/v1/beta/dataforseo/on_page/lighthouse/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/lighthouse/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "url": "https://dataforseo.com",
    "for_mobile": true,
    "tag": "some_string_123",
    "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
  }
]'

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

Erfolgreicher Vorgang

Setting Lighthouse Tasks