Felo API PlatformFelo API Platform
Alle endpoints van DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Lighthouse-taken instellen

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

Lighthouse-taken instellen

​

Zet een Lighthouse-audit in de wachtrij in plaats van erop te wachten, en retourneert een taak-id. Gebruik het wanneer de audit het geduld van een tool-aanroep zou overstijgen; haal op met get_dataforseo_on_page_lighthouse_task_get_json en zie met get_dataforseo_on_page_lighthouse_ready wat klaar is. Verpakt in de DataForSEO-envelop: gegevens in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200. ⚠️ Aan het eind hetzelfde rapport van 245 KB, dus de contextkosten worden uitgesteld, niet vermeden – beperk het hier met categories of audits, niet later.

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)[]
    • audits
      Type: array string[] | null

      Lighthouse-audits
      optioneel veld
      audits zijn afzonderlijke tests die Lighthouse uitvoert voor elke specifieke functie, optimalisatie en metric om een numerieke score te produceren (zie de officiële definitie)als u dit veld negeert, retourneren we gegevens voor alle audits
      gebruik dit veld om gegevens te ontvangen voor specifieke audits die u hier opgeeft

      Let op: sommige audits behoren niet tot een specifieke categorie en zijn zelfstandige metingen van paginakwaliteit

      over het algemeen zijn er verschillende gebruiksscenario's:

      1. als u categories negeert, kunt u dit veld gebruiken om alleen gegevens voor de opgegeven audits te ontvangen
      als u bijvoorbeeld "categories" negeert en "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"] opgeeft, ontvangt u alleen gegevens voor deze audits

      2. als u een categorie opgeeft, kunt u met dit veld bovendien audits ontvangen die niet tot de opgegeven categorie(ën) behoren
      als u bijvoorbeeld "categories": ["seo"] en "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"] opgeeft, ontvangt u alleen deze audits onder „performance” en alle audits onder „seo”

      de volledige lijst met mogelijke audits vindt u hier

    • browser_cpu_throttling_multiplier
      Type: number | null

      vermenigvuldigingsfactor voor CPU-throttling in de browser
      verplicht als browser_network_throttling_method op devtools staat;
      stel de CPU-throttlingfactor in om de prestatieomstandigheden van een apparaat tijdens de Lighthouse-audit te simuleren;
      kan binnen het volgende bereik worden opgegeven: 1–4;
      Let op: deze parameter wordt alleen toegepast als browser_network_throttling_method op devtools staat;

    • browser_network_throttling
      Type: string | null

      netwerkthrottling in de browser
      verplicht als browser_network_throttling_method op devtools staat;
      stel het netwerkthrottlingprofiel in om de verbindingssnelheid tijdens de Lighthouse-audit te simuleren;
      mogelijke waarden: no_throttling, fast_4g, slow_4g, regular_3g, pc;
      Let op: deze parameter wordt alleen toegepast als browser_network_throttling_method op devtools staat;

    • browser_network_throttling_method
      Type: string | null

      methode voor netwerkthrottling in de browser
      optioneel veld
      bepaalt de methode die tijdens de Lighthouse-audit voor throttling wordt gebruikt;
      mogelijke waarden:
      simulate - berekent geschatte prestatiemetrics zonder expliciete throttling;
      devtools - past de throttlinginstellingen toe die in browser_network_throttling en browser_cpu_throttling_multiplier zijn opgegeven;
      provided - gebruikt de netwerkomstandigheden van de crawlomgeving;

    • browser_screen_height
      Type: integer | null

      schermhoogte van de browser
      optioneel veld
      stel de schermhoogte in van de browser die voor de Lighthouse-audit wordt gebruikt om een bepaald apparaat te emuleren;
      kan binnen het volgende bereik worden opgegeven: 240–9999;

    • browser_screen_scale_factor
      Type: number | null

      schaalfactor van het browserscherm
      optioneel veld
      stel de devicepixelratio in van de browser die voor de Lighthouse-audit wordt gebruikt;
      kan binnen het volgende bereik worden opgegeven: 0.5–3;

    • browser_screen_width
      Type: integer | null Formaat: int64

      schermbreedte van de browser
      optioneel veld
      stel de schermbreedte in van de browser die voor de Lighthouse-audit wordt gebruikt om een bepaald apparaat te emuleren;
      kan binnen het volgende bereik worden opgegeven: 240–9999;

    • categories
      Type: array string[] | null

      categorieën van Lighthouse-audits
      optioneel veld
      elke categorie is een verzameling audits en auditgroepen die weging en scoring op het gedeelte toepast (zie de officiële definitie)als u dit veld negeert, retourneren we gegevens voor alle categorieën, tenzij u audits opgeeft
      gebruik dit veld om gegevens te ontvangen voor specifieke categorieën die u hier opgeeft

      mogelijke waarden:
      seo, performance, best_practices, accessibility

    • custom_user_agent
      Type: string | null

      aangepaste user-agent
      optioneel veld
      geef de aangepaste user-agent op die de browser gebruikt bij het uitvoeren van de Lighthouse-audit;
      kan met maximaal 254 tekens worden opgegeven;

    • for_mobile
      Type: boolean | null

      mobiele emulatie toepassen
      optioneel veld
      als dit op true staat, gebruikt Lighthouse emulatie van mobiel apparaat en scherm om de pagina in een mobiele omgeving te testen
      als dit op false staat, worden de resultaten voor desktop geleverd
      standaardwaarde: false

    • language_code
      Type: string | null

      Lighthouse-taalcode
      optioneel veld
      u kunt de lijst met beschikbare talen van de zoekmachine met hun language_code ontvangen via een apart verzoek aan https://api.dataforseo.com/v3/on_page/lighthouse/languages
      standaardwaarde:
      en

    • language_name
      Type: string | null

      Lighthouse-taalnaam
      optioneel veld
      u kunt de lijst met beschikbare talen van de zoekmachine met hun language_name ontvangen via een apart verzoek aan https://api.dataforseo.com/v3/on_page/lighthouse/languages
      standaardwaarde:
      English

    • pingback_url
      Type: string | null

      meldings-URL van een voltooide taak
      optioneel veld
      wanneer een taak is voltooid, melden we u dit via een GET-verzoek naar de URL die u hebt opgegeven
      u kunt de tekenreeks ‘$id’ als $id-variabele en ‘$tag’ als url-gecodeerde $tag-variabele gebruiken. We stellen de benodigde waarden in voordat we het verzoek versturen.
      voorbeeld:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Let op: speciale tekens in pingback_url worden url-gecodeerd;
      d.w.z. het teken # wordt gecodeerd als %23. meer informatie vindt u in ons Help Center

    • tag
      Type: string | null

      door gebruiker gedefinieerde taak-ID
      optioneel veld
      de tekenslimiet is 255
      je kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen
      de opgegeven waarde tag vind je in het data-object van de respons

    • url
      Type: string

      doel-URL
      verplicht veld
      de doelpagina moet met de absolute URL worden opgegeven (inclusief http:// of https://)
      voorbeeld:
      https://dataforseo.com/

    • version
      Type: string | null

      Lighthouse-versie
      optioneel veld
      u kunt de resultaten voor een bepaalde Lighthouse-versie verkrijgen door het versienummer op te geven
      de lijst met beschikbare versies is beschikbaar via het endpoint Lighthouse Versions

Responsen
  • 200
    Type: object | null · Response36Afe1097B20_OnPageLighthouseTaskPostResponseInfo
    • 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_OnPageLighthouseTaskPostTaskInfo
        • 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
          • propertyName
            Type: object | null
        • 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
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
      ]
    }
  ]
}

Geslaagde bewerking

Setting Lighthouse Tasks