version |
string |
the current version of the API |
status_code |
integer |
general status code
you can find the full list of the response codes here
Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions |
status_message |
string |
general informational message
you can find the full list of general informational messages here |
time |
string |
execution time, seconds |
cost |
float |
total tasks cost, USD |
tasks_count |
integer |
the number of tasks in the tasks array |
tasks_error |
integer |
the number of tasks in the tasks array returned with an error |
tasks |
array |
array of tasks |
id |
string |
task identifier
unique task identifier in our system in the UUID format |
status_code |
integer |
status code of the task
generated by DataForSEO; can be within the following range: 10000-60000
you can find the full list of the response codes here |
status_message |
string |
informational message of the task
you can find the full list of general informational messages here |
time |
string |
execution time, seconds |
cost |
float |
cost of the task, USD |
result_count |
integer |
number of elements in the result array |
path |
array |
URL path |
data |
object |
contains the same parameters that you specified in the POST request
|
result |
array |
array of results |
crawl_progress |
string |
status of the crawling session
possible values: in_progress , finished |
crawl_status |
object |
details of the crawling session
in this case the value will be null |
crawl_gateway_address |
string |
crawler ip address
displays the IP address used by the crawler to initiate the current crawling session
you can find the full list of IPs used by our crawler in the Overview section |
total_items_count |
integer |
total number of relevant items in the database |
items_count |
integer |
number of items in the results array |
items |
array |
items array |
‘html’ page |
|
|
resource_type |
string |
type of the returned resource = ‘html’ |
status_code |
integer |
status code of the page |
location |
string |
location header
indicates the URL to redirect a page to |
url |
string |
page URL |
meta |
object |
page properties
the value depends on the resource_type |
title |
string |
page title |
charset |
integer |
code page
example: 65001 |
follow |
boolean |
indicates whether a page’s ‘meta robots’ allows crawlers to follow the links on the page
if false , the page’s ‘meta robots’ tag contains “nofollow” parameter instructing crawlers not to follow the links on the page |
generator |
string |
meta tag generator |
htags |
object |
HTML header tags |
description |
string |
content of the meta description tag |
favicon |
string |
favicon of the page |
meta_keywords |
string |
content of the keywords meta tag |
canonical |
string |
canonical page |
internal_links_count |
integer |
number of internal links on the page |
external_links_count |
integer |
number of external links on the page |
inbound_links_count |
integer |
number of internal links pointing at the page |
images_count |
integer |
number of images on the page |
images_size |
integer |
total size of images on the page measured in bytes |
scripts_count |
integer |
number of scripts on the page |
scripts_size |
integer |
total size of scripts on the page measured in bytes |
stylesheets_count |
integer |
number of stylesheets on the page |
stylesheets_size |
integer |
total size of stylesheets on the page measured in bytes |
title_length |
integer |
length of the title tag in characters |
description_length |
integer |
length of the description tag in characters |
render_blocking_scripts_count |
integer |
number of scripts on the page that block page rendering |
render_blocking_stylesheets_count |
integer |
number of CSS styles on the page that block page rendering |
cumulative_layout_shift |
float |
Core Web Vitals metric measuring the layout stability of the page
measures the sum total of all individual layout shift scores for every unexpected layout shift that occurs during the entire lifespan of the page. Learn more. |
meta_title |
string |
meta title of the page
meta tag in the head section of an HTML document that defines the title of a page |
content |
object |
overall information about content of the page |
plain_text_size |
integer |
total size of the text on the page measured in bytes |
plain_text_rate |
integer |
plaintext rate value
plain_text_size to size ratio |
plain_text_word_count |
float |
number of words on the page |
automated_readability_index |
float |
Automated Readability Index |
coleman_liau_readability_index |
float |
Coleman–Liau Index |
dale_chall_readability_index |
float |
Dale–Chall Readability Index |
flesch_kincaid_readability_index |
float |
Flesch–Kincaid Readability Index |
smog_readability_index |
float |
SMOG Readability Index |
description_to_content_consistency |
float |
consistency of the meta description tag with the page content
measured from 0 to 1 |
title_to_content_consistency |
float |
consistency of the meta title tag with the page content
measured from 0 to 1 |
meta_keywords_to_content_consistency |
float |
consistency of meta keywords tag with the page content
measured from 0 to 1 |
deprecated_tags |
array |
deprecated tags on the page |
duplicate_meta_tags |
array |
duplicate meta tags on the page |
spell |
object |
spellcheck
hunspell spellcheck errors |
hunspell_language_code |
string |
spellcheck language code |
misspelled |
array |
array of misspelled words |
word |
string |
misspelled word |
social_media_tags |
object |
object of social media tags found on the page
contains social media tags and their content
supported tags include but are not limited to Open Graph and Twitter card |
page_timing |
object |
object of page load metrics |
time_to_interactive |
integer |
Time To Interactive (TTI) metric
the time it takes until the user can interact with a page (in milliseconds) |
dom_complete |
integer |
time to load resources
the time it takes until the page and all of its subresources are downloaded (in milliseconds) |
largest_contentful_paint |
float |
Core Web Vitals metric measuring how fast the largest above-the-fold content element is displayed
The amount of time (in milliseconds) to render the largest content element visible in the viewport, from when the user requests the URL. Learn more. |
first_input_delay |
float |
Core Web Vitals metric indicating the responsiveness of a page
The time (in milliseconds) from when a user first interacts with your page to the time when the browser responds to that interaction. Learn more. |
connection_time |
integer |
time to connect to a server
the time it takes until the connection with a server is established (in milliseconds) |
time_to_secure_connection |
integer |
time to establish a secure connection
the time it takes until the secure connection with a server is established (in milliseconds) |
request_sent_time |
integer |
time to send a request to a server
the time it takes until the request to a server is sent (in milliseconds) |
waiting_time |
integer |
time to first byte (TTFB) in milliseconds |
download_time |
integer |
time it takes for a browser to receive a response (in milliseconds) |
duration_time |
integer |
total time it takes until a browser receives a complete response from a server (in milliseconds) |
fetch_start |
integer |
time to start downloading the HTML resource
the amount of time the browser needs to start downloading a page |
fetch_end |
integer |
time to complete downloading the HTML resource
the amount of time the browser needs to complete downloading a page |
onpage_score |
float |
shows how page is optimized on a 100-point scale
this field shows how page is optimized considering critical on-page issues and warnings detected;
100 is the highest possible score that means the page does not have any critical on-page issues and important warnings;
learn more about how the metric is calculated in this help center article |
total_dom_size |
integer |
total DOM size of a page |
custom_js_response |
string/object/integer |
the result of executing a specified JS script
note that you should specify a custom_js field when setting a task to receive this data and the field type and its value will totally depend on the script you specified;you can also filter the results by this value specifying filters in the following way:
["custom_js_response.url", "like", "pixel"] |
custom_js_client_exception |
string |
error when executing a custom js
if the error occurred when executing the script you specified in the custom_js field, the error message would be displayed here |
resource_errors |
object |
resource errors and warnings |
errors |
array |
resource errors |
line |
integer |
line where the error was found |
column |
integer |
column where the error was found |
message |
string |
text message of the error
the full list of possible HTML errors can be found here |
status_code |
integer |
status code of the error
possible values:
0 — Unidentified Error;
501 — Html Parse Error;
1501 — JS Parse Error;
2501 — CSS Parse Error;
3501 — Image Parse Error;
3502 — Image Scale Is Zero;
3503 — Image Size Is Zero;
3504 — Image Format Invalid |
warnings |
array |
resource warnings |
line |
integer |
line the warning relates to
note that if "line": 0 , the warning relates to the whole page |
column |
integer |
column the warning relates to
note that if "column": 0 , the warning relates to the whole page |
message |
string |
text message of the warning
possible messages:
"Has node with more than 60 childs." – HTML page has at least 1 tag nesting over 60 tags of the same level
"Has more that 1500 nodes." – DOM tree contains over 1,500 elements
"HTML depth more than 32 tags." – DOM depth exceeds 32 nodes |
status_code |
integer |
status code of the warning
possible values:
0 — Unidentified Warning;
1 — Has node with more than 60 childs;
2 — Has more that 1500 nodes;
3 — HTML depth more than 32 tags |
broken_resources |
boolean |
indicates whether a page contains broken resources |
broken_links |
boolean |
indicates whether a page contains broken links |
duplicate_title |
boolean |
indicates whether a page has duplicate title tags |
duplicate_description |
boolean |
indicates whether a page has a duplicate description |
duplicate_content |
boolean |
indicates whether a page has duplicate content |
click_depth |
integer |
number of clicks it takes to get to the page
indicates the number of clicks from the homepage needed before landing at the target page |
size |
integer |
resource size
indicates the size of a given page measured in bytes |
encoded_size |
integer |
page size after encoding
indicates the size of the encoded page measured in bytes |
total_transfer_size |
integer |
compressed page size
indicates the compressed size of a given page |
fetch_time |
string |
date and time when a resource was fetched
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 |
cache_control |
object |
instructions for caching |
cachable |
boolean |
indicates whether the page is cacheable |
ttl |
integer |
time to live
the amount of time the browser caches a resource |
checks |
object |
website checks
on-page check-ups related to the page |
no_content_encoding |
boolean |
page with no content encoding
indicates whether a page has no compression algorithm of the content |
high_loading_time |
boolean |
page with high loading time
indicates whether a page loading time exceeds 3 seconds |
is_redirect |
boolean |
page with redirects
indicates whether a page has 3XX redirects to other pages |
is_4xx_code |
boolean |
page with 4xx status codes
indicates whether a page has 4xx response code |
is_5xx_code |
boolean |
page with 5xx status codes
indicates whether a page has 5xx response code |
is_broken |
boolean |
broken page
indicates whether a page returns a response code less than 200 or greater than 400 |
is_www |
boolean |
page with www
indicates whether a page is on a www subdomain |
is_https |
boolean |
page with the https protocol |
is_http |
boolean |
page with the http protocol |
high_waiting_time |
boolean |
page with high waiting time
indicates whether a page waiting time (aka Time to First Byte) exceeds 1.5 seconds |
has_micromarkup |
boolean |
page contains microdata markup</em>
indicates whether a page is without the <!DOCTYPE HTML> declaration |
has_micromarkup_errors |
boolean |
page contains microdata markup errors
indicates whether a page is without the <!DOCTYPE HTML> declaration |
no_doctype |
boolean |
page with no doctype
indicates whether a page is without the <!DOCTYPE HTML> declaration |
has_html_doctype |
boolean |
page with HTML doctype declaration
if true , the page has HTML DOCTYPE declaration |
canonical |
boolean |
page is canonical |
no_encoding_meta_tag |
boolean |
page with no meta tag encoding
indicates whether a page is without Content-Type
informative only if the encoding is not explicit in the Content-Type header
for example: Content-Type: "text/html; charset=utf8" |
no_h1_tag |
boolean |
page with empty or absent h1 tags |
https_to_http_links |
boolean |
HTTPS page has links to HTTP pages
if true , this HTTPS page has links to HTTP pages |
size_greater_than_3mb |
boolean |
page with size larger than 3 MB
if true , the page size is exceeding 3 MB |
meta_charset_consistency |
boolean |
page with meta charset tag
if true , the page has meta charset tag that sets character encoding for this page |
has_meta_refresh_redirect |
boolean |
pages with meta refresh redirect
if true , the page has <meta http-equiv=”refresh”> tag that instructs a browser to load another page after a specified time span |
has_render_blocking_resources |
boolean |
page with render-blocking resources
if true , the page has render-blocking scripts or stylesheets |
low_content_rate |
boolean |
page with low content rate
indicates whether a page has the plaintext size to page size ratio of less than 0.1 |
high_content_rate |
boolean |
page with high content rate
indicates whether a page has the plaintext size to page size ratio of more than 0.9
available for canonical pages only |
low_character_count |
boolean |
indicates whether the page has less than 1024 characters |
high_character_count |
boolean |
indicates whether the page has more than 256,000 characters |
small_page_size |
boolean |
indicates whether a page is too small
the value will be true if a page size is smaller than 1024 bytes |
large_page_size |
boolean |
indicates whether a page is too heavy
the value will be true if a page size exceeds 1 megabyte |
low_readability_rate |
boolean |
page with a low readability rate
indicates whether a page is scored less than 15 points on the Flesch–Kincaid readability test |
irrelevant_description |
boolean |
page with irrelevant description
indicates whether a page description tag is irrelevant to the content of a page
the relevance threshold is 0.2
available for canonical pages only |
irrelevant_title |
boolean |
page with irrelevant title
indicates whether a page title tag is irrelevant to the content of the page
the relevance threshold is 0.3
available for canonical pages only |
irrelevant_meta_keywords |
boolean |
page with irrelevant meta keywords
indicates whether a page keywords tags are irrelevant to the content of a page
the relevance threshold is 0.6
available for canonical pages only |
title_too_long |
boolean |
page with a long title
indicates whether the content of the title tag exceeds 65 characters |
has_meta_title |
boolean |
page has a meta title
indicates whether the HTML of a page contains the meta_title tag |
title_too_short |
boolean |
page with short titles
indicates whether the content of title tag is shorter than 30 characters |
deprecated_html_tags |
boolean |
page with deprecated tags
indicates whether a page has deprecated HTML tags |
duplicate_meta_tags |
boolean |
page with duplicate meta tags
indicates whether a page has more than one meta tag of the same type
available for canonical pages only |
duplicate_title_tag |
boolean |
page with more than one title tag
indicates whether a page has more than one title tag |
no_image_alt |
boolean |
images without alt tags |
no_image_title |
boolean |
images without title tags |
no_description |
boolean |
pages with no description
indicates whether a page has an empty or absent description meta tag
available for canonical pages only |
no_title |
boolean |
page with no title
indicates whether a page has an empty or absent title tag |
no_favicon |
boolean |
page with no favicon |
seo_friendly_url |
boolean |
page with seo-frienldy URL
the ‘SEO-friendliness’ of a page URL is checked by four parameters:
– the length of the relative path is less than 120 characters
– no special characters
– no dynamic parameters
– relevance of the URL to the page
if at least one of them is failed then such URL is considered as not ‘SEO-friendly’
the data is available for canonical pages only |
flash |
boolean |
page with flash
indicates whether a page has flash elements |
frame |
boolean |
page with frames
indicates whether a page contains frame , iframe , frameset tags |
lorem_ipsum |
boolean |
page with lorem ipsum
indicates whether a page has lorem ipsum content |
has_misspelling |
boolean |
page with misspelling
indicates whether a page has spelling mistakes
informative if the check_spell was set to true in the POST array |
seo_friendly_url_characters_check |
boolean |
URL characters check-up
indicates whether a page URL containing only uppercase and lowercase Latin characters, digits and dashes |
seo_friendly_url_dynamic_check |
boolean |
URL dynamic check-up
the value will be true if a page has no dynamic parameters in the url |
seo_friendly_url_keywords_check |
boolean |
URL keyword check-up
indicates whether a page URL is consistent with the title meta tag |
seo_friendly_url_relative_length_check |
boolean |
URL length check-up
the value will be true if a page URL no longer than 120 characters |
content_encoding |
string |
type of encoding |
media_type |
string |
types of media used to display a page |
server |
string |
server version |
is_resource |
boolean |
indicates whether a page is a single resource |
url_length |
integer |
page URL length in characters |
relative_url_length |
integer |
relative URL length in characters |
last_modified |
object |
contains data on changes related to the resource
if there is no data, the value will be null |
header |
string |
date and time when the header was last modified
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
if there is no data, the value will be null |
sitemap |
string |
date and time when the sitemap was last modified
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
if there is no data, the value will be null |
meta_tag |
string |
date and time when the meta tag was last modified
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
if there is no data, the value will be null |
‘broken’ page |
|
|
resource_type |
string |
type of the returned resource = ‘broken’ |
status_code |
integer |
status code of the page |
location |
string |
location header
indicates the URL to redirect a page to |
url |
string |
page URL |
size |
integer |
resource size
indicates the size of a given page measured in bytes |
encoded_size |
integer |
page size after encoding
indicates the size of the encoded page measured in bytes |
total_transfer_size |
integer |
compressed page size
indicates the compressed size of a given page |
fetch_time |
string |
date and time when a resource was fetched
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 |
fetch_timing |
object |
time range within which a result was fetched |
duration_time |
integer |
indicates how many seconds it took to download a page |
fetch_start |
integer |
time to start downloading the HTML resource
the amount of time the browser needs to start downloading a page |
fetch_end |
integer |
time to complete downloading the HTML resource
the amount of time the browser needs to complete downloading a page |
cache_control |
object |
instructions for caching |
cachable |
boolean |
indicates whether the page is cacheable |
ttl |
integer |
time to live
the amount of time the browser caches a resource |
checks |
object |
on-page check-ups |
no_content_encoding |
boolean |
page with no content encoding
indicates whether a page has no compression algorithm of the content |
high_loading_time |
boolean |
page with high loading time
indicates whether a page loading time exceeds 3 seconds |
is_redirect |
boolean |
page with redirects
indicates whether a page has 3XX redirects to other pages |
is_4xx_code |
boolean |
page with with 4xx status code
indicates whether a page has 4XX response code |
is_5xx_code |
boolean |
page with 5xx status code
indicates whether a page has 5XX response code |
is_broken |
boolean |
broken page
indicates whether a page returns a response code less than 200 or greater than 400 |
is_www |
boolean |
page with www
indicates whether a page is on a www subdomain |
is_https |
boolean |
page with the https protocol |
is_http |
boolean |
page with the http protocol |
resource_errors |
object |
resource errors and warnings |
errors |
array |
resource errors |
line |
integer |
line where the error was found |
column |
integer |
column where the error was found |
message |
string |
text message of the error
the full list of possible HTML errors can be found here |
status_code |
integer |
status code of the error
possible values:
0 — Unidentified Error;
501 — Html Parse Error;
1501 — JS Parse Error;
2501 — CSS Parse Error;
3501 — Image Parse Error;
3502 — Image Scale Is Zero;
3503 — Image Size Is Zero;
3504 — Image Format Invalid |
warnings |
array |
resource warnings |
line |
integer |
line the warning relates to
note that if "line": 0 , the warning relates to the whole page |
column |
integer |
columnthe warning relates to
note that if "column": 0 , the warning relates to the whole page |
message |
string |
text message of the warning
possible messages:
"Has node with more than 60 childs." – HTML page has at least 1 tag nesting over 60 tags of the same level
"Has more that 1500 nodes." – DOM tree contains over 1,500 elements
"HTML depth more than 32 tags." – DOM depth exceeds 32 nodes |
status_code |
integer |
status code of the warning
possible values:
0 — Unidentified Warning;
1 — Has node with more than 60 childs;
2 — Has more that 1500 nodes;
3 — HTML depth more than 32 tags |
content_encoding |
string |
type of encoding |
media_type |
string |
types of media used to display a page
example: "text/html" |
server |
string |
server version |
is_resource |
boolean |
indicates whether a page is a single resource |
last_modified |
object |
contains data on changes related to the resource
if there is no data, the value will be null |
header |
string |
date and time when the header was last modified
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
if there is no data, the value will be null |
sitemap |
string |
date and time when the sitemap was last modified
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
if there is no data, the value will be null |
meta_tag |
string |
date and time when the meta tag was last modified
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
if there is no data, the value will be null |
‘redirect’ page |
|
|
resource_type |
string |
type of the returned resource = ‘redirect’ |
status_code |
integer |
status code of the page |
location |
string |
location header
target URL for “redirect” resources |
url |
string |
page url
source URL for “redirect” resources |
size |
integer |
resource size
indicates the size of a given page measured in bytes
equals 0 for “redirect” resources |
encoded_size |
integer |
page size after encoding
equals 0 for “redirect” resources |
total_transfer_size |
integer |
compressed page size
indicates the compressed size of a given page |
fetch_time |
string |
date and time when a resource was fetched
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 |
fetch_timing |
object |
time range within which a result was fetched |
duration_time |
integer |
indicates how many seconds it took to download a page |
fetch_start |
integer |
time to start downloading the HTML resource
the amount of time the browser needs to start downloading a page |
fetch_end |
integer |
time to complete downloading the HTML resource
the amount of time the browser needs to complete downloading a page |
resource_errors |
object |
resource errors and warnings |
errors |
array |
resource errors |
line |
integer |
line where the error was found |
column |
integer |
column where the error was found |
message |
string |
text message of the error
the full list of possible HTML errors can be found here |
status_code |
integer |
status code of the error
possible values:
0 — Unidentified Error;
501 — Html Parse Error;
1501 — JS Parse Error;
2501 — CSS Parse Error;
3501 — Image Parse Error;
3502 — Image Scale Is Zero;
3503 — Image Size Is Zero;
3504 — Image Format Invalid |
warnings |
array |
resource warnings |
line |
integer |
line the warning relates to
note that if "line": 0 , the warning relates to the whole page |
column |
integer |
column the warning relates to
note that if "column": 0 , the warning relates to the whole page |
message |
string |
text message of the warning
possible messages:
"Has node with more than 60 childs." – HTML page has at least 1 tag nesting over 60 tags of the same level
"Has more that 1500 nodes." – DOM tree contains over 1,500 elements
"HTML depth more than 32 tags." – DOM depth exceeds 32 nodes |
status_code |
integer |
status code of the warning
possible values:
0 — Unidentified Warning;
1 — Has node with more than 60 childs;
2 — Has more that 1500 nodes;
3 — HTML depth more than 32 tags |
cache_control |
object |
instructions for caching |
cachable |
boolean |
indicates whether the page is cacheable |
ttl |
integer |
time to live
the amount of time the browser caches a resource |
checks |
object |
on-page check-ups |
no_content_encoding |
boolean |
page with no content encoding
indicates whether a page has no compression algorithm of the content |
high_loading_time |
boolean |
page with high loading time
indicates whether a page loading time exceeds 3 seconds |
is_redirect |
boolean |
page with redirects
indicates whether a page has 3XX redirects to other pages |
is_4xx_code |
boolean |
page with 4xx status codes
indicates whether a page has 4xx response code |
is_5xx_code |
boolean |
page with 5xx status codes
indicates whether a page has 5xx response code |
is_broken |
boolean |
broken page
indicates whether a page returns a response code less than 200 or greater than 400 |
is_www |
boolean |
page with www
indicates whether a page is on a www subdomain |
is_https |
boolean |
page with the https protocol |
is_http |
boolean |
page with the http protocol |
content_encoding |
string |
type of encoding |
media_type |
string |
types of media used to display a page
example: "text/html" |
server |
string |
server version |
is_resource |
boolean |
indicates whether a page is a single resource |
last_modified |
object |
contains data on changes related to the resource
if there is no data, the value will be null |
header |
string |
date and time when the header was last modified
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
if there is no data, the value will be null |
sitemap |
string |
date and time when the sitemap was last modified
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
if there is no data, the value will be null |
meta_tag |
string |
date and time when the meta tag was last modified
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
if there is no data, the value will be null |
resources |
|
Note: the following types of resources will be displayed only if the first URL to crawl is a script, image, or stylesheet |
resource_type |
string |
type of the returned resource
possible types: script , image , stylesheet |
meta |
object |
resource properties
available only for items with the following resource_type : image |
alternative_text |
string |
content of the image alt attribute |
title |
string |
title |
original_width |
integer |
original image width in px |
original_height |
integer |
original image height in px |
width |
integer |
image width in px |
height |
integer |
image height in px |
status_code |
integer |
status code of the page where a given resource is located |
location |
string |
location header
indicates the URL to redirect a page to |
url |
string |
resource URL |
size |
integer |
resource size
indicates the size of a given resource measured in bytes |
encoded_size |
integer |
resource size after encoding
indicates the size of the encoded resource measured in bytes |
total_transfer_size |
integer |
compressed resource size
indicates the compressed size of a given resource in bytes |
fetch_time |
string |
date and time when a resource was fetched
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2021-02-17 13:54:15 +00:00 |
fetch_timing |
object |
resource fetching time range |
duration_time |
integer |
indicates how many milliseconds it took to fetch a resource |
fetch_start |
integer |
time to start downloading the resource
the amount of time a browser needs to start downloading a resource |
fetch_end |
integer |
time to complete downloading the resource
the amount of time a browser needs to complete downloading a resource |
cache_control |
object |
instructions for caching |
cachable |
boolean |
indicates whether the resource is cacheable |
ttl |
integer |
time to live
the amount of time it takes for the browser to cache a resource; measured in milliseconds |
checks |
object |
resource check-ups
contents of the array depend on the resource_type |
no_content_encoding |
boolean |
resource with no content encoding
indicates whether a page has no compression algorithm of the content; |
high_loading_time |
boolean |
resource with high loading time
indicates whether a resource loading time exceeds 3 seconds; |
is_redirect |
boolean |
resource with redirects
indicates whether a page with a resource has 3XX redirects to other pages; |
is_4xx_code |
boolean |
resource with 4xx status codes
indicates whether a resource has 4xx response code |
is_5xx_code |
boolean |
resource with 5xx status codes
indicates whether a resource has 5xx response code |
is_broken |
boolean |
broken resource
indicates whether a page with this resource returns 4xx , 5xx response codes or has broken elements inside the resource |
is_www |
boolean |
page with www
indicates whether a page with this resource is on a www subdomain |
is_https |
boolean |
page with the https protocol |
is_http |
boolean |
page with the http protocol |
is_minified |
boolean |
resource is minified
indicates whether the content of a stylesheet or script is minified;
available for items with the following resource_type : stylesheet , script |
has_redirect |
boolean |
resource has a redirect
available for items with the following resource_type : script , image ;
if the resource_type is image , this field will indicate whether other pages and/or resources have redirects pointing at the image;
if the resource_type is script , this field will indicate whether the script contains a redirect |
has_subrequests |
boolean |
resource contains subrequests
indicates whether the content of a stylesheet or script contain additional requests;
available for items with the following resource_type : stylesheet , script |
original_size_displayed |
boolean |
image desplayes in its original size
indicates whether the image is displayed in its original size;
available only for items with the following resource_type : image |
resource_errors |
object |
resource errors and warnings |
errors |
array |
resource errors |
line |
integer |
line where the error was found |
column |
integer |
column where the error was found |
message |
string |
text message of the error
the full list of possible HTML errors can be found here |
status_code |
integer |
status code of the error
possible values:
0 — Unidentified Error;
501 — Html Parse Error;
1501 — JS Parse Error;
2501 — CSS Parse Error;
3501 — Image Parse Error;
3502 — Image Scale Is Zero;
3503 — Image Size Is Zero;
3504 — Image Format Invalid |
warnings |
array |
resource warnings |
line |
integer |
line the warning relates to
note that if "line": 0 , the warning relates to the whole page |
column |
integer |
column the warning relates to
note that if "column": 0 , the warning relates to the whole page |
message |
string |
text message of the warning
possible messages:
"Has node with more than 60 childs." – HTML page has at least 1 tag nesting over 60 tags of the same level
"Has more that 1500 nodes." – DOM tree contains over 1,500 elements
"HTML depth more than 32 tags." – DOM depth exceeds 32 nodes |
status_code |
integer |
status code of the warning
possible values:
0 — Unidentified Warning;
1 — Has node with more than 60 childs;
2 — Has more that 1500 nodes;
3 — HTML depth more than 32 tags |
content_encoding |
string |
type of encoding |
media_type |
string |
types of media used to display a resource |
accept_type |
string |
indicates the expected type of resource
for example, if "resource_type": "broken" , accept_type will indicate the type of the broken resource
possible values:
any , none , image , sitemap , robots , script , stylesheet , redirect , html , text , other , font |
server |
string |
server version |
last_modified |
object |
contains data on changes related to the resource
if there is no data, the value will be null |
header |
string |
date and time when the header was last modified
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
if there is no data, the value will be null |
sitemap |
string |
date and time when the sitemap was last modified
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
if there is no data, the value will be null |
meta_tag |
string |
date and time when the meta tag was last modified
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
if there is no data, the value will be null |