v0.2.0-beta

OpenAPI 3.1.0

OnPage Lighthouse JSON na żywo

Felo API Support

MIT

Serwer

https://openapi.felo.ai

Biblioteki klienckie

Shell Curl

DataForSEO

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

DataForSEO Operacje

post/v1/beta/dataforseo/on_page/lighthouse/live/json

OnPage Lighthouse JSON na żywo

Uruchamia audyt Google Lighthouse dla jednego url i zwraca pełny raport: lighthouseVersion, requestedUrl, finalUrl, fetchTime, gatherMode, runWarnings oraz ocenę każdego audytu i kategorii. for_mobile przełącza emulowane urządzenie, a categories i audits zawężają przebieg. Przekaż categories lub audits, aby go zmniejszyć; gdy pytanie dotyczy wyłącznie tego, dlaczego strona działa wolno, wybierz post_dataforseo_on_page_waterfall. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200.

Cennik referencyjny

Rozliczanie: zgłoszony koszt odpowiedzi.
Szacunek referencyjny dla żądania: USD 0.005.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść

application/json

Typ: array (object | null)[]
- audits
  Typ: array string[] | null
  
  audyty Lighthouse
  pole opcjonalne
  audyty to pojedyncze testy, które Lighthouse przeprowadza dla każdej funkcji/optymalizacji/metryki, aby uzyskać wynik liczbowy (zobacz oficjalną definicję);
  
  jeśli pominiesz to pole, zwrócimy dane dla wszystkich audytów;
  użyj tego pola, aby uzyskać dane dla konkretnych audytów wskazanych tutaj;
  
  Uwaga: niektóre audyty nie należą do konkretnej kategorii i są samodzielnymi pomiarami jakości strony;
  
  ogólnie można wyróżnić kilka przypadków użycia:
  
  1. jeśli pominiesz categories, możesz użyć tego pola, aby uzyskać dane tylko dla podanych audytów
  na przykład jeśli pominiesz "categories" i podasz "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"], otrzymasz dane tylko dla tych audytów
  
  2. jeśli podasz kategorię, możesz użyć tego pola, aby dodatkowo otrzymać audyty nienależące do wskazanych kategorii
  na przykład jeśli podasz "categories": ["seo"] i "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"], otrzymasz tylko te audyty w kategorii "performance" oraz wszystkie audyty w kategorii "seo"
  
  pełną listę możliwych audytów znajdziesz tutaj
- browser_cpu_throttling_multiplier
  Typ: number | null
  
  mnożnik dławienia CPU przeglądarki
  wymagane, jeśli browser_network_throttling_method ma wartość devtools;
  ustaw mnożnik dławienia CPU, aby symulować warunki wydajności urządzenia podczas audytu Lighthouse;
  można podać w zakresie: 1–4;
  Uwaga: ten parametr jest stosowany tylko wtedy, gdy browser_network_throttling_method ma wartość devtools;
- browser_network_throttling
  Typ: string | null
  
  dławienie sieci przeglądarki
  wymagane, jeśli browser_network_throttling_method ma wartość devtools;
  ustaw profil dławienia sieci, aby symulować warunki prędkości połączenia podczas audytu Lighthouse;
  możliwe wartości: no_throttling, fast_4g, slow_4g, regular_3g, pc;
  Uwaga: ten parametr jest stosowany tylko wtedy, gdy browser_network_throttling_method ma wartość devtools;
- browser_network_throttling_method
  Typ: string | null
  
  metoda dławienia sieci przeglądarki
  pole opcjonalne
  określa metodę stosowaną do dławienia podczas audytu Lighthouse;
  możliwe wartości:
  simulate - oblicza szacowane metryki wydajności bez stosowania jawnego dławienia;
  devtools - stosuje ustawienia dławienia podane w browser_network_throttling i browser_cpu_throttling_multiplier;
  provided - używa warunków sieciowych środowiska przeszukiwania;
- browser_screen_height
  Typ: integer | null
  
  wysokość ekranu przeglądarki
  pole opcjonalne
  ustaw wysokość ekranu przeglądarki używanej do audytu Lighthouse, aby emulować konkretne urządzenie;
  można podać w zakresie: 240–9999;
- browser_screen_scale_factor
  Typ: number | null
  
  współczynnik skali ekranu przeglądarki
  pole opcjonalne
  ustaw stosunek pikseli urządzenia dla przeglądarki używanej do audytu Lighthouse;
  można podać w zakresie: 0.5–3;
