Felo API PlatformFelo API Platform

資料 API / DataForSEO / Domain Analytics

Domains by Technology

Finds domains running a given technology - the reverse of post_dataforseo_domains_tech_for_domain_live. Accepts technologies, technology_paths, groups, categories and keywords, with filters and order_by over the fields named by get_dataforseo_domains_tech_available_filters. Returns total_count, items_count, offset, offset_token and items, each item the same profile as the per-domain call: domain, title, description, meta_keywords, domain_rank, last_visited, country_iso_code, language_code, content_language_code, phone_numbers, emails, social_graph_urls and technologies.

參數

沒有路徑、查詢或請求標頭參數。

請求主體

  • technology_pathsobject[]選填

    target technology paths required field if you don’t specify groups, technologies, keywords or categories at least one field (technology_paths, groups, technologies, keywords or categories) must be set; each technology path should be specified as a separate object containing “path” and “name”, where “path” is specified as “$group_id.$category_id” and “name” – as the name of the target technology; each object with a technology path should be separated with a comma you can find the full list of technology group ids, category ids and technology names on this page note: you can specify up to 10 technology paths in this array example: [{"path": "content.cms","name": "wordpress"}, {"path": "marketing.crm","name": "salesforce"}]

  • pathstring必填
  • namestring必填
  • groupsstring[]選填

    ids of the target technology groups required field if you don’t specify technologies, technology_paths, keywords or categories you can find the full list of technology group ids on this page note: you can specify up to 10 technology groups in this array example: ["sales", "marketing"]

  • categoriesstring[]選填

    ids of the target technology categories required field if you don’t specify groups, technology_paths, keywords or technologies you can find the full list of technology category ids on this page note: you can specify up to 10 technology categories in this array example: ["payment_processors","crm"]

  • technologiesstring[]選填

    target technologies required field if you don’t specify groups, technology_paths, keywords or categories you can find the full list of technologies you can specify here on this page note: you can specify up to 10 technologies in this array example: ["Google Pay","Salesforce"]

  • keywordsstring[]選填

    target keywords in the domain’s title, description or meta keywords required field if you don’t specify groups, technology_paths, technologies or categories optional field you can specify the maximum of 10 keywords; UTF-8 encoding; example: ["seo","software"] learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article

  • modestring選填

    search mode optional field possible search mode types: as_is – search for results exactly matching the specified group ids, category ids, or technology names entry – search for results matching a part of the specified group ids, category ids, or technology names default value: as_is

  • filtersarray選填

    array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditions the following operators are supported: , , >, >=, =, , in, not_in, like, not_like you can use the % operator with like and not_like to match any string of zero or more characters example: ["country_iso_code","=","US"] [["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

  • order_bystring[]選填

    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 order desc – 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"]

  • limitinteger選填

    the maximum number of returned domains optional field default value: 100 maximum value: 10000

  • offsetinteger選填

    offset in the results array of returned domains optional field default value: 0 if you specify the 10 value, 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 is 9999, the sum of limit and offset must not exceed 10000; use the offset_token if you would like to offset more results

  • offset_tokenstring選填

    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 unique offset_token value from the response array, you will get the subsequent results of the initial task; offset_token values are unique for each subsequent task Note: if the offset_token is specified in the request, all other parameters should be identical to the previous request learn more about this parameter on our Help Center

請求範例

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/domain_analytics/technologies/domains_by_technology/live" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "technology_paths": [
    {}
  ],
  "groups": [
    "<string>"
  ],
  "categories": [
    "<string>"
  ],
  "technologies": [
    "<string>"
  ],
  "keywords": [
    "<string>"
  ],
  "mode": "<string>",
  "filters": "<string>",
  "order_by": [
    "<string>"
  ]
}'

回應

回應欄位

  • versionstring選填

    the current version of the API

  • status_codeinteger選填

    general status code you can find the full list of the response codes here Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions

  • status_messagestring選填

    general informational message you can find the full list of general informational messages here

  • timestring選填

    execution time, seconds

  • costnumber選填

    total tasks cost, USD

  • tasks_countinteger選填

    the number of tasks in the tasks array

  • tasks_errorinteger選填

    the number of tasks in the tasks array returned with an error

  • tasksstring[]選填

    array of tasks

  • idstring選填

    task identifier unique task identifier in our system in the UUID format

  • status_codeinteger選填

    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_messagestring選填

    informational message of the task you can find the full list of general informational messages here

  • timestring選填

    execution time, seconds

  • costnumber選填

    cost of the task, USD

  • result_countinteger選填

    number of elements in the result array

  • pathstring[]選填

    URL path

  • dataobject選填

    contains the same parameters that you specified in the POST request

  • resultstring[]選填

    array of results

  • total_countinteger選填

    total number of relevant items in the database

  • items_countinteger選填

    number of items in the results array

  • offsetinteger選填

    specified offset value

  • offset_tokenstring選填

    token for subsequent requests by specifying the unique offset_token when setting a new task, you will get the subsequent results of the initial task; offset_token values are unique for each subsequent task

  • itemsstring[]選填

    items array

  • typestring選填

    type of the item = ‘domain_technology_item’

  • domainstring選填

    specified domain name

  • titlestring選填

    domain meta title

  • descriptionstring選填

    domain meta description

  • meta_keywordsstring[]選填

    domain meta keywords

  • domain_rankstring選填

    backlink rank of the target domain learn more about the metric and how it is calculated in this help center article

  • last_visitedstring選填

    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

  • country_iso_codestring選填

    domain ISO code ISO code of the country that target domain is determined to belong to

  • language_codestring選填

    domain language code of the language that target domain is determined to be associated with

  • content_language_codestring選填

    content language code of the language that content on the target domain is written with

  • phone_numbersstring[]選填

    phone numbers of the target contact phone numbers indicated on the target website

  • emailsstring[]選填

    emails of the target emails indicated on the target website

  • social_graph_urlsstring[]選填

    social media links and handles social media URLs detected in the social graphs of the target website

  • technologiesobject選填

    technologies used by target domain contains objects with the names of technologies used on the website; to get a full list of technologies and their structure, refer to the technologies endpoint