| filters available for the resources endpoint: |
|
|
resource_type |
str |
type of the returned resource
possible types: script, image, stylesheet, broken
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": [["resource_type","like","image"],"and",["checks.is_broken","=","true"]] |
meta.alternative_text |
str |
content of the image alt atribute
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": [["meta.alternative_text","=","logo"],"or",["meta.alternative_text","like","%trademark%"]] |
meta.title |
str |
content of title atribute
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": [["meta.title","=","how to cook cake"],"or",["meta.title","like","%cake%"]] |
meta.original_width |
num |
original image width in pixels
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": [["meta.original_width","in", [800,1024]],"and",["meta.original_height","in",[600,768]]] |
meta.original_height |
num |
original image height in pixels
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": [["meta.original_width","<", "320"]],"and",["meta.original_height","<","240"]] |
meta.width |
num |
image width in pixels
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": [["meta.width","in", [800,1024]],"and",["meta.height","in",[600,768]]] |
meta.height |
num |
image height in pixels
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": [["meta.width","<", "320"]],"and",["meta.height","<","240"]] |
status_code |
num |
status code of the page where a given resource is located
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["status_code","<>", "200"] |
location |
num |
status code of the page where a given resource is located
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["status_code","<>", "200"] |
url |
str |
resource URL
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": [url","like","%shop%"] |
size |
num |
resource size
indicates the size of a given resource measured in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["size",">", "47000"] |
encoded_size |
num |
resource size after encoding
indicates the size of the encoded resource measured in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in"filters": ["size",">", "11000"] |
total_transfer_size |
num |
compressed resource size
indicates the compressed size of a given resource in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["size",">", "11000"] |
fetch_time |
time |
date and time when a resource was fetched
in the ISO 8601 format
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["fetch_time",">","2021-01-29 01:24:54"] |
fetch_timing.duration_time |
num |
indicates how many milliseconds it took to fetch a resource
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["fetch_timing.duration_time",">","50"]
|
fetch_timing.fetch_start |
num |
the amount of milliseconds a browser needs to start downloading a resource
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["fetch_timing.fetch_start",">","20"] |
fetch_timing.fetch_end |
num |
the amount of millisends the browser needs to complete downloading a resource
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["fetch_timing.fetch_end",">","50"] |
cache_control.cachable |
bool |
indicates whether the resource is cacheable
the following operators are supported: =, <>
example:
"filters": ["cache_control.cachable","=","false"] |
cache_control.ttl |
num |
time to live
the amount of time it takes for the browser to cache a resource; measured in milliseconds
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["cache_control.ttl",">","5"] |
checks.no_content_encoding |
bool |
resource with no content encoding
indicates whether a page has no compression algorithm of the content
the following operators are supported: =, <>
example:
"filters": ["checks.no_content_encoding","=","true"] |
checks.high_loading_time |
bool |
resource with high loading time
indicates whether a resource loading time exceeds 3 seconds
the following operators are supported: =, <>
example:
"filters": ["checks.high_loading_time","=","true"] |
checks.is_redirect |
bool |
resource with redirects
indicates whether a page with a resource has 3XX redirects to other pages
the following operators are supported: =, <>
example:
"filters": ["checks.is_redirect","=","true"] |
checks.is_4xx_code |
bool |
resource with 4xx status codes
indicates whether a resource has 4xx response code
the following operators are supported: =, <>
example:
"filters": ["checks.is_4xx_code","=","true"] |
checks.is_5xx_code |
bool |
resource with 5xx status codes
indicates whether a resource has 5xx response code
the following operators are supported: =, <>
example:
"filters": ["checks.is_5xx_code","=","true"] |
checks.is_broken |
bool |
broken resource
indicates whether a page with this resource returns a 404 response code
the following operators are supported: =, <>
example:
"filters": ["checks.is_broken","=","false"] |
checks.is_www |
bool |
page with www
indicates whether a page with this resource is on a www subdomain
the following operators are supported: =, <>
example:
"filters": ["checks.is_www","<>","true"] |
checks.is_https |
bool |
page with the https protocol
the following operators are supported: =, <>
example:
"filters": ["checks.is_https","<>","false"] |
checks.is_http |
bool |
page with the http protocol
the following operators are supported: =, <>
example:
"filters": ["checks.is_http","<>","false"] |
checks.is_minified |
bool |
resource is minified
the following operators are supported: =, <>
example:
"filters": ["checks.is_minified","<>","false"] |
checks.has_redirect |
bool |
resource has a redirect
the following operators are supported: =, <>
example:
"filters": ["checks.has_redirect","<>","false"] |
checks.has_subrequests |
bool |
resource contains subrequests
the following operators are supported: =, <>
example:
"filters": ["checks.has_subrequests","<>","false"] |
content_encoding |
str |
type of encoding
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["content_encoding","<>","gzip"] |
media_type |
str |
types of media used to display a resource
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["media_type","like","%javascript"] |
accept_type |
str |
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
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["accept_type","like","script"] |
server |
str |
server version
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["server","not_like","Amazon%"] |
| filters available for the pages endpoint: |
|
|
resource_type |
str |
type of the returned page
possible types: html, broken, redirect
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["resource_type","=","html"] |
meta.title |
str |
page title
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": [["meta.title","like","%updates%"],"or",["meta.title","like","%news%"]] |
meta.charset |
num |
code page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.charset","in","65000,65001"] |
meta.follow |
bool |
indicates whether a page is indexable
the following operators are supported: =, <>
example:
"filters": ["meta.follow","=","true"] |
meta.generator |
str |
meta tag generator
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": [["meta.generator","like","%Powered by%"]],"or",["meta.generator","like","%WordPress%"]] |
meta.description |
str |
content of the description meta tag
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["meta.description","like","%Powered by%"] |
meta.favicon |
str |
image height in pixels
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["meta.favicon","like","%cropped-Favicon_512-32x32.png"] |
meta.meta_keywords |
str |
content of the keywords meta tag
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["meta.meta_keywords","<>","null"] |
meta.canonical |
str |
canonical page
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["meta.canonical","like","https://dataforseo.com/apis%"] |
meta.internal_links_count |
num |
number of internal links on the page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.internal_links_count",">=","10"] |
meta.external_links_count |
num |
number of external links on the page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.external_links_count",">=","5"] |
meta.inbound_links_count |
num |
number of internal links pointing at the page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.inbound_links_count",">=","5"] |
meta.images_count |
num |
number of images on the page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.images_count",">=","1"] |
meta.images_size |
num |
total size of images on the page measured in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.images_size","<=","1000"] |
meta.scripts_count |
num |
number of scripts on the page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.scripts_count",">=","2"] |
meta.scripts_size |
num |
total size of scripts on the page measured in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.scripts_size",">=","1000"] |
meta.stylesheets_count |
num |
number of stylesheets on the page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.stylesheets_count",">=","1"] |
meta.stylesheets_size |
num |
total size of stylesheets on the page measured in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.stylesheets_size",">=","1000"] |
meta.title_length |
num |
length of the title tag in characters
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.title_length",">=","60"] |
meta.description_length |
num |
length of the description tag in characters
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.description_length",">=","120"] |
meta.render_blocking_scripts_count |
num |
number of scripts on the page that block page rendering
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.render_blocking_scripts_count",">=","1"] |
meta.render_blocking_stylesheets_count |
num |
number of CSS styles on the page that block page rendering
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.render_blocking_stylesheets_count",">=","1"] |
meta.cumulative_layout_shift |
num |
Core Web Vitals metric measuring the layout stability of a page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.cumulative_layout_shift",">=","0.25"] |
meta.content.plain_text_size |
num |
total size of the text on the page measured in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.plain_text_size","<=","5000"] |
meta.content.plain_text_rate |
num |
plain text rate value
plain_text_size to size ratio
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.plain_text_rate",">","0.03"] |
meta.content.plain_text_word_count |
num |
number of words on the page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.plain_text_word_count",">=","500"] |
meta.content.automated_readability_index |
num |
Automated Readability Index
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.automated_readability_index","<=","10"] |
meta.content.coleman_liau_readability_index |
num |
Coleman–Liau Index
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.coleman_liau_readability_index","<=","10"] |
meta.content.dale_chall_readability_index |
num |
Dale–Chall Readability Index
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.dale_chall_readability_index","<=","10"] |
meta.content.flesch_kincaid_readability_index |
num |
Flesch–Kincaid Readability Index
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.flesch_kincaid_readability_index","<=","10"] |
meta.content.smog_readability_index |
num |
SMOG Readability Index
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.smog_readability_index","<=","10"] |
meta.content.description_to_content_consistency |
num |
consistency of the meta description tag with the page content
measured from 0 to 1
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.description_to_content_consistency","<=","0.5"] |
meta.content.title_to_content_consistency |
num |
consistency of the meta title tag with the page content
measured from 0 to 1
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.title_to_content_consistency","<=","0.7"] |
meta.content.meta_keywords_to_content_consistency |
num |
consistency of meta keywordstag with the page content
measured from 0 to 1
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.meta_keywords_to_content_consistency","<>","0"] |
meta.spell |
str |
spellcheck
spellcheck errors and suggestions
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["meta.spell","<>","null"] |
meta.duplicate_meta_tags |
array.str |
duplicate meta tags
the following operators are supported: has
example:
"filters": ["meta.duplicate_meta_tags","has","generator"] |
page_timing.time_to_interactive |
num |
Time To Interactive (TTI) metric
the time it takes until the user can interact with a page (in milliseconds)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.time_to_interactive",">=","50"] |
page_timing.dom_complete |
num |
time to load resources
the time it takes until the page and all of its subresources are downloaded (in milliseconds)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.dom_complete",">=","50"] |
page_timing.largest_contentful_paint |
num |
Core Web Vitals metric measuring how fast the largest above-the-fold content element is displayed
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.largest_contentful_paint",">=","2600"] |
page_timing.first_input_delay |
num |
Core Web Vitals metric indicating the responsiveness of a page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.first_input_delay",">=","0.05"] |
page_timing.connection_time |
num |
time to connect to a server
the time it takes until the connection with a server is established (in milliseconds)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.connection_time",">=","50"] |
page_timing.time_to_secure_connection |
num |
time to establish a secure connection
the time it takes until the secure connection with a server is established (in milliseconds)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.time_to_secure_connection",">=","10"] |
page_timing.request_sent_time |
num |
time to send a request to a server
the time it takes until the request to a server is sent (in milliseconds)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.request_sent_time",">=","5"] |
page_timing.waiting_time |
num |
time to first byte (TTFB) in milliseconds
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.waiting_time",">=","50"] |
page_timing.download_time |
num |
time it takes for a browser to receive a response (in milliseconds)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.download_time",">=","20"] |
page_timing.duration_time |
num |
total time it takes until a browser receives a complete response from a server (in milliseconds)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.duration_time",">=","40"] |
page_timing.fetch_start |
num |
time to start downloading the HTML resource
the amount of time the browser needs to start downloading a page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.fetch_start",">=","50"] |
page_timing.fetch_end |
num |
time to complete downloading the HTML resource
the amount of time the browser needs to complete downloading a page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.fetch_end",">=","100"] |
onpage_score |
num |
shows how page is optimized on a 100-point scale
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["onpage_score",">=","50"] |
total_dom_size |
num |
total DOM size of a page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["total_dom_size",">=","200000"] |
broken_resources |
bool |
indicates whether a page contains broken resources
the following operators are supported: =, <>
example:
"filters": ["broken_resources","=","true"] |
broken_links |
bool |
indicates whether a page contains broken links
the following operators are supported: =, <>
example:
"filters": ["broken_links","<>","false"] |
duplicate_title |
bool |
indicates whether a page has duplicate title tags
the following operators are supported: =, <>
example:
"filters": ["broken_links","=","false"] |
duplicate_description |
bool |
indicates whether a page has a duplicate description
the following operators are supported: =, <>
example:
"filters": ["duplicate_description","<>","true"] |
duplicate_content |
bool |
indicates whether a page has duplicate content
the following operators are supported: =, <>
example:
"filters": ["duplicate_content","=","true"] |
status_code |
num |
status code of the page where a given resource is located
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["status_code","<>", "200"] |
location |
num |
status code of the page where a given resource is located
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["status_code","<>", "200"] |
url |
str |
resource URL
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": [url","like","%shop%"] |
click_depth |
num |
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
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["click_depth",">", "4"] |
size |
num |
resource size
indicates the size of a given resource measured in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["size",">", "47000"] |
encoded_size |
num |
resource size after encoding
indicates the size of the encoded resource measured in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["encoded_size",">", "11000"] |
total_transfer_size |
num |
compressed resource size
indicates the compressed size of a given resource in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["total_transfer_size",">", "11000"] |
fetch_time |
time |
date and time when a resource was fetched
in the ISO 8601 format
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["fetch_time",">","2021-01-29 01:24:54"] |
cache_control.cachable |
bool |
indicates whether the resource is cacheable
the following operators are supported: =, <>
example:
"filters": ["cache_control.cachable","=","false"] |
cache_control.ttl |
num |
time to live
the amount of time it takes for the browser to cache a resource; measured in milliseconds
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["cache_control.ttl",">","5"] |
checks.no_content_encoding |
bool |
resource with no content encoding
indicates whether a page has no compression algorithm of the content
the following operators are supported: =, <>
example:
"filters": ["checks.no_content_encoding","=","true"] |
checks.high_loading_time |
bool |
resource with high loading time
indicates whether a resource loading time exceeds 3 seconds
the following operators are supported: =, <>
example:
"filters": ["checks.high_loading_time","=","true"] |
checks.is_redirect |
bool |
resource with redirects
indicates whether a page with a resource has 3XX redirects to other pages
the following operators are supported: =, <>
example:
"filters": ["checks.is_redirect","=","true"] |
checks.is_4xx_code |
bool |
page with 4xx status codes
indicates whether a page has 4xx response code
the following operators are supported: =, <>
example:
"filters": ["checks.is_4xx_code","=","true"] |
checks.is_5xx_code |
bool |
page with 5xx status codes
indicates whether a page has 5xx response code
the following operators are supported: =, <>
example:
"filters": ["checks.is_5xx_code","=","true"] |
checks.is_broken |
bool |
broken resource
indicates whether a page with this resource returns a 404 response code
the following operators are supported: =, <>
example:
"filters": ["checks.is_broken","=","false"] |
checks.is_www |
bool |
page with www
indicates whether a page with this resource is on a www subdomain
the following operators are supported: =, <>
example:
"filters": ["checks.is_www","<>","true"] |
checks.is_https |
bool |
page with the https protocol
the following operators are supported: =, <>
example:
"filters": ["checks.is_https","<>","false"] |
checks.high_waiting_time |
bool |
page with high waiting time
indicates whether a page waiting time (aka Time to First Byte) exceeds 1.5 seconds
the following operators are supported: =, <>
example:
"filters": ["checks.high_waiting_time","=","true"] |
checks.no_doctype |
bool |
page with no doctype
indicates whether a page is without the <!DOCTYPE HTML> declaration
the following operators are supported: =, <>
example:
"filters": ["checks.no_doctype","=","true"] |
checks.canonical |
bool |
page is canonical
the following operators are supported: =, <>
example:
"filters": ["checks.canonical","=","false"] |
checks.no_encoding_meta_tag |
bool |
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
the following operators are supported: =, <>
example:
"filters": ["checks.no_encoding_meta_tag","=","true"] |
checks.no_h1_tags |
bool |
page with empty or absent h1 tags
the following operators are supported: =, <>
example:
"filters": ["checks.no_h1_tags","=","true"] |
checks.https_to_http_links |
bool |
HTTPS page has links to HTTP pages
the following operators are supported: =, <>
example:
"filters": ["checks.https_to_http_links","=","true"] |
checks.has_html_doctype |
bool |
page with HTML doctype declaration
the following operators are supported: =, <>
example:
"filters": ["checks.has_html_doctype","=","false"] |
checks.size_greater_than_3mb |
bool |
page with size larger than 3 MB
the following operators are supported: =, <>
example:
"filters": ["checks.size_greater_than_3mb","=","true"] |
checks.meta_charset_consistency |
bool |
page with meta charset tag
the following operators are supported: =, <>
example:
"filters": ["checks.meta_charset_consistency","=","true"] |
checks.has_meta_refresh_redirect |
bool |
pages with meta refresh redirect
the following operators are supported: =, <>
example:
"filters": ["checks.has_meta_refresh_redirect","=","true"] |
checks.has_render_blocking_resources |
bool |
page with render-blocking resources
if true, the page has render-blocking scripts or stylesheets
the following operators are supported: =, <>
example:
"filters": ["checks.has_render_blocking_resources","=","true"] |
checks.redirect_chain |
bool |
page with multiple redirects
the following operators are supported: =, <>
example:
"filters": ["checks.redirect_chain","=","true"] |
checks.recursive_canonical |
bool |
recursive canonical error
true if the page contains rel="canonical" tag to another page, which in turn, refers back to the initial page
the following operators are supported: =, <>
example:
"filters": ["checks.recursive_canonical","=","true"] |
checks.low_content_rate |
bool |
page with low content rate
indicates whether a page has the plain_text size to page size ratio of less than 0.1
the following operators are supported: =, <>
example:
"filters": ["checks.low_content_rate","=","true"] |
checks.high_content_rate |
bool |
page with high content rate
indicates whether a page has the plain_text size to page size ratio of more than 0.9
available for canonical pages only
the following operators are supported: =, <>
example:
"filters": ["checks.high_content_rate","=","true"] |
checks.low_character_count |
bool |
indicates whether the page has less than 1024 characters
the following operators are supported: =, <>
example:
"filters": ["checks.low_character_count","=","true"] |
checks.high_character_count |
bool |
indicates whether the page has more than 256,000 characters
the following operators are supported: =, <>
example:
"filters": ["checks.high_character_count","=","true"] |
checks.small_page_size |
bool |
indicates whether a page is too small
the value will be true if a page size is smaller than 1024 bytes
the following operators are supported: =, <>
example:
"filters": ["checks.small_page_size","=","true"] |
checks.large_page_size |
bool |
indicates whether a page is too heavy
the value will be true if a page size exceeds 1 megabyte
the following operators are supported: =, <>
example:
"filters": ["checks.large_page_size","=","true"] |
checks.low_readability_rate |
bool |
page with a low readability rate
indicates whether a page is scored less than 15 points on the Flesch–Kincaid readability test
the following operators are supported: =, <>
example:
"filters": ["checks.low_readability_rate","=","true"] |
checks.irrelevant_description |
bool |
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
the following operators are supported: =, <>
example:
"filters": ["checks.irrelevant_description","=","true"] |
checks.irrelevant_title |
bool |
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
the following operators are supported: =, <>
example:
"filters": ["checks.irrelevant_title","=","true"] |
checks.irrelevant_meta_keywords |
bool |
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
the following operators are supported: =, <>
example:
"filters": ["checks.irrelevant_meta_keywords","=","true"] |
checks.title_too_long |
bool |
page with a long title
indicates whether the content of the title tag exceeds 65 characters
the following operators are supported: =, <>
example:
"filters": ["checks.title_too_long","=","true"] |
checks.title_too_short |
bool |
page with short titles
indicates whether the content of title tag is shorter than 30 characters
the following operators are supported: =, <>
example:
"filters": ["checks.title_too_short","=","true"] |
checks.deprecated_html_tags |
bool |
page with deprecated tags
indicates whether a page has deprecated HTML tags
the following operators are supported: =, <>
example:
"filters": ["checks.deprecated_html_tags","=","true"] |
checks.duplicate_meta_tags |
bool |
page with duplicate meta tags
indicates whether a page has more than one meta tag of the same type
available for canonical pages only
the following operators are supported: =, <>
example:
"filters": ["checks.duplicate_meta_tags","=","true"] |
checks.duplicate_title_tag |
bool |
page with more than one title tag
indicates whether a page has more than one title tag
available for canonical pages only
the following operators are supported: =, <>
example:
"filters": ["checks.duplicate_title_tag","=","true"] |
checks.no_image_alt |
bool |
images without alt tags
the following operators are supported: =, <>
example:
"filters": ["checks.no_image_alt","=","true"] |
checks.no_image_title |
bool |
images without title tags
the following operators are supported: =, <>
example:
"filters": ["checks.no_image_title","=","true"] |
checks.no_description |
bool |
pages with no description
indicates whether a page has an empty or absent description meta tag
available for canonical pages only
the following operators are supported: =, <>
example:
"filters": ["checks.no_description","=","true"] |
checks.no_title |
bool |
page with no title
indicates whether a page has an empty or absent title tag
the following operators are supported: =, <>
example:
"filters": ["checks.no_title","=","true"] |
checks.no_favicon |
bool |
page with no favicon
the following operators are supported: =, <>
example:
"filters": ["checks.no_favicon","=","true"] |
checks.seo_friendly_url |
bool |
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 symbols
– 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
the following operators are supported: =, <>
example:
"filters": ["checks.seo_friendly_url","=","true"] |
checks.flash |
bool |
page with flash
indicates whether a page has flash elements
the following operators are supported: =, <>
example:
"filters": ["checks.flash","=","true"] |
checks.frame |
bool |
page with frames
indicates whether a page contains frame, iframe, frameset tags
the following operators are supported: =, <>
example:
"filters": ["checks.frame","=","true"] |
checks.lorem_ipsum |
bool |
page with lorem ipsum
indicates whether a page has lorem ipsum content
the following operators are supported: =, <>
example:
"filters": ["checks.lorem_ipsum","=","true"] |
checks.seo_friendly_url_characters_check |
bool |
URL characters check-up
indicates whether a page URL containing only uppercase and lowercase Latin characters, digits and dashes
the following operators are supported: =, <>
example:
"filters": ["checks.seo_friendly_url_characters_check","=","false"] |
checks.seo_friendly_url_dynamic_check |
bool |
URL dynamic check-up
the value will be true if a page has no dynamic parameters in the URL
the following operators are supported: =, <>
example:
"filters": ["checks.seo_friendly_url_dynamic_check","=","false"] |
checks.seo_friendly_url_keywords_check |
bool |
URL keyword check-up
indicates whether a page URL is consistent with the title meta tag
the following operators are supported: =, <>
example:
"filters": ["checks.seo_friendly_url_keywords_check","=","false"] |
checks.seo_friendly_url_relative_length_check |
bool |
URL length check-up
the value will be true if a page URL no longer than 120 characters
the following operators are supported: =, <>
example:
"filters": ["checks.seo_friendly_url_relative_length_check","=","false"] |
checks.canonical_chain |
bool |
pages with canonical pointing to a page that has a canonical pointing elsewhere
the following operators are supported: =, <>
example:
"filters": ["checks.canonical_chain","=","true"] |
checks.canonical_to_redirect |
bool |
canonical page pointing to a page that redirects elsewhere
the following operators are supported: =, <>
example:
"filters": ["checks.canonical_to_redirect","=","true"] |
checks.canonical_to_broken |
bool |
canonical link pointing to a broken page
the following operators are supported: =, <>
example:
"filters": ["checks.canonical_to_broken","=","true"] |
checks.has_links_to_redirects |
bool |
page is pointing to a page that redirect elsewhere
the following operators are supported: =, <>
example:
"filters": ["checks.has_links_to_redirects","=","true"] |
checks.is_orphan_page |
bool |
page with no internal links pointing to it
the following operators are supported: =, <>
example:
"filters": ["checks.is_orphan_page","=","true"] |
checks.is_link_relation_conflict |
bool |
mix of both followed and nofollowed incoming internal links
true if the page receives at least one link with the rel="nofollow" attribute and at least one dofollow link
the following operators are supported: =, <>
example:
"filters": ["checks.is_link_relation_conflict","=","true"] |
content_encoding |
str |
type of encoding
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["content_encoding","<>","gzip"] |
media_type |
str |
types of media used to display a resource
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["media_type","like","%text%"] |
server |
str |
server version
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["server","not_like","Amazon%"] |
is_resource |
bool |
whether a page is a resource
the following operators are supported: =, <>
example:
"filters": ["is_resource","=","false"] |
url_length |
num |
page URL length in characters
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["url_length",">","10"] |
relative_url_length |
num |
relative URL length in characters
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["relative_url_length",">","4"] |
| filters available for the non_indexable endpoint: |
|
|
reason |
str |
the reason why the page is non-indexable
can take the following values: robots_txt, meta_tag, http_header, attribute, too_many_redirects
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["reason","=","robots_txt"] |
url |
str |
url of the non-indexable page
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["url","like","%blog%"] |
| filters available for the links endpoint: |
|
|
type |
str |
type of a link
can take the following values: anchor, image, link, canonical, meta, alternate
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":[["type","=","anchor"],"or",["type","=","link"]] |
domain_from |
str |
referring domain
the link was found on this domain
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["domain_from","like","%dataforseo.com%"] |
domain_to |
str |
referenced domain
the link is pointing to this domain
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["domain_to","like","%dataforseo.com%"] |
page_from |
str |
referring page
relative URL of the page on which the link was found
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["page_from","like","dataforseo.com/blog%"] |
page_to |
str |
referenced page
relative URL of the page to which the link is pointing
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["page_to","like","app.dataforseo.com%"] |
link_from |
str |
referring page
absolute URL of the page on which the link was found
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["link_from","like","%dataforseo.com/blog%"] |
link_to |
str |
referenced page
absolute URL of the page to which the link is pointing
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["link_to","like","%app.dataforseo.com%"] |
link_attribute |
array |
link attribute added to external link
absolute URL of the page to which the link is pointing
indicates link attributes added to the link_to on the page_from
the following operators are supported: has
example:
"filters":["link_attribute","has","ugc"] |
dofollow |
bool |
indicates whether the link is dofollow
if the value is true, the link doesn’t have a rel="nofollow" attribute
the following operators are supported: =, <>
example:
"filters": ["dofollow","=","true"] |
page_from_scheme |
str |
url scheme of the referring page
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["page_from_scheme","=","https"] |
page_to_scheme |
str |
url scheme of the referenced page
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["page_to_scheme","=","nntp"] |
direction |
str |
direction of the link
possible values: internal, external
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["direction","=","internal"] |
page_to_status_code |
num |
status code of the referenced page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters":["page_to_status_code","=", "200"] |
| filters available for the pages by resource endpoint: |
|
|
resource_type |
str |
type of the returned page
possible types: html, broken
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["resource_type","=","html"] |
meta.title |
str |
page title
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": [["meta.title","like","%updates%"],"or",["meta.title","like","%news%"]] |
meta.charset |
num |
code page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.charset","in","65000,65001"] |
meta.follow |
bool |
indicates whether a page is indexable
the following operators are supported: =, <>
example:
"filters": ["meta.follow","=","true"] |
meta.generator |
str |
meta tag generator
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": [["meta.generator","like","%Powered by%"]],"or",["meta.generator","like","%WordPress%"]] |
meta.description |
str |
content of the description meta tag
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["meta.description","like","%Powered by%"] |
meta.favicon |
str |
image height in pixels
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["meta.favicon","like","%cropped-Favicon_512-32x32.png"] |
meta.meta_keywords |
str |
content of the keywords meta tag
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["meta.meta_keywords","<>","null"] |
meta.canonical |
str |
canonical page
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["meta.canonical","like","https://dataforseo.com/apis%"] |
meta.internal_links_count |
num |
number of internal links on the page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.internal_links_count",">=","10"] |
meta.external_links_count |
num |
number of external links on the page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.external_links_count",">=","5"] |
meta.inbound_links_count |
num |
number of internal links pointing at the page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.inbound_links_count",">=","5"] |
meta.images_count |
num |
number of images on the page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.images_count",">=","1"] |
meta.images_size |
num |
total size of images on the page measured in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.images_size","<=","1000"] |
meta.scripts_count |
num |
number of scripts on the page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.scripts_count",">=","2"] |
meta.scripts_size |
num |
total size of scripts on the page measured in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.scripts_size",">=","1000"] |
meta.stylesheets_count |
num |
number of stylesheets on the page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.stylesheets_count",">=","1"] |
meta.stylesheets_size |
num |
total size of stylesheets on the page measured in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.stylesheets_size",">=","1000"] |
meta.title_length |
num |
length of the title tag in characters
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.title_length",">=","60"] |
meta.description_length |
num |
length of the description tag in characters
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.description_length",">=","120"] |
meta.render_blocking_scripts_count |
num |
number of scripts on the page that block page rendering
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.render_blocking_scripts_count",">=","1"] |
meta.render_blocking_stylesheets_count |
num |
number of CSS styles on the page that block page rendering
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.render_blocking_stylesheets_count",">=","1"] |
meta.cumulative_layout_shift |
num |
Core Web Vitals metric measuring the layout stability of a page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.cumulative_layout_shift",">=","0.25"] |
meta.content.plain_text_size |
num |
total size of the text on the page measured in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.plain_text_size","<=","5000"] |
meta.content.plain_text_rate |
num |
plain text rate value
plain_text_size to size ratio
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.plain_text_rate",">","0.03"] |
meta.content.plain_text_word_count |
num |
number of words on the page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.plain_text_word_count",">=","500"] |
meta.content.automated_readability_index |
num |
Automated Readability Index
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.automated_readability_index","<=","10"] |
meta.content.coleman_liau_readability_index |
num |
Coleman–Liau Index
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.coleman_liau_readability_index","<=","10"] |
meta.content.dale_chall_readability_index |
num |
Dale–Chall Readability Index
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.dale_chall_readability_index","<=","10"] |
meta.content.flesch_kincaid_readability_index |
num |
Flesch–Kincaid Readability Index
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.flesch_kincaid_readability_index","<=","10"] |
meta.content.smog_readability_index |
num |
SMOG Readability Index
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.smog_readability_index","<=","10"] |
meta.content.description_to_content_consistency |
num |
consistency of the meta description tag with the page content
measured from 0 to 1
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.description_to_content_consistency","<=","0.5"] |
meta.content.title_to_content_consistency |
num |
consistency of the meta title tag with the page content
measured from 0 to 1
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.title_to_content_consistency","<=","0.7"] |
meta.content.meta_keywords_to_content_consistency |
num |
consistency of meta keywordstag with the page content
measured from 0 to 1
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["meta.content.meta_keywords_to_content_consistency","<>","0"] |
meta.spell |
str |
spellcheck
spellcheck errors and suggestions
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["meta.spell","<>","null"] |
meta.duplicate_meta_tags |
array.str |
duplicate meta tags
the following operators are supported: has
example:
"filters": ["meta.duplicate_meta_tags","has","generator"] |
page_timing.time_to_interactive |
num |
Time To Interactive (TTI) metric
the time it takes until the user can interact with a page (in milliseconds)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.time_to_interactive",">=","50"] |
page_timing.dom_complete |
num |
time to load resources
the time it takes until the page and all of its subresources are downloaded (in milliseconds)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.dom_complete",">=","50"] |
page_timing.largest_contentful_paint |
num |
Core Web Vitals metric measuring how fast the largest above-the-fold content element is displayed
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.largest_contentful_paint",">=","2600"] |
page_timing.first_input_delay |
num |
Core Web Vitals metric indicating the responsiveness of a page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.first_input_delay",">=","0.05"] |
page_timing.connection_time |
num |
time to connect to a server
the time it takes until the connection with a server is established (in milliseconds)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.connection_time",">=","50"] |
page_timing.time_to_secure_connection |
num |
time to establish a secure connection
the time it takes until the secure connection with a server is established (in milliseconds)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.time_to_secure_connection",">=","10"] |
page_timing.request_sent_time |
num |
time to send a request to a server
the time it takes until the request to a server is sent (in milliseconds)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.request_sent_time",">=","5"] |
page_timing.waiting_time |
num |
time to first byte (TTFB) in milliseconds
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.waiting_time",">=","50"] |
page_timing.download_time |
num |
time it takes for a browser to receive a response (in milliseconds)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.download_time",">=","20"] |
page_timing.duration_time |
num |
total time it takes until a browser receives a complete response from a server (in milliseconds)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.duration_time",">=","40"] |
page_timing.fetch_start |
num |
time to start downloading the HTML resource
the amount of time the browser needs to start downloading a page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.fetch_start",">=","50"] |
page_timing.fetch_end |
num |
time to complete downloading the HTML resource
the amount of time the browser needs to complete downloading a page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["page_timing.fetch_end",">=","100"] |
onpage_score |
num |
shows how page is optimized on a 100-point scale
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["onpage_score",">=","50"] |
total_dom_size |
num |
total DOM size of a page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["total_dom_size",">=","200000"] |
broken_resources |
bool |
indicates whether a page contains broken resources
the following operators are supported: =, <>
example:
"filters": ["broken_resources","=","true"] |
broken_links |
bool |
indicates whether a page contains broken links
the following operators are supported: =, <>
example:
"filters": ["broken_links","<>","false"] |
duplicate_title |
bool |
indicates whether a page has duplicate title tags
the following operators are supported: =, <>
example:
"filters": ["broken_links","=","false"] |
duplicate_description |
bool |
indicates whether a page has a duplicate description
the following operators are supported: =, <>
example:
"filters": ["duplicate_description","<>","true"] |
duplicate_content |
bool |
indicates whether a page has duplicate content
the following operators are supported: =, <>
example:
"filters": ["duplicate_content","=","true"] |
status_code |
num |
status code of the page where a given resource is located
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["status_code","<>", "200"] |
location |
num |
status code of the page where a given resource is located
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["status_code","<>", "200"] |
url |
str |
resource URL
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": [url","like","%shop%"] |
size |
num |
resource size
indicates the size of a given resource measured in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["size",">", "47000"] |
encoded_size |
num |
resource size after encoding
indicates the size of the encoded resource measured in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["encoded_size",">", "11000"] |
total_transfer_size |
num |
compressed resource size
indicates the compressed size of a given resource in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["total_transfer_size",">", "11000"] |
fetch_time |
time |
date and time when a resource was fetched
in the ISO 8601 format
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["fetch_time",">","2021-01-29 01:24:54"] |
cache_control.cachable |
bool |
indicates whether the resource is cacheable
the following operators are supported: =, <>
example:
"filters": ["cache_control.cachable","=","false"] |
cache_control.ttl |
num |
time to live
the amount of time it takes for the browser to cache a resource; measured in milliseconds
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["cache_control.ttl",">","5"] |
checks.no_content_encoding |
bool |
resource with no content encoding
indicates whether a page has no compression algorithm of the content
the following operators are supported: =, <>
example:
"filters": ["checks.no_content_encoding","=","true"] |
checks.high_loading_time |
bool |
resource with high loading time
indicates whether a resource loading time exceeds 3 seconds
the following operators are supported: =, <>
example:
"filters": ["checks.high_loading_time","=","true"] |
checks.is_redirect |
bool |
resource with redirects
indicates whether a page with a resource has 3XX redirects to other pages
the following operators are supported: =, <>
example:
"filters": ["checks.is_redirect","=","true"] |
checks.is_4xx_code |
bool |
page with 4xx status codes
indicates whether a page has 4xx response code
the following operators are supported: =, <>
example:
"filters": ["checks.is_4xx_code","=","true"] |
checks.is_5xx_code |
bool |
page with 5xx status codes
indicates whether a page has 5xx response code
the following operators are supported: =, <>
example:
"filters": ["checks.is_5xx_code","=","true"] |
checks.is_broken |
bool |
broken resource
indicates whether a page with this resource returns a 404 response code
the following operators are supported: =, <>
example:
"filters": ["checks.is_broken","=","false"] |
checks.is_www |
bool |
page with www
indicates whether a page with this resource is on a www subdomain
the following operators are supported: =, <>
example:
"filters": ["checks.is_www","<>","true"] |
checks.is_https |
bool |
page with the https protocol
the following operators are supported: =, <>
example:
"filters": ["checks.is_https","<>","false"] |
checks.high_waiting_time |
bool |
page with high waiting time
indicates whether a page waiting time (aka Time to First Byte) exceeds 1.5 seconds
the following operators are supported: =, <>
example:
"filters": ["checks.high_waiting_time","=","true"] |
checks.no_doctype |
bool |
page with no doctype
indicates whether a page is without the <!DOCTYPE HTML> declaration
the following operators are supported: =, <>
example:
"filters": ["checks.no_doctype","=","true"] |
checks.canonical |
bool |
page is canonical
the following operators are supported: =, <>
example:
"filters": ["checks.canonical","=","false"] |
checks.no_encoding_meta_tag |
bool |
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
the following operators are supported: =, <>
example:
"filters": ["checks.no_encoding_meta_tag","=","true"] |
checks.no_h1_tags |
bool |
page with empty or absent h1 tags
the following operators are supported: =, <>
example:
"filters": ["checks.no_h1_tags","=","true"] |
checks.https_to_http_links |
bool |
HTTPS page has links to HTTP pages
the following operators are supported: =, <>
example:
"filters": ["checks.https_to_http_links","=","true"] |
checks.has_html_doctype |
bool |
page with HTML doctype declaration
the following operators are supported: =, <>
example:
"filters": ["checks.has_html_doctype","=","false"] |
checks.size_greater_than_3mb |
bool |
page with size larger than 3 MB
the following operators are supported: =, <>
example:
"filters": ["checks.size_greater_than_3mb","=","true"] |
checks.meta_charset_consistency |
bool |
page with meta charset tag
the following operators are supported: =, <>
example:
"filters": ["checks.meta_charset_consistency","=","true"] |
checks.has_meta_refresh_redirect |
bool |
pages with meta refresh redirect
the following operators are supported: =, <>
example:
"filters": ["checks.has_meta_refresh_redirect","=","true"] |
checks.has_render_blocking_resources |
bool |
page with render-blocking resources
if true, the page has render-blocking scripts or stylesheets
the following operators are supported: =, <>
example:
"filters": ["checks.has_render_blocking_resources","=","true"] |
checks.redirect_chain |
bool |
page with multiple redirects
the following operators are supported: =, <>
example:
"filters": ["checks.redirect_chain","=","true"] |
checks.recursive_canonical |
bool |
recursive canonical error
true if the page contains rel="canonical" tag to another page, which in turn, refers back to the initial page
the following operators are supported: =, <>
example:
"filters": ["checks.recursive_canonical","=","true"] |
checks.low_content_rate |
bool |
page with low content rate
indicates whether a page has the plain_text size to page size ratio of less than 0.1
the following operators are supported: =, <>
example:
"filters": ["checks.low_content_rate","=","true"] |
checks.high_content_rate |
bool |
page with high content rate
indicates whether a page has the plain_text size to page size ratio of more than 0.9
available for canonical pages only
the following operators are supported: =, <>
example:
"filters": ["checks.high_content_rate","=","true"] |
checks.low_character_count |
bool |
indicates whether the page has less than 1024 characters
the following operators are supported: =, <>
example:
"filters": ["checks.low_character_count","=","true"] |
checks.high_character_count |
bool |
indicates whether the page has more than 256,000 characters
the following operators are supported: =, <>
example:
"filters": ["checks.high_character_count","=","true"] |
checks.small_page_size |
bool |
indicates whether a page is too small
the value will be true if a page size is smaller than 1024 bytes
the following operators are supported: =, <>
example:
"filters": ["checks.small_page_size","=","true"] |
checks.large_page_size |
bool |
indicates whether a page is too heavy
the value will be true if a page size exceeds 1 megabyte
the following operators are supported: =, <>
example:
"filters": ["checks.large_page_size","=","true"] |
checks.low_readability_rate |
bool |
page with a low readability rate
indicates whether a page is scored less than 15 points on the Flesch–Kincaid readability test
the following operators are supported: =, <>
example:
"filters": ["checks.low_readability_rate","=","true"] |
checks.irrelevant_description |
bool |
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
the following operators are supported: =, <>
example:
"filters": ["checks.irrelevant_description","=","true"] |
checks.irrelevant_title |
bool |
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
the following operators are supported: =, <>
example:
"filters": ["checks.irrelevant_title","=","true"] |
checks.irrelevant_meta_keywords |
bool |
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
the following operators are supported: =, <>
example:
"filters": ["checks.irrelevant_meta_keywords","=","true"] |
checks.title_too_long |
bool |
page with a long title
indicates whether the content of the title tag exceeds 65 characters
the following operators are supported: =, <>
example:
"filters": ["checks.title_too_long","=","true"] |
checks.title_too_short |
bool |
page with short titles
indicates whether the content of title tag is shorter than 30 characters
the following operators are supported: =, <>
example:
"filters": ["checks.title_too_short","=","true"] |
checks.deprecated_html_tags |
bool |
page with deprecated tags
indicates whether a page has deprecated HTML tags
the following operators are supported: =, <>
example:
"filters": ["checks.deprecated_html_tags","=","true"] |
checks.duplicate_meta_tags |
bool |
page with duplicate meta tags
indicates whether a page has more than one meta tag of the same type
available for canonical pages only
the following operators are supported: =, <>
example:
"filters": ["checks.duplicate_meta_tags","=","true"] |
checks.duplicate_title_tag |
bool |
page with more than one title tag
indicates whether a page has more than one title tag
available for canonical pages only
the following operators are supported: =, <>
example:
"filters": ["checks.duplicate_title_tag","=","true"] |
checks.no_image_alt |
bool |
images without alt tags
the following operators are supported: =, <>
example:
"filters": ["checks.no_image_alt","=","true"] |
checks.no_image_title |
bool |
images without title tags
the following operators are supported: =, <>
example:
"filters": ["checks.no_image_title","=","true"] |
checks.no_description |
bool |
pages with no description
indicates whether a page has an empty or absent description meta tag
available for canonical pages only
the following operators are supported: =, <>
example:
"filters": ["checks.no_description","=","true"] |
checks.no_title |
bool |
page with no title
indicates whether a page has an empty or absent title tag
the following operators are supported: =, <>
example:
"filters": ["checks.no_title","=","true"] |
checks.no_favicon |
bool |
page with no favicon
the following operators are supported: =, <>
example:
"filters": ["checks.no_favicon","=","true"] |
checks.seo_friendly_url |
bool |
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 symbols
– 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
the following operators are supported: =, <>
example:
"filters": ["checks.seo_friendly_url","=","true"] |
checks.flash |
bool |
page with flash
indicates whether a page has flash elements
the following operators are supported: =, <>
example:
"filters": ["checks.flash","=","true"] |
checks.frame |
bool |
page with frames
indicates whether a page contains frame, iframe, frameset tags
the following operators are supported: =, <>
example:
"filters": ["checks.frame","=","true"] |
checks.lorem_ipsum |
bool |
page with lorem ipsum
indicates whether a page has lorem ipsum content
the following operators are supported: =, <>
example:
"filters": ["checks.lorem_ipsum","=","true"] |
checks.seo_friendly_url_characters_check |
bool |
URL characters check-up
indicates whether a page URL containing only uppercase and lowercase Latin characters, digits and dashes
the following operators are supported: =, <>
example:
"filters": ["checks.seo_friendly_url_characters_check","=","false"] |
checks.seo_friendly_url_dynamic_check |
bool |
URL dynamic check-up
the value will be true if a page has no dynamic parameters in the URL
the following operators are supported: =, <>
example:
"filters": ["checks.seo_friendly_url_dynamic_check","=","false"] |
checks.seo_friendly_url_keywords_check |
bool |
URL keyword check-up
indicates whether a page URL is consistent with the title meta tag
the following operators are supported: =, <>
example:
"filters": ["checks.seo_friendly_url_keywords_check","=","false"] |
checks.seo_friendly_url_relative_length_check |
bool |
URL length check-up
the value will be true if a page URL no longer than 120 characters
the following operators are supported: =, <>
example:
"filters": ["checks.seo_friendly_url_relative_length_check","=","false"] |
checks.canonical_chain |
bool |
pages with canonical pointing to a page that has a canonical pointing elsewhere
the following operators are supported: =, <>
example:
"filters": ["checks.canonical_chain","=","true"] |
checks.canonical_to_redirect |
bool |
canonical page pointing to a page that redirects elsewhere
the following operators are supported: =, <>
example:
"filters": ["checks.canonical_to_redirect","=","true"] |
checks.canonical_to_broken |
bool |
canonical link pointing to a broken page
the following operators are supported: =, <>
example:
"filters": ["checks.canonical_to_broken","=","true"] |
checks.has_links_to_redirects |
bool |
page is pointing to a page that redirect elsewhere
the following operators are supported: =, <>
example:
"filters": ["checks.has_links_to_redirects","=","true"] |
checks.is_orphan_page |
bool |
page with no internal links pointing to it
the following operators are supported: =, <>
example:
"filters": ["checks.is_orphan_page","=","true"] |
checks.is_link_relation_conflict |
bool |
mix of both followed and nofollowed incoming internal links
true if the page receives at least one link with the rel="nofollow" attribute and at least one dofollow link
the following operators are supported: =, <>
example:
"filters": ["checks.is_link_relation_conflict","=","true"] |
content_encoding |
str |
type of encoding
the following operators are supported: regex, =, <>, like, not_like
example:
"filters": ["content_encoding","<>","gzip"] |
media_type |
str |
types of media used to display a resource
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["media_type","like","%text%"] |
server |
str |
server version
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["server","not_like","Amazon%"] |
server |
str |
server version
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["server","not_like","Amazon%"] |
is_resource |
bool |
whether a page is a resource
the following operators are supported: =, <>
example:
"filters": ["is_resource","=","false"] |
| filters available for the keyword density endpoint: |
|
|
keyword |
str |
keyword found on the website of web page
the following operators are supported: regex, =, <>, like, not_like
example:
"filters":["keyword","not_like","seo%"] |
frequency |
num |
keyword frequency
number of times the keyword appears on the website (or webpage if you specified a url when setting a task to the keyword density endpoint)
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["frequency",">","6"] |
density |
num |
keyword density
ratio of frequency to the total count of keywords with the set keyword_length on the web page or website
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example:
"filters": ["density",">","0.02"] |
