Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Domains by Technology

服务器:https://openapi.felo.ai
客户端库

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

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.

请求体
必填
application/json
  • 类型: array object[]
      • technology_paths
        类型: array object[]
        必填

        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"}]

        • name
          类型: string
          必填
        • path
          类型: string
          必填
      • categories
        类型: array string[]

        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"]

      • filters
        类型: array

        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

      • groups
        类型: array string[]

        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"]

      • keywords
        类型: array string[]

        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

      • limit
        类型: integer

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

      • mode
        类型: string

        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

      • offset
        类型: integer

        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_token
        类型: string

        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

      • order_by
        类型: array string[]

        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"]

      • technologies
        类型: array string[]

        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"]

响应
  • 200
    类型: object

    Successful response

    • cost
      类型: number

      total tasks cost, USD

    • status_code
      类型: integer

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

    • status_message
      类型: string

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

    • tasks
      类型: array string[]

      array of tasks

    • 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.cost
      类型: number

      cost of the task, USD

    • tasks.data
      类型: object

      contains the same parameters that you specified in the POST request

    • tasks.id
      类型: string

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

    • tasks.path
      类型: array string[]

      URL path

    • tasks.result
      类型: array string[]

      array of results

    • tasks.result_count
      类型: integer

      number of elements in the result array

    • tasks.result.content_language_code
      类型: string

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

    • tasks.result.country_iso_code
      类型: string

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

    • tasks.result.description
      类型: string

      domain meta description

    • tasks.result.domain
      类型: string

      specified domain name

    • tasks.result.domain_rank
      类型: string

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

    • tasks.result.emails
      类型: array string[]

      emails of the target emails indicated on the target website

    • tasks.result.items
      类型: array string[]

      items array

    • tasks.result.items_count
      类型: integer

      number of items in the results array

    • tasks.result.language_code
      类型: string

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

    • tasks.result.last_visited
      类型: string

      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

    • tasks.result.meta_keywords
      类型: array string[]

      domain meta keywords

    • tasks.result.offset
      类型: integer

      specified offset value

    • tasks.result.offset_token
      类型: string

      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

    • tasks.result.phone_numbers
      类型: array string[]

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

    • tasks.result.social_graph_urls
      类型: array string[]

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

    • tasks.result.technologies
      类型: object

      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

    • tasks.result.title
      类型: string

      domain meta title

    • tasks.result.total_count
      类型: integer

      total number of relevant items in the database

    • tasks.result.type
      类型: string

      type of the item = ‘domain_technology_item’

    • tasks.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

    • tasks.status_message
      类型: string

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

    • tasks.time
      类型: string

      execution time, seconds

    • time
      类型: string

      execution time, seconds

    • version
      类型: string

      the current version of the API

    application/json
  • 400

    Bad request

  • 401

    Unauthorized

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    Rate limit exceeded

  • 500

    Internal server error

  • 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

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for post/v1/beta/dataforseo/domain_analytics/technologies/domains_by_technology/live
curl https://openapi.felo.ai/v1/beta/dataforseo/domain_analytics/technologies/domains_by_technology/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {}
]'
{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ],
  "tasks.result.total_count": 1,
  "tasks.result.items_count": 1,
  "tasks.result.offset": 1,
  "tasks.result.offset_token": "string",
  "tasks.result.items": [
    "string"
  ],
  "tasks.result.type": "string",
  "tasks.result.domain": "string",
  "tasks.result.title": "string",
  "tasks.result.description": "string",
  "tasks.result.meta_keywords": [
    "string"
  ],
  "tasks.result.domain_rank": "string",
  "tasks.result.last_visited": "string",
  "tasks.result.country_iso_code": "string",
  "tasks.result.language_code": "string",
  "tasks.result.content_language_code": "string",
  "tasks.result.phone_numbers": [
    "string"
  ],
  "tasks.result.emails": [
    "string"
  ],
  "tasks.result.social_graph_urls": [
    "string"
  ],
  "tasks.result.technologies": {}
}
Domains by Technology