# Domains by HTML terms

This endpoint provides domains based on the HTML terms they use on their homepage. Needs search terms. Served by DataForSEO.

This endpoint provides domains based on the HTML terms they use on their homepage. In addition to the list of domains, you will also get their technology profiles, the country and language they belong to, and other related data.

- Tool ID: `dataforseo/domain-analytics-technologies-domains-by-html-terms`
- Name in the catalog: Domain Analytics Technologies Domains By Html Terms
- Provider: [DataForSEO](/providers/dataforseo.md)
- Capability: [Website technologies](/tools/developer-data/web-technologies.md)
- Price: usage based, the maximum is shown before a run
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

Billed at the cost the provider reports for the call, never above $100. Your agent sees the maximum before running.


```json
{
  "model": "reported",
  "costPath": "cost",
  "maxUsdDefault": 0.012,
  "maxUsdCap": 100,
  "multipliers": [
    {
      "addUsdPer": {
        "field": "limit",
        "usd": 0.0012,
        "default": 10,
        "max": 1000
      }
    }
  ],
  "requireCost": true
}
```

Pricing source: [https://docs.dataforseo.com/v3/appendix/user_data/](https://docs.dataforseo.com/v3/appendix/user_data/). Account tariff domain_analytics/technologies/domains_by_html_terms/live; bounds applied to inputs; actual cost from provider response..

Price verification date: 2026-10-10.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "search_terms": {
      "type": "array",
      "description": "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 HT",
      "items": {
        "type": "string",
        "maxLength": 2000,
        "minLength": 1
      },
      "maxItems": 100,
      "minItems": 1
    },
    "keywords": {
      "type": "array",
      "description": "target keywords in the domain's title, description or meta keywords optional field UTF-8 encoding maximum number of keywords you can specify: 10 example: [\"seo\",\"software\"]learn more about rules and limitations of keyword and keywords field",
      "items": {
        "type": "string",
        "maxLength": 80,
        "minLength": 1
      },
      "maxItems": 10,
      "minItems": 1
    },
    "mode": {
      "type": "string",
      "description": "search mode optional field possible search mode types: strict_entry - search for results exactly matching the order, intervals and separators in the specified search terms entry - search for results ignoring the order, intervals and separat",
      "maxLength": 2000,
      "minLength": 1
    },
    "filters": {
      "type": "array",
      "description": "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, no",
      "items": {},
      "maxItems": 15,
      "minItems": 1
    },
    "order_by": {
      "type": "array",
      "description": "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",
      "items": {
        "type": "string",
        "maxLength": 2000,
        "minLength": 1
      },
      "maxItems": 3,
      "minItems": 1
    },
    "limit": {
      "type": "integer",
      "description": "the maximum number of returned domains optional field default value: 100 maximum value: 10000",
      "maximum": 100,
      "minimum": 1,
      "default": 10
    },
    "offset": {
      "type": "integer",
      "description": "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 maxi",
      "minimum": 0
    },
    "offset_token": {
      "type": "string",
      "description": "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 off",
      "maxLength": 2000,
      "minLength": 1
    }
  },
  "required": [
    "search_terms"
  ],
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "dataforseo/domain-analytics-technologies-domains-by-html-terms",
  "input": {
    "search_terms": [
      "data-attrid"
    ],
    "order_by": [
      "last_visited,desc"
    ],
    "limit": 10,
    "offset": 0
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://docs.dataforseo.com/v3/domain_analytics/technologies/domains_by_html_terms/live/)

[REST inspection](https://api.agentik.cc/v1/tools/dataforseo/domain-analytics-technologies-domains-by-html-terms) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/dataforseo/domain-analytics-technologies-domains-by-html-terms) · [Agent index](/llms.txt)