DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Zasoby OnPage API
Zasoby inne niż strony, które znalazło przeszukiwanie — obrazy, skrypty, arkusze stylów — wraz z kodami statusu i rozmiarami. Stronicowane przez search_after_token. Odczytuje zakończone przeszukiwanie, więc potrzebuje id z post_dataforseo_on_page_submit i zwraca crawl_progress oraz crawl_status z wartościami max_crawl_pages, pages_in_queue i pages_crawled — sprawdź je, zanim zaufasz małemu wynikowi, bo przeszukiwanie, które wciąż trwa, ma po prostu mniej do zaraportowania. W przypadku zasobów, do których crawler w ogóle nie dotarł, użyj post_dataforseo_on_page_uncrawlable_resources. 💰 Bezpłatne po stronie dostawcy: odczyt zakończonego przeszukiwania nic nie kosztuje — kosztuje tylko samo przeszukiwanie.
Cennik referencyjny
- Rozliczanie: zgłoszony koszt odpowiedzi.
- Szacunek referencyjny dla żądania: USD 0.012.
- 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.
- Typ: array (object | null)[]
- filtersTyp: array (object | null)[] | null
tablica parametrów filtrowania wyników
pole opcjonalne
możesz dodać kilka filtrów jednocześnie (maksymalnie 8 filtrów)
między warunkami należy ustawić operator logicznyand,or
obsługiwane są następujące operatory:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like
operatora%możesz użyć zlikeinot_like, aby dopasować dowolny ciąg znaków o długości zero lub większej
przykład:["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]]]Pełna lista możliwych filtrów jest dostępna pod tym linkiem.
Pusty obiekt - idTyp: string
- limitTyp: integer | null
maksymalna liczba zwracanych zasobów
pole opcjonalne
wartość domyślna:100
wartość maksymalna:1000 - offsetTyp: integer | null
przesunięcie w tablicy wyników zwracanych zasobów
pole opcjonalne
wartość domyślna:0
wartość maksymalna:2000000
jeśli podasz wartość10, pierwszych dziesięć zasobów w tablicy wyników zostanie pominiętych, a dane zostaną zwrócone dla kolejnych zasobów - orderTyp: array string[] | null
_by reguły sortowania wyników
pole opcjonalne
do sortowania wyników możesz użyć tych samych wartości co w tablicyfilters
możliwe typy sortowania:asc- wyniki będą sortowane rosnącodesc- wyniki będą sortowane malejąco
typ sortowania należy ustawić po przecinku
przykład:["size,desc"]
pamiętaj, że w jednym żądaniu możesz ustawić maksymalnie trzy reguły sortowania
poszczególne reguły sortowania należy oddzielić przecinkiem
przykład:["size,desc","fetch_timing.fetch_end,desc"] - relevantTyp: array string[] | null
_pages _filters filtruj zasoby według powiązanych stron
pole opcjonalne
możesz użyć tego pola, aby uzyskać zasoby ze stron pasujących do zdefiniowanych parametrów
możesz zastosować tutaj te same filtry, które są dostępne dla endpointu pages
możesz dodać kilka filtrów jednocześnie (maksymalnie 8 filtrów)
między warunkami należy ustawić operator logicznyand,or
obsługiwane są następujące operatory:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like
operatora%możesz użyć zlikeinot_like, aby dopasować dowolny ciąg znaków o długości zero lub większej
przykład:["checks.no_image_title","=",true] - searchTyp: string | null
_after _token token do kolejnych żądań
pole opcjonalne
jest zwracany w identycznym polu odpowiedzi na każde żądanie;
użyj tego parametru, aby uniknąć przekroczeń czasu przy próbie pobrania ponad20,000wyników w jednym żądaniu;
podając unikalną wartośćsearch_after_tokenz tablicy odpowiedzi, otrzymasz kolejne wyniki początkowego zadania;
wartościsearch_after_tokensą unikalne dla każdego kolejnego zadania;
Uwaga: jeśli w żądaniu podanosearch_after_token, wszystkie pozostałe parametry muszą być identyczne jak w poprzednim żądaniu - tagTyp: 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śćtagznajdziesz w obiekciedataodpowiedzi - urlTyp: string | null
URL strony
pole opcjonalne
podaj to pole, jeśli chcesz uzyskać zasoby dla konkretnej strony
pamiętaj, że aby uzyskaćmetazasobu z konkretnego URL, należy podać ten URL w tym polu;
jeśli nie wskażeszurlpodczas ustawiania zadania,metazasobu w wynikach zostanie zwrócone na podstawie danych ze strony, na której nasz crawler po raz pierwszy zobaczył zasób
- Typ: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo200
- Typ: number | null Format: doublecost
łączny koszt zadań, USD
- Typ: integer | nullstatus
_code ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj
- Typ: string | nullstatus
_message ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj
- Typ: array (object | null)[] | nulltasks
tablica zadań
- Typ: object | null · Response36Afe1097B20_OnPageResourcesTaskInfo
- costTyp: number | null Format: double
łączny koszt zadań, USD
- dataTyp: object | null
zawiera te same parametry, które podano w żądaniu POST
- propertyTyp: object | null
Name
- idTyp: string | null
identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID
- pathTyp: array (string | null)[] | null
ścieżka URL
- resultTyp: array (object | null)[] | null
tablica wyników
- crawlTyp: string | null
_progress status sesji crawlowania
możliwe wartości:in_progress,finished - crawlTyp: object | null · Response36Afe1097B20_CrawlStatusInfo
_status szczegóły sesji crawlowania
- maxTyp: integer | null Format: int64
_crawl _pages maksymalna liczba stron do przeszukania wskazuje limit max_crawl_pages określony podczas ustawiania zadania
- pagesTyp: integer | null Format: int64
_crawled liczba przeszukanych stron
- pagesTyp: integer | null Format: int64
_in _queue liczba stron obecnie znajdujących się w kolejce przeszukiwania
- currentTyp: integer | null
_offset Integer numbers.
- itemsTyp: array (object | null)[] | null
tablica pozycji
- cacheTyp: object | null · Response36Afe1097B20_CacheControl
_control instrukcje dotyczące buforowania
- cachableTyp: boolean | null
wskazuje, czy strona może być buforowana
- ttlTyp: integer | null
czas życia — ilość czasu, przez którą przeglądarka buforuje zasób
- checksTyp: object | null
kontrole witryny — kontrole on-page powiązane ze stroną
- propertyTyp: boolean | null
Name
- contentTyp: string | null
_encoding typ kodowania
- encodedTyp: integer | null
_size rozmiar strony po kodowaniu — wskazuje rozmiar zakodowanej strony w bajtach
- fetchTyp: string | null
_time data i godzina pobrania zasobu w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”; przykład: 2019-11-15 12:57:46 +00:00
- lastTyp: object | null · Response36Afe1097B20_LastModified
_modified zawiera dane o zmianach dotyczących zasobu; jeśli brak danych, wartością będzie null
- headerTyp: string | null
data i godzina ostatniej modyfikacji nagłówka. Format UTC: „yyyy-mm-dd hh-mm-ss +00:00”. Przykład: 2019-11-15 12:57:46 +00:00. Jeśli brak danych, wartością będzie null.
- metaTyp: string | null
_tag data i godzina ostatniej modyfikacji meta tagu. Format UTC: „yyyy-mm-dd hh-mm-ss +00:00”. Przykład: 2019-11-15 12:57:46 +00:00. Jeśli brak danych, wartością będzie null.
- sitemapTyp: string | null
data i godzina ostatniej modyfikacji sitemapy. Format UTC: „yyyy-mm-dd hh-mm-ss +00:00”. Przykład: 2019-11-15 12:57:46 +00:00. Jeśli brak danych, wartością będzie null.
- locationTyp: string | null
nagłówek lokalizacji — wskazuje URL, na który następuje przekierowanie strony
- mediaTyp: string | null
_type typy multimediów używanych do wyświetlania strony
- resourceTyp: object | null · Response36Afe1097B20_OnPageResourceIssueInfo
_errors błędy i ostrzeżenia zasobu
- errorsTyp: array (object | null)[] | null
błędy zasobów
- columnTyp: integer | null
kolumna, w której znaleziono błąd
- lineTyp: integer | null
wiersz, w którym znaleziono błąd
- messageTyp: string | null
komunikat tekstowy błędu; pełną listę możliwych błędów HTML można znaleźć tutaj
- statusTyp: integer | null
_code ogólny kod statusu. Pełną listę kodów odpowiedzi znajdziesz tutaj. Uwaga: zdecydowanie zalecamy zaprojektowanie systemu obsługi powiązanych warunków wyjątkowych lub błędów
- warningsTyp: array (object | null)[] | null
ostrzeżenia dotyczące zasobów
- columnTyp: integer | null
kolumna, w której znaleziono błąd
- lineTyp: integer | null
wiersz, w którym znaleziono błąd
- messageTyp: string | null
komunikat tekstowy błędu; pełną listę możliwych błędów HTML można znaleźć tutaj
- statusTyp: integer | null
_code ogólny kod statusu. Pełną listę kodów odpowiedzi znajdziesz tutaj. Uwaga: zdecydowanie zalecamy zaprojektowanie systemu obsługi powiązanych warunków wyjątkowych lub błędów
- resourceTyp: string | null
_type typ elementu
- serverTyp: string | null
wersja serwera
- sizeTyp: integer | null
rozmiar zasobu — wskazuje rozmiar danej strony w bajtach
- statusTyp: integer | null
_code ogólny kod statusu. Pełną listę kodów odpowiedzi znajdziesz tutaj. Uwaga: zdecydowanie zalecamy zaprojektowanie systemu obsługi powiązanych warunków wyjątkowych lub błędów
- totalTyp: integer | null Format: int64
_transfer _size rozmiar skompresowanej strony — wskazuje skompresowany rozmiar danej strony
- urlTyp: string | null
URL strony
- itemsTyp: integer | null Format: int64
_count liczba pozycji w tablicy wyników
- searchTyp: string | null
_after _token - totalTyp: integer | null Format: int64
_items _count łączna liczba odpowiednich elementów poddanych crawlowaniu
- resultTyp: integer | null Format: int64
_count liczba elementów w tablicy result
- statusTyp: integer | null
_code 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
- statusTyp: string | null
_message komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj
- timeTyp: string | null
czas wykonania, sekundy
- Typ: integer | null Format: int64tasks
_count liczba zadań w tablicy tasks
- Typ: integer | null Format: int64tasks
_error liczba zadań w tablicy tasks zwróconych z błędem
- Typ: string | nulltime
łączny czas wykonania, sekundy
- Typ: string | nullversion
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
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
}
]'
{
"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]"
}
]
}
]
}
]
}