DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Domains by HTML Terms
Finds domains whose HTML contains given search_terms - a raw string match where post_dataforseo_domains_tech_domains_by_technology_live matches a detected technology. Use it for a tracking snippet, an affiliate tag or a template signature that no detector names. Returns total_count, items_count, offset, offset_token and items carrying the same profile as the technology search.
Pricing reference
- Metering: Reported response cost.
- Reference request estimate: USD 0.012.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.
Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.
- Type: array (object | null)[]
- filtersType: array (object | null)[] | null
array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operatorand,orbetween the conditions
the following operators are supported:<,<=,>,>=,=,<>,in,not_in,like,not_like
you can use the%operator withlikeandnot_liketo match any string of zero or more characters
example:["domain","like","%seo%"][["country_iso_code","=","US"],
"and",
["domain_rank",">",100]][["domain_rank",">",100],
"and",
[["country_iso_code","=","US"],"or",["country_iso_code","=","CA"]]]for more information about filters, please refer to Domain Analytics Technologies API - Filters
Empty object - keywordsType: array string[] | null
- limitType: integer | null
the maximum number of returned domains
optional field
default value:100
maximum value:10000 - modeType: string | null
search mode
optional field
possible search mode types:strict_entry- search for results exactly matching the order, intervals and separators in the specified search termsentry- search for results ignoring the order, intervals and separators in the specified search terms
default value:entry - offsetType: integer | null
offset in the results array of returned domains
optional field
default value:0
if you specify the10value, the first ten domains in the results array will be omitted and the data will be provided for the successive domains;
Note: the maximum value is9999, the sum oflimitandoffsetmust not exceed10000;
use theoffset_tokenif you would like to offset more results - offsetType: string | null
_token token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 100,000 results in a single request;
by specifying the uniqueoffset_tokenvalue from the response array, you will get the subsequent results of the initial task;offset_tokenvalues are unique for each subsequent task
Note: if theoffset_tokenis specified in the request, all other parameters should be identical to the previous request
learn more about this parameter on our Help Center - orderType: array string[] | null
_by results sorting rules
optional field
available fields:domain_rank,domain,last_visited,country_iso_code,language_code,content_language_code
possible sorting types:asc- results will be sorted in the ascending orderdesc- results will be sorted in the descending order
you should use a comma to set up a sorting type
example:["last_visited,desc"]
default rule:["domain_rank,desc"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:["last_visited,desc","domain_rank,desc"] - searchType: array string[]
_terms target search terms
required field
specify target HTML elements, tags, attributes, their content or all of the above
if you specify more than one search term, you will receive only the domains containing all of the specified terms in the HTML code of their homepage
maximum number of search terms you can specify: 10
example:["data-attrid"]
- Type: object | null · Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResponseInfo200
- Type: number | null Format: doublecost
total tasks cost, USD
- Type: integer | nullstatus
_code general status code you can find the full list of the response codes here
- Type: string | nullstatus
_message general informational message you can find the full list of general informational messages here
- Type: array (object | null)[] | nulltasks
array of tasks
- Type: object | null · Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveTaskInfo
- costType: number | null Format: double
total tasks cost, USD
- dataType: object | null
contains the same parameters that you specified in the POST request
- propertyType: object | null
Name
- idType: string | null
task identifier unique task identifier in our system in the UUID format
- pathType: array (string | null)[] | null
URL path
- resultType: array (object | null)[] | null
array of results
- itemsType: array (object | null)[] | null
items array
items array
- contentType: string | null
_language _code content language
code of the language that content on the target domain is written with - countryType: string | null
_iso _code domain ISO code
ISO code of the country that target domain is determined to belong to - descriptionType: string | null
domain meta description
- domainType: string | null
specified domain name
- domainType: integer | null
_rank - emailsType: array (string | null)[] | null
emails of the target
emails indicated on the target website - languageType: string | null
_code domain language
code of the language that target domain is determined to be associated with - lastType: string | null
_visited most recent date when our crawler visited the domain
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2022-10-10 12:57:46 +00:00 - metaType: array (string | null)[] | null
_keywords domain meta keywords
- phoneType: array (string | null)[] | null
_numbers phone numbers of the target
contact phone numbers indicated on the target website - socialType: array (string | null)[] | null
_graph _urls social media links and handles
social media URLs detected in the social graphs of the target website - technologiesType: object | null · Response36Afe1097B20_TechnologiesInfo
- addType: object | null
_ons - propertyType: array (string | null)[] | null
Name
- analyticsType: object | null
- propertyType: array (string | null)[] | null
Name
- bookingType: object | null
- propertyType: array (string | null)[] | null
Name
- businessType: object | null
_tools - propertyType: array (string | null)[] | null
Name
- communicationType: object | null
- propertyType: array (string | null)[] | null
Name
- contentType: object | null
- propertyType: array (string | null)[] | null
Name
- locationType: object | null
- propertyType: array (string | null)[] | null
Name
- marketingType: object | null
- propertyType: array (string | null)[] | null
Name
- mediaType: object | null
- propertyType: array (string | null)[] | null
Name
- otherType: object | null
- propertyType: array (string | null)[] | null
Name
- privacyType: object | null
- propertyType: array (string | null)[] | null
Name
- salesType: object | null
- propertyType: array (string | null)[] | null
Name
- securityType: object | null
- propertyType: array (string | null)[] | null
Name
- serversType: object | null
- propertyType: array (string | null)[] | null
Name
- userType: object | null
_generated _content - propertyType: array (string | null)[] | null
Name
- utilitiesType: object | null
- propertyType: array (string | null)[] | null
Name
- webType: object | null
_development - propertyType: array (string | null)[] | null
Name
- titleType: string | null
domain meta title
- typeType: string | null
type of element
- itemsType: integer | null Format: int64
_count number of items in the results array
- offsetType: integer | null
specified offset value
- offsetType: string | null
_token token for subsequent requests
by specifying the uniqueoffset_tokenwhen setting a new task, you will get the subsequent results of the initial task;offset_tokenvalues are unique for each subsequent task - totalType: integer | null Format: int64
_count total number of relevant items in the database
- resultType: integer | null Format: int64
_count number of elements in the result array
- statusType: integer | null
_code 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
- statusType: string | null
_message informational message of the task you can find the full list of general informational messages here
- timeType: string | null
execution time, seconds
- Type: integer | null Format: int64tasks
_count the number of tasks in the tasks array
- Type: integer | null Format: int64tasks
_error the number of tasks in the tasks array returned with an error
- Type: string | nulltime
total execution time, seconds
- Type: string | nullversion
the current version of the API
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
Error response; upstream passthrough responses may use provider formats
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/domain_analytics/technologies/domains_by_html_terms/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"search_terms": [
"data-attrid"
],
"order_by": [
"last_visited,desc"
],
"limit": 10,
"offset": 0
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"total_count": null,
"items_count": null,
"offset": null,
"offset_token": null,
"items": [
{
"type": null,
"domain": null,
"title": null,
"description": null,
"meta_keywords": [
"[Max Depth Exceeded]"
],
"domain_rank": null,
"last_visited": null,
"country_iso_code": null,
"language_code": null,
"content_language_code": null,
"phone_numbers": [
"[Max Depth Exceeded]"
],
"emails": [
"[Max Depth Exceeded]"
],
"social_graph_urls": [
"[Max Depth Exceeded]"
],
"technologies": "[Max Depth Exceeded]"
}
]
}
]
}
]
}