- browser_screen_width
  Typ: integer | null Format: int64
  
  szerokość ekranu przeglądarki
  pole opcjonalne
  ustaw szerokość ekranu przeglądarki używanej do audytu Lighthouse, aby emulować konkretne urządzenie;
  można podać w zakresie: 240–9999;
- categories
  Typ: array string[] | null
  
  kategorie audytów Lighthouse
  pole opcjonalne
  każda kategoria to zbiór audytów i grup audytów, do którego stosuje się ważenie i punktację sekcji (zobacz oficjalną definicję)
  
  jeśli pominiesz to pole, zwrócimy dane dla wszystkich kategorii, chyba że podasz audits
  użyj tego pola, aby uzyskać dane dla konkretnych kategorii wskazanych tutaj
  
  możliwe wartości:
  seo, performance, best_practices, accessibility
- custom_user_agent
  Typ: string | null
  
  niestandardowy user agent
  pole opcjonalne
  podaj niestandardowy user agent używany przez przeglądarkę podczas audytu Lighthouse;
  można podać do 254 znaków;
- for_mobile
  Typ: boolean | null
  
  stosuje emulację mobilną
  pole opcjonalne
  jeśli ustawione na true, Lighthouse użyje emulacji urządzenia mobilnego i ekranu do testowania strony w środowisku mobilnym
  jeśli ustawione na false, wyniki zostaną podane dla komputera
  wartość domyślna: false
- language_code
  Typ: string | null
  
  kod języka Lighthouse
  pole opcjonalne
  listę dostępnych języków wyszukiwarki wraz z ich language_code możesz otrzymać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/on_page/lighthouse/languages
  wartość domyślna:
  en
- language_name
  Typ: string | null
  
  nazwa języka Lighthouse
  pole opcjonalne
  listę dostępnych języków wyszukiwarki wraz z ich language_name możesz otrzymać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/on_page/lighthouse/languages
  wartość domyślna:
  English
- tag
  Typ: string | null
  
  identyfikator zadania zdefiniowany przez użytkownika
  pole opcjonalne
  limit znaków: 255
  ten parametr służy do identyfikacji zadania i dopasowania go do wyniku
  podaną wartość tag znajdziesz w obiekcie data odpowiedzi
- url
  Typ: string
  
  docelowy URL
  pole wymagane
  docelową stronę należy podać jako bezwzględny URL (z http:// lub https://)
  przykład:
  https://dataforseo.com/
- version
  Typ: string | null
  
  wersja Lighthouse
  pole opcjonalne
  możesz otrzymać wyniki dla konkretnej wersji Lighthouse, podając jej numer
  lista dostępnych wersji jest dostępna w endpoincie Lighthouse Versions

Odpowiedzi

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

łączny koszt zadań, USD

status_code
Typ: integer | null

ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

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

tablica zadań

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

łączny koszt zadań, USD

data
Typ: object | null

zawiera te same parametry, które podano w żądaniu POST

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

identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID

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

ścieżka URL

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

wyniki audytu Lighthouse
ta tablica będzie zawierać dane zgodnie z parametrami podanymi podczas ustawiania zadania;

wszystkie pola i ich opisy są dostępne w oficjalnej dokumentacji pod tym linkiem.

propertyName
Typ: object | null
result_count
Typ: integer | null Format: int64

liczba elementów w tablicy result

status_code
Typ: integer | null

kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

time
Typ: string | null

czas wykonania, sekundy

tasks_count
Typ: integer | null Format: int64

liczba zadań w tablicy tasks

tasks_error
Typ: integer | null Format: int64

liczba zadań w tablicy tasks zwróconych z błędem

time
Typ: string | null

łączny czas wykonania, sekundy

version
Typ: string | null

bieżąca wersja interfejsu API
application/json
400

Nie można przetworzyć żądania. Sprawdź parametry żądania.
401

Wymagany jest prawidłowy klucz API Felo.
402

Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
403

Konto nie ma uprawnień do wykonania tej operacji.
429

Osiągnięto limit żądań lub wydatków.
502

Usługa nie mogła ukończyć żądania.
503

API lub usługa rozliczeniowa jest tymczasowo niedostępna.
504

Upłynął limit czasu usługi podczas przetwarzania żądania.
default

Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

application/json

post/v1/beta/dataforseo/on_page/lighthouse/live/json

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/lighthouse/live/json \
  --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"
  }
]'

Pokaż schemat

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

Operacja zakończona powodzeniem

OnPage Lighthouse JSON na żywo

UwierzytelnianieRequired

DataForSEO

OnPage Lighthouse JSON na żywo

Cennik referencyjny