DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Prostředky OnPage API
Nestránkové prostředky, které procházení našlo — obrázky, skripty, šablony stylů — s jejich stavovými kódy a velikostmi. Stránkování pomocí search_after_token. Načítá dokončené procházení, takže potřebuje id z post_dataforseo_on_page_submit a vrací crawl_progress a crawl_status s hodnotami max_crawl_pages, pages_in_queue a pages_crawled — zkontrolujte je, než budete malému výsledku důvěřovat, protože procházení, které stále běží, má prostě méně co hlásit. Pro prostředky, na které se crawler vůbec nedostal, použijte post_dataforseo_on_page_uncrawlable_resources. 💰 Zdarma na straně upstreamu: dotaz na dokončené procházení nic nestojí, platí se jen samotné procházení.
Cenová reference
- Účtování: nahlášené náklady na odpověď.
- Referenční odhad požadavku: USD 0.012.
- Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.
Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.
- Typ: array (object | null)[]
- filtersTyp: array (object | null)[] | null
pole parametrů pro filtrování výsledků
volitelné pole
můžete přidat několik filtrů najednou (maximálně 8 filtrů)
mezi podmínkami je nutné nastavit logický operátorand,or
podporované operátory:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like
operátor%můžete použít slikeanot_likepro shodu s libovolným řetězcem o nule nebo více znacích
příklad:["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]]]Prázdný objekt - idTyp: string
- limitTyp: integer | null
maximální počet vrácených zdrojů
volitelné pole
výchozí hodnota:100
maximální hodnota:1000 - offsetTyp: integer | null
posun v poli výsledků vracených zdrojů
volitelné pole
výchozí hodnota:0
maximální hodnota:2000000
pokud zadáte hodnotu10, prvních deset zdrojů v poli výsledků bude vynecháno a data budou poskytnuta pro následující zdroje - orderTyp: array string[] | null
_by pravidla řazení výsledků
volitelné pole
k řazení výsledků můžete použít stejné hodnoty jako v polifilters
možné typy řazení:asc- výsledky budou seřazeny vzestupnědesc- výsledky budou seřazeny sestupně
typ řazení nastavte pomocí čárky
příklad:["size,desc"]
pamatujte, že v jednom požadavku můžete nastavit maximálně tři pravidla řazení
jednotlivá pravidla řazení oddělte čárkou
příklad:["size,desc","fetch_timing.fetch_end,desc"] - relevantTyp: array string[] | null
_pages _filters filtrovat zdroje podle příslušných stránek
volitelné pole
toto pole můžete použít k získání zdrojů ze stránek odpovídajících definovaným parametrům
můžete zde použít stejné filtry, jaké jsou dostupné pro endpoint pages
můžete přidat několik filtrů najednou (maximálně 8 filtrů)
mezi podmínkami je nutné nastavit logický operátorand,or
podporované operátory:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like
operátor%můžete použít slikeanot_likepro shodu s libovolným řetězcem o nule nebo více znacích
příklad:["checks.no_image_title","=",true] - searchTyp: string | null
_after _token token pro následné požadavky
volitelné pole
vrací se v identickém poli odpovědi na každý požadavek;
tento parametr použijte, abyste se vyhnuli časovým limitům při pokusu o získání více než20,000výsledků v jednom požadavku;
zadáním jedinečné hodnotysearch_after_tokenz pole odpovědi získáte následné výsledky počáteční úlohy;
hodnotysearch_after_tokenjsou jedinečné pro každou následnou úlohu;
Poznámka: pokud je v požadavku zadánsearch_after_token, všechny ostatní parametry musí být shodné s předchozím požadavkem - tagTyp: string | null
uživatelem definovaný identifikátor úlohy
volitelné pole
limit znaků je 255
tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem
zadanou hodnotutagnajdete v objektudataodpovědi - urlTyp: string | null
URL stránky
volitelné pole
toto pole zadejte, pokud chcete získat zdroje pro konkrétní stránku
pamatujte, že pro získánímetazdroje z konkrétní URL je nutné tuto URL zadat v tomto poli;
pokud při nastavování úlohy neuvedeteurl,metazdroje ve výsledcích bude vráceno na základě dat ze stránky, kde náš crawler zdroj poprvé uviděl
- Typ: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo200
- Typ: number | null Formát: doublecost
celkové náklady na úlohy, USD
- Typ: integer | nullstatus
_code obecný kód stavu úplný seznam kódů odpovědí najdete zde
- Typ: string | nullstatus
_message obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde
- Typ: array (object | null)[] | nulltasks
pole úloh
- Typ: object | null · Response36Afe1097B20_OnPageResourcesTaskInfo
- costTyp: number | null Formát: double
celkové náklady na úlohy, USD
- dataTyp: object | null
obsahuje stejné parametry, které jste zadali v požadavku POST
- propertyTyp: object | null
Name
- idTyp: string | null
identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID
- pathTyp: array (string | null)[] | null
cesta URL
- resultTyp: array (object | null)[] | null
pole výsledků
- crawlTyp: string | null
_progress stav relace procházení
možné hodnoty:in_progress,finished - crawlTyp: object | null · Response36Afe1097B20_CrawlStatusInfo
_status podrobnosti relace procházení
- maxTyp: integer | null Formát: int64
_crawl _pages maximální počet stránek k procházení udává limit max_crawl_pages, který jste zadali při nastavování úlohy
- pagesTyp: integer | null Formát: int64
_crawled počet procházených stránek
- pagesTyp: integer | null Formát: int64
_in _queue počet stránek, které jsou aktuálně ve frontě procházení
- currentTyp: integer | null
_offset Integer numbers.
- itemsTyp: array (object | null)[] | null
pole položek
- cacheTyp: object | null · Response36Afe1097B20_CacheControl
_control pokyny pro ukládání do mezipaměti
- cachableTyp: boolean | null
udává, zda je stránka ukládána do mezipaměti
- ttlTyp: integer | null
doba životnosti — doba, po kterou prohlížeč ukládá prostředek do mezipaměti
- checksTyp: object | null
kontroly webu — kontroly on-page související se stránkou
- propertyTyp: boolean | null
Name
- contentTyp: string | null
_encoding typ kódování
- encodedTyp: integer | null
_size velikost stránky po kódování — udává velikost zakódované stránky v bajtech
- fetchTyp: string | null
_time datum a čas, kdy byl prostředek načten, ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00“; příklad: 2019-11-15 12:57:46 +00:00
- lastTyp: object | null · Response36Afe1097B20_LastModified
_modified obsahuje data o změnách souvisejících s prostředkem; pokud data nejsou k dispozici, bude hodnota null
- headerTyp: string | null
datum a čas poslední úpravy hlavičky. Ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”. Příklad: 2019-11-15 12:57:46 +00:00. Pokud nejsou k dispozici žádná data, hodnota bude null.
- metaTyp: string | null
_tag datum a čas poslední úpravy meta tagu. Ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”. Příklad: 2019-11-15 12:57:46 +00:00. Pokud nejsou k dispozici žádná data, hodnota bude null.
- sitemapTyp: string | null
datum a čas poslední úpravy sitemapy. Ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”. Příklad: 2019-11-15 12:57:46 +00:00. Pokud nejsou k dispozici žádná data, hodnota bude null.
- locationTyp: string | null
hlavička umístění — udává URL, na kterou se má stránka přesměrovat
- mediaTyp: string | null
_type typy médií použitých k zobrazení stránky
- resourceTyp: object | null · Response36Afe1097B20_OnPageResourceIssueInfo
_errors chyby a upozornění prostředku
- errorsTyp: array (object | null)[] | null
chyby zdrojů
- columnTyp: integer | null
sloupec, ve kterém byla chyba nalezena
- lineTyp: integer | null
řádek, ve kterém byla chyba nalezena
- messageTyp: string | null
textová zpráva chyby; úplný seznam možných chyb HTML najdete zde
- statusTyp: integer | null
_code obecný kód stavu. Úplný seznam kódů odpovědí najdete zde. Poznámka: důrazně doporučujeme navrhnout systém pro zpracování souvisejících výjimečných nebo chybových stavů
- warningsTyp: array (object | null)[] | null
varování ke zdrojům
- columnTyp: integer | null
sloupec, ve kterém byla chyba nalezena
- lineTyp: integer | null
řádek, ve kterém byla chyba nalezena
- messageTyp: string | null
textová zpráva chyby; úplný seznam možných chyb HTML najdete zde
- statusTyp: integer | null
_code obecný kód stavu. Úplný seznam kódů odpovědí najdete zde. Poznámka: důrazně doporučujeme navrhnout systém pro zpracování souvisejících výjimečných nebo chybových stavů
- resourceTyp: string | null
_type typ prvku
- serverTyp: string | null
verze serveru
- sizeTyp: integer | null
velikost prostředku — udává velikost dané stránky v bajtech
- statusTyp: integer | null
_code obecný kód stavu. Úplný seznam kódů odpovědí najdete zde. Poznámka: důrazně doporučujeme navrhnout systém pro zpracování souvisejících výjimečných nebo chybových stavů
- totalTyp: integer | null Formát: int64
_transfer _size velikost komprimované stránky — udává komprimovanou velikost dané stránky
- urlTyp: string | null
URL stránky
- itemsTyp: integer | null Formát: int64
_count počet položek v poli výsledků
- searchTyp: string | null
_after _token - totalTyp: integer | null Formát: int64
_items _count celkový počet relevantních položek zjištěných procházením
- resultTyp: integer | null Formát: int64
_count počet prvků v poli result
- statusTyp: integer | null
_code stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde
- statusTyp: string | null
_message informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde
- timeTyp: string | null
doba provedení, sekundy
- Typ: integer | null Formát: int64tasks
_count počet úloh v poli tasks
- Typ: integer | null Formát: int64tasks
_error počet úloh v poli tasks vrácených s chybou
- Typ: string | nulltime
celková doba provádění, sekundy
- Typ: string | nullversion
aktuální verze API
application/json - 400
Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
- 401
Je vyžadován platný API klíč Felo.
- 402
V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
- 403
Účet nemá oprávnění tuto operaci provést.
- 429
Byl dosažen limit požadavků nebo útraty.
- 502
Služba nemohla požadavek dokončit.
- 503
API nebo fakturační služba je dočasně nedostupná.
- 504
Při zpracování požadavku vypršel časový limit služby.
- default
Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele
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]"
}
]
}
]
}
]
}