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

Aggregation Technologies

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клиентские библиотеки
Shell Curl

DataForSEO

​

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

DataForSEO Операции

Aggregation Technologies

​

Counts rather than domains: how many sites match a technology query, broken down by group, category and technology. Returns total_count, items_count, offset and items, with internal_groups_list_limit, internal_categories_list_limit, internal_technologies_list_limit and internal_list_limit each capping a different nesting level - set all four or the response grows quickly. For the domains themselves rather than their counts, use post_dataforseo_domains_tech_domains_by_technology_live.

Тело
обязательно
application/json
  • Тип: array object[]
      • group
        Тип: string
        обязательно

        id of the target technology group required field if you don’t specify technology, category or keyword at least one field (group, category, keyword, technology) must be set you can find the full list of technology group ids on this page example: "marketing"

      • category
        Тип: string

        id of the target technology category required field if you don’t specify group, keyword or technology at least one field (group, category, keyword, technology) must be set you can find the full list of technology category ids on this page example: "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 you can use the following parameters to filter the results: domain_rank, last_visited, country_iso_code, language_code, content_language_code Note: all filtering parameters are taken from the domain_technology_item of the domain_technologies endpoint; example: [["country_iso_code","=","US"], "and", ["domain_rank",">",800]]for more information about filters, please refer to Domain Analytics Technologies API – Filters

      • internal_categories_list_limit
        Тип: integer

        maximum number of returned technology categories within the same group optional field you can use this field to limit the number of items with identical "category" in the results default value: 5 minimum value: 1 maximum value: 10000

      • internal_groups_list_limit
        Тип: integer

        maximum number of returned technology groups optional field you can use this field to limit the number of items with identical "group" in the results default value: 5 minimum value: 1 maximum value: 10000

      • internal_list_limit
        Тип: integer

        maximum number of items with identical "category", "group", and "technology" optional field if you use this field, the values specified in internal_groups_list_limit, internal_categories_list_limit and internal_technologies_list_limit will be ignored; you can use this field to limit the number of items with identical "category", "group", or "technology" default value: 10 minimum value: 1 maximum value: 10000

      • internal_technologies_list_limit
        Тип: integer

        maximum number of returned technologies within the same category optional field you can use this field to limit the number of items with identical "technology" in the results default value: 10 minimum value: 1 maximum value: 10000

      • keyword
        Тип: string

        target keyword in the domain’s meta keywords required field if you don’t specify group, category or technology at least one field (group, category, keyword, technology) must be set UTF-8 encoding example: "seo"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 technologies 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 maximum value: 9999 if you specify the 10 value, the first ten technologies in the results array will be omitted and the data will be provided for the successive technologies

      • order_by
        Тип: array string[]

        results sorting rules optional field you can use the following values to sort the results: groups_count, categories_count, technologies_count 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: ["groups_count,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: ["groups_count,desc","technologies_count,desc"] default value: ["groups_count,desc","categories_count,desc","technologies_count,desc"]

      • tag
        Тип: string

        user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response

      • technology
        Тип: string

        target technology required field if you don’t specify group, keyword or category at least one field (group, category, keyword, technology) must be set you can find the full list of technologies on this page example: "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.
      Тип: string

      type of element = ‘aggregation_technologies_item’

    • tasks.result.categories_count
      Тип: integer

      technology categories count number of domains that match the parameters you specified and are using technologies from the indicated category

    • tasks.result.category
      Тип: string

      technology category id

    • tasks.result.group
      Тип: string

      technology group id

    • tasks.result.groups_count
      Тип: integer

      technology groups count number of domains that match the parameters you specified and are using technologies from the indicated group

    • tasks.result.items_count
      Тип: integer

      the number of results returned in the items array

    • tasks.result.technologies_count
      Тип: integer

      technologies count number of domains that match the parameters you specified and are using the indicated technology

    • tasks.result.technology
      Тип: string

      technology name

    • tasks.result.total_count
      Тип: integer

      total amount of results in our database relevant to your request

    • 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/aggregation_technologies/live
curl https://openapi.felo.ai/v1/beta/dataforseo/domain_analytics/technologies/aggregation_technologies/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.": "string",
  "tasks.result.group": "string",
  "tasks.result.category": "string",
  "tasks.result.technology": "string",
  "tasks.result.groups_count": 1,
  "tasks.result.categories_count": 1,
  "tasks.result.technologies_count": 1
}

Successful response

Aggregation Technologies