Backlinks API features plenty of parameters that support custom filtration. By applying filters to your POST requests, you will be able to effortlessly extract data that matches your requirements. Note that we do not charge any fees for using data filtering or sorting rules.
Here you will find all the necessary information about filters that can be used with DataForSEO Backlinks API endpoints.
Note that filters are associated with a certain object in the result array, and thus should be specified accordingly. You can learn more about how to use filters in this help center article.
You will receive the full list of filters by calling this API. You can also download the full list of possible filters by this link.
As a response of the API server, you will receive JSON-encoded data containing a tasks array with the information specific to the set tasks.
Field name
Type
Description
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
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 parameters passed in the URL of the GET request
result
array
array of results
contains the full list of available parameters that can be used for data filtration
the parameters are grouped by the endpoint they can be used with
Below you will find a detailed description of filters available in DataForSEO Backlinks API endpoints. You can specify up to 8 filters by using the and, or logical operators between the conditions.
Note: in Domain Intersection and Page Intersection endpoints the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
for example, if you specify the pages in the POST request as follows: "targets":[
"https://football.com/news",
"https://fifa.com/updates",
"https://uefa.com/updates"]
the specified pages will be assigned with sequence numbers; e.g. the filter by the “https://fifa.com/updates” page will be assigned a “2” and will look as follows: "filters": ["2.domain_from","=","news24.com"]
Note #2: in Backlinks Anchors, Domain Pages and Domain Intersection endpoints you may come across empty-titled fields in the referring_links_semantic_locations array, which, however, are also available in filters. These empty fields are denoted as $empty and have the num type.
example: referring_links_semantic_locations.$empty
Note #3: in the following endpoints, you can filter the results by any top-level domain (TLD) from the referring_links_tld object of the response, but the structure of the filtered field is different:
In all cases, replace the $tld variable with the necessary TLD returned in the referring_links_tld object of the endpoint’s response. Example filter: "filters": ["1.referring_links_tld.com",">",0]
unlike other fields, referring_links_tld.$tld is only available in filters and cannot be used in the order_by parameter for sorting the results.
Description of the available filters:
Field name
Type
Description
filters
array
array of results filtering parameters
filters have the following structure: [filered_fieldfilter_operatorfilter_value] you can add several filters at once (8 filters maximum)
if you add more than one filter, you must set a logical operator and, or between the conditions
example: [["domain_from","=", "dataforseo.com"],"and",[["acnhor","like","%seo%"],"or",["texr_pre","like","%seo%"]]]
filtered_field
str
fields that support filtration
you can find all available filtered_field values here
Note: fields with an $empty mark are empty, but their values can still be filtered;
in the fields containing $key, this variable denotes the sequence number of the target indicated in the targets array of the POST request
filter_operator
str
operator in the filter
available filter operators:
• if bool: =, <>
• if num: <, <=, >, >=, =, <>, in, not_in
• if str: like, not_like, ilike, not_ilike, in, not_in, =, <>, regex, not_regex
• if array.str: has, has_not
• if array.num: has, has_not
• if time: <, >time should be specified in the format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2021-01-29 15:02:37 +00:00
if you specify in or not_in operator, the $filter_value should be specified as an array
example: ["rank","in",[1,5]]
regex and not_regex operators can be specified with string values using the RE2 regex syntax; Note: the maximum limit for the number of characters you can specify in regex and not_regex is 1000;
like and not_like operators require adding % symbol to get accurate results;
example: ["anchor", "like", "%seo%"] return backlinks items that contain “seo” in the anchor field ["texr_pre", "not_like", "%seo%"] do not return backlinks items that contain “seo” in the text_pre field
filter_value
filtering value
values specified in the filter_value should match the format of the specified filtered_field
domain referring to the target domain or webpage
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": [["domain_from","like","forbes.%"],"and",["domain_from","<>","forbes.com"]]
url_from
str
URL of the page where the backlink is found
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": [["domain_from","=","forbes.com"],"and",["url_from","like","%/sites/%"]]
url_from_https
bool
indicates whether the referring URL is secured with HTTPS
the following operators are supported: =, <>
example: "filters": ["url_from_https","=",true]
domain_to
str
domain the backlink is pointing to
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": [["domain_to","like","forbes.%"],"and",["domain_to","not_like","%forbes.com"]]
url_to
str
URL of the page the backlink is pointing to
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": [["domain_to","=","forbes.com"],"and",["url_to","like","%/stories/collection%"]]
url_to_https
bool
indicates if the URL the backlink is pointing to is secured with HTTPS
the following operators are supported: =, <>
example: "filters": ["url_to_https","=",false]
tld_from
str
top-level domain of the referring URL
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": [["tld_from","=",".gov"],"or",["tld_from","=",".edu"]]
is_new
bool
indicates whether the backlink is new
the following operators are supported: =, <>
example: "filters": ["is_new","=",true]
is_lost
bool
indicates whether the backlink was removed
the following operators are supported: =, <>
example: "filters": ["is_lost","=",true]
backlink_spam_score
num
spam score of the backlink
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": [["backlink_spam_score","<", "10"]],"and",["backlink_spam_score",">","50"]]
rank
num
backlink rank
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": [["rank","<", "10"]],"and",["rank",">","1"]]
page_from_rank
num
page rank of the referring page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": [["page_from_rank","<", "10"]],"and",["page_from_rank",">","1"]]
domain_from_rank
num
domain rank of the referring domain
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": [["domain_from_rank","<", "10"]],"and",["domain_from_rank",">","1"]]
domain_from_platform_type
array.str
platform types of the referring domain
the following operators are supported: has
example: "filters": ["domain_from_platform_type","has","blogs"]
domain_from_is_ip
bool
domain rank of the referring domain
the following operators are supported: =, <>
example: "filters": ["domain_from_is_ip","=", false]
domain_from_ip
str
IP address of the referring domain
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": [["domain_from_ip","=","172.64.32.57"],"or",["domain_from_ip","=","108.162.193.154"]]
page_from_external_links
num
number of external links found on the referring page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": [["page_from_external_links","<", "10"]],"and",["page_from_external_links",">","1"]]
page_from_internal_links
num
number of internal links found on the referring page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": [["page_from_internal_links","<", "10"]],"and",["page_from_internal_links",">","1"]]
page_from_size
num
size of the referring page, in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": ["page_from_page_from_size","<","63357"]
page_from_encoding
str
character encoding of the referring page
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": ["page_from_encoding","=","utf-8"]
page_from_language
str
language of the referring page
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": ["page_from_language","=","en"]
page_from_title
str
language of the referring page
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": ["page_from_title","not_like","%seo%"]
page_from_status_code
num
HTTP status code returned by the referring page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": [["page_from_status_code","≥", "200"]],"and",["page_from_external_links","<","300"]]
first_seen
time
date and time when our crawler found the backlink for the first time
in the ISO 8601 format
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": ["first_seen",">","2021-01-29 01:24:54 +00:00"]
prev_seen
time
previous to the most recent date when our crawler visited the backlink
in the ISO 8601 format
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": ["prev_seen",">","2019-11-15 12:57:46 +00:00"]
last_seen
time
most recent date when our crawler visited the backlink
in the ISO 8601 format
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": ["last_seen",">","2020-11-15 12:57:46 +00:00"]
item_type
str
link type
possible values: anchor, image, meta, canonical, alternate, redirect
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": ["item_type","<>","redirect"]
dofollow
bool
indicates whether the backlink is dofollow
the following operators are supported: =, <>
example: "filters": ["dofollow","=",true]
original
bool
indicates whether the backlink was present on the referring page when our crawler first visited it
the following operators are supported: =, <>
example: "filters": ["original","=",false]
alt
str
alternative text of the image
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": ["alt","like","%logo%"]
anchor
str
anchor text of the backlink
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": ["anchor","like","%dataforseo%"]
text_pre
str
text snippet before the anchor text
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": ["text_pre","like","%seo data provider%"]
text_post
str
text snippet after the anchor text
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": ["text_post","like","%seo data provider%"]
semantic_location
str
indicates semantic element in HTML where the backlink is found
you can get the full list of semantic elements here
the following operators are supported: =, <>, like, not_like, ilike, not_ilike
example: "filters": ["semantic_location","=","article"]
links_count
num
number of identical backlinks found on the referring page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": ["links_count","≥", "1"]
group_count
num
indicates total number of backlinks from this domain
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": ["group_count","≥", "5000"]
is_broken
bool
indicates whether the backlink is broken
the following operators are supported: =, <>
example: "filters": ["is_broken","=",true]
url_to_status_code
num
status code of the referenced page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": ["url_to_status_code","=", "200"]
url_to_spam_score
num
spam score of the referenced page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": [["url_to_spam_score","<", "10"]],"and",["url_to_spam_score",">","50"]]
domain referring to the target domain or webpage
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example:
if you specify the pages in the POST request as follows: "targets":[
"https://football.com/news",
"https://fifa.com/updates",
"https://uefa.com/updates"
the specified pages will be assigned with sequence numbers and the filter by the “https://fifa.com/updates” page will look as follows: "filters": ["2.domain_from","=","news24.com"]
$key.url_from
str
URL of the page where the backlink is found
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["2.url_from","=","https://news24.com/world-cup-2022"]
$key.url_from
str
URL of the page where the backlink is found
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["2.url_from","=","https://news24.com/world-cup-2022"]
$key.url_from_https
bool
indicates whether the referring URL is secured with HTTPS
the following operators are supported: =, <>
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["2.url_from_https","=","true"]
$key.domain_to
str
domain the backlink is pointing to
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": [["2.domain_to","<>","uefa.com"], "and", ["2.domain_to","<>","football.com"]]
$key.url_to
str
URL the backlink is pointing to
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["2.url_to","<>","https://fifa.com/updates"]
$key.url_to_https
bool
indicates if the URL the backlink is pointing to is secured with HTTPS
the following operators are supported: =, <>
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["1.url_from_https","=","true"]
$key.tld_from
str
top-level domain of the referring URL
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": [["1.tld_from","=","com"], "and", ["2.tld_from","=","com"], and, ["3.tld_from","=","com"]]
$key.is_new
bool
indicates whether the backlink is new
the following operators are supported: =, <>
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["1.is_new","=","true"]
$key.is_lost
bool
indicates whether the backlink was removed
the following operators are supported: =, <>
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["2.is_lost","<>","true"]
$key.backlink_spam_score
num
spam score of the backlink
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": [["1.backlink_spam_score",">","80"]],"and",["2.backlink_spam_score","<","10"]]
$key.rank
num
backlink rank
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": [["1.rank",">","800"]],"and",["2.rank","<","100"]]
$key.page_from_rank
num
page rank of the referring page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": [["1.page_from_rank",">","800"]],"or",["2.page_from_rank",">","800"]]
$key.domain_from_rank
num
page rank of the referring domain
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
example: "filters": [["1.domain_from_rank",">","800"]],"or",["2.domain_from_rank",">","800"]]
domain_from_platform_type
array.str
platform types of the referring domain
the following operators are supported: has
example: "filters": ["domain_from_platform_type","has","blogs"]
$key.domain_from_is_ip
bool
indicates if the domain is IP
the following operators are supported: =, <>
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["2.domain_from_is_ip","=","false"]
$key.domain_from_ip
str
IP address of the referring domain
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["1.domain_from_ip","like","%231.150"]
$key.page_from_external_links
num
number of external links found on the referring page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": [["1.page_from_external_links",">","10"]],"or",["2.page_from_external_links",">","10"]]
$key.page_from_internal_links
num
number of internal links found on the referring page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["1.page_from_internal_links",">","50"]
$key.page_from_size
num
size of the referring page, in bytes
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["3.page_from_size","<","1000000"]
$key.page_from_encoding
str
character encoding of the referring page
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["3.page_from_encoding","like","utf-%"]
$key.page_from_language
str
language of the referring page
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["3.page_from_language","=","de"]
$key.page_from_title
str
title of the referring page
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["3.page_from_title","like","%world cup%"]
$key.page_from_status_code
num
HTTP status code returned by the referring page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["3.page_from_status_code","=","200"]
$key.first_seen
time
date and time when our crawler found the backlink for the first time
in the ISO 8601 format
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["1.first_seen",">","2021-01-29 01:24:54 +00:00"]
$key.prev_seen
time
previous to the most recent date when our crawler visited the backlink
in the ISO 8601 format
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["2.prev_seen",">","2019-11-15 12:57:46 +00:00"]
$key.last_seen
time
most recent date when our crawler visited the backlink
in the ISO 8601 format
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["3.last_seen",">","2020-11-15 12:57:46 +00:00"]
$key.item_type
str
link type
possible values: anchor, image, link, meta, canonical, alternate, redirect;
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["1.item_type","=","anchor"]
$key.dofollow
bool
indicates whether the backlink is dofollow
the following operators are supported: =, <>
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["1.dofollow","=","true"]
$key.original
bool
indicates whether the backlink was present on the referring page when our crawler first visited it
the following operators are supported: =, <>
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["1.original","=","true"]
$key.alt
str
alternative text of the image
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["1.alt","like","%Gianni%"]
$key.anchor
str
anchor text of the backlink
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["1.anchor","like","%FIFA%"]
$key.text_pre
str
text snippet before the anchor text
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["1.text_pre","like","%Gianni%"]
$key.text_post
str
text snippet after the anchor text
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["1.text_post","not_like","%Gianni%"]
$key.semantic_location
str
indicates semantic element in HTML where the backlink is found
the following operators are supported: =, <>, like, not_like, ilike, not_ilike;
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["1.semantic_location","=","article"]
$key.links_count
num
number of identical backlinks found on the referring page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["2.links_count",">","5"]
$key.group_count
num
indicates the total number of backlinks from this domain
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["2.group_count",">","100"]
$key.is_broken
bool
indicates whether the backlink is broken
the following operators are supported: =, <>
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["2.is_broken","=","false"]
$key.url_to_status_code
num
status code of the referenced page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in
Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["3.url_to_status_code","=","200"]
$key.url_to_spam_score
num
spam score of the referenced page
the following operators are supported: <, <=, >, >=, =, <>, in, not_in Note: the $key parameter refers to the variable denoting the sequence number of the page indicated in the targets array of the POST request;
example: "filters": ["3.url_to_spam_score",">","50"]
