# HTML 용어별 도메인

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/domain_analytics/technologies/domains_by_html_terms/live`

**Tags:** DataForSEO

HTML에 지정한 `search_terms`가 포함된 도메인을 찾습니다. `post_dataforseo_domains_tech_domains_by_technology_live`가 감지된 기술과 일치하는 것과 달리 원시 문자열 일치입니다. 어떤 감지기도 이름을 붙이지 않는 추적 스니펫, 제휴 태그, 템플릿 서명에 사용하세요. 기술 검색과 동일한 프로필을 담은 `total_count`, `items_count`, `offset`, `offset_token`, `items`를 반환합니다.

### 가격 참고

- 과금 기준: 보고된 응답 비용.
- 참고 요청 추정치: USD 0.012.
- 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.

참고용 메타데이터일 뿐이며, 계정 견적, 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "search_terms": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "<em>대상 검색어</em><br><strong>필수 필드</strong><br>대상 HTML 요소, 태그, 속성, 해당 콘텐츠 또는 위 항목 전체를 지정합니다<br>검색어를 두 개 이상 지정하면 홈페이지 HTML 코드에 지정한 검색어가 모두 포함된 도메인만 반환됩니다<br>지정할 수 있는 최대 검색어 수: 10개<br>예:<br><code>[\"data-attrid\"]</code>"
          },
          "keywords": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>도메인의 제목, 설명 또는 메타 키워드에 있는 대상 키워드</em><br>선택 필드<br>UTF-8 인코딩<br>지정할 수 있는 최대 키워드 수: 10개 <br>예:<br><code>[\"seo\",\"software\"]</code><p>DataForSEO API의 <code>keyword</code> 및 <code>keywords</code> 필드 규칙과 제한은 이 <a href=\"https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis\" rel=\"noopener noreferrer\" target=\"_blank\">Help Center 문서</a>에서 확인하세요"
          },
          "mode": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>검색 모드</em><br>선택 필드<br>가능한 검색 모드 유형:<br><code>strict_entry</code> - 지정한 검색어의 순서, 간격, 구분 기호와 정확히 일치하는 결과를 검색합니다<br><code>entry</code> - 지정한 검색어의 순서, 간격, 구분 기호를 무시하고 결과를 검색합니다<br>기본값: <code>entry</code>"
          },
          "filters": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "object",
                "null"
              ]
            },
            "description": "<em>결과 필터링 매개변수 배열</em><br>선택 필드<br><strong>필터를 한 번에 여러 개 추가할 수 있습니다(최대 8개)</strong><br>조건 사이에 논리 연산자 <code>and</code>, <code>or</code>를 설정해야 합니다<br>지원되는 연산자:<br><code>&lt;</code>, <code>&lt;=</code>, <code>&gt;</code>, <code>&gt;=</code>, <code>=</code>, <code>&lt;&gt;</code>, <code>in</code>, <code>not_in</code>, <code>like</code>, <code>not_like</code><br><code>like</code> 및 <code>not_like</code>와 함께 <code>%</code> 연산자를 사용하면 0자 이상의 모든 문자열을 일치시킬 수 있습니다<br>예:<br><code>[\"domain\",\"like\",\"%seo%\"]</code><p><code>[[\"country_iso_code\",\"=\",\"US\"],<br>\"and\",<br>[\"domain_rank\",\"&gt;\",100]]</code><p><code>[[\"domain_rank\",\"&gt;\",100],<br>\"and\",<br>[[\"country_iso_code\",\"=\",\"US\"],\"or\",[\"country_iso_code\",\"=\",\"CA\"]]]</code><p>필터에 대한 자세한 내용은 <a href=\"/v3/domain_analytics/technologies/filters\" target=\"_blank\" rel=\"noopener noreferrer\">Domain Analytics Technologies API - Filters</a>를 참고하세요"
          },
          "order_by": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>결과 정렬 규칙</em><br>선택 필드<br>사용 가능한 필드: <br><code>domain_rank</code>, <code>domain</code>, <code>last_visited</code>, <code>country_iso_code</code>, <code>language_code</code>, <code>content_language_code</code><br>가능한 정렬 유형:<br><code>asc</code> - 결과가 오름차순으로 정렬됩니다<br><code>desc</code> - 결과가 내림차순으로 정렬됩니다<br>정렬 유형은 쉼표로 설정합니다<br>예:<br><code>[\"last_visited,desc\"]</code><br>기본 규칙:<br><code>[\"domain_rank,desc\"]</code><br><strong>단일 요청에서 정렬 규칙은 최대 세 개까지 설정할 수 있습니다</strong><br>여러 정렬 규칙은 쉼표로 구분합니다<br>예:<br><code>[\"last_visited,desc\",\"domain_rank,desc\"]</code>"
          },
          "limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>반환되는 최대 도메인 수</em><br>선택 필드<br>기본값: <code>100</code><br>최댓값: <code>10000</code>"
          },
          "offset": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>반환된 도메인의 결과 배열에서의 오프셋</em><br>선택 필드<br>기본값: <code>0</code><br><code>10</code> 값을 지정하면 결과 배열의 처음 열 개 도메인을 건너뛰고 이후 도메인의 데이터를 제공합니다;<br><strong>참고:</strong> 최댓값은 <code>9999</code>이며, <code>limit</code>과 <code>offset</code>의 합은 <code>10000</code>을 초과할 수 없습니다;<br>더 많은 결과를 오프셋하려면 <code>offset_token</code>을 사용하세요"
          },
          "offset_token": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>후속 요청용 토큰</em><br>선택 필드<br>각 요청에 대한 응답의 동일한 필드에서 제공됩니다;<br>단일 요청으로 100,000개가 넘는 결과를 가져올 때 타임아웃을 피하려면 이 매개변수를 사용하세요;<br>응답 배열에서 고유한 <code>offset_token</code> 값을 지정하면 초기 작업의 후속 결과를 받을 수 있습니다;<br><code>offset_token</code> 값은 각 후속 작업마다 고유합니다 <br><strong>참고:</strong> 요청에 <code>offset_token</code>을 지정한 경우 다른 모든 매개변수는 이전 요청과 동일해야 합니다<br>이 매개변수에 대한 자세한 내용은 <a href=\"https://dataforseo.com/help-center/what-is-the-difference-between-the-offset-and-offset_token-parameters#offset_token\" target=\"_blank\">Help Center</a>에서 확인하세요"
          }
        },
        "example": [
          {
            "search_terms": [
              "data-attrid"
            ],
            "order_by": [
              "last_visited,desc"
            ],
            "limit": 10,
            "offset": 0
          }
        ]
      }
    ]
  },
  "example": [
    {
      "search_terms": [
        "data-attrid"
      ],
      "order_by": [
        "last_visited,desc"
      ],
      "limit": 10,
      "offset": 0
    }
  ]
}
```

## Responses

### 200 — 작업 성공

Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResponseInfo"
    }
  ]
}
```

### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.

### 401 — 유효한 Felo API 키가 필요합니다.

### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.

### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다.

### 429 — 요청 또는 지출 한도에 도달했습니다.

### 502 — 서비스가 요청을 완료할 수 없습니다.

### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.

### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다.

### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "API의 현재 버전"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "일반 상태 코드입니다.\n응답 코드 전체 목록은 여기에서 확인할 수 있습니다."
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "일반 정보 메시지입니다.\n일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다."
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "총 실행 시간(초)"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "전체 작업 비용, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "tasks 배열의 작업 수",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "오류와 함께 반환된 tasks 배열의 작업 수",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "작업 식별자\n시스템 내 고유 작업 식별자(UUID 형식)"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "작업의 상태 코드\nDataForSEO가 생성하며 10000-60000 범위일 수 있습니다.\n응답 코드 전체 목록은 여기에서 확인할 수 있습니다."
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "작업의 정보 메시지\n일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다."
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "실행 시간, 초"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "전체 작업 비용, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "result 배열의 요소 수",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "URL 경로"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "POST 요청에 지정한 것과 동일한 매개변수를 포함합니다"
    }
  }
}
```

### Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveTaskInfo"
              }
            ]
          },
          "description": "<em>작업 배열</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResultInfo

`#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "total_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>데이터베이스의 관련 항목 총 개수</em>",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>결과 배열의 항목 수</em>",
      "format": "int64"
    },
    "offset": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>지정된 오프셋 값</em>"
    },
    "offset_token": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>후속 요청용 토큰</em><br>새 작업을 설정할 때 고유한 <code>offset_token</code>을 지정하면 초기 작업의 후속 결과를 받습니다;<br><code>offset_token</code> 값은 후속 작업마다 고유합니다"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByLiveItem"
          }
        ]
      },
      "description": "<em>항목 배열</em>"
    }
  }
}
```

### Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByHtmlTermsLiveResultInfo"
              }
            ]
          },
          "description": "<em>결과 배열</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByLiveItem

`#/components/schemas/Response36Afe1097B20_DomainAnalyticsTechnologiesDomainsByLiveItem`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "요소 유형"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>지정된 도메인 이름</em>"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>도메인 메타 제목</em>"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>도메인 메타 설명</em>"
    },
    "meta_keywords": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>도메인 메타 키워드</em>"
    },
    "domain_rank": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>대상 도메인의 백링크 순위</em><br>지표와 계산 방법은 <a href=\"https://dataforseo.com/help-center/what_is_rank_in_backlinks_api\" rel=\"noopener noreferrer\" target=\"_blank\">이 도움말 센터 문서</a>에서 확인하세요"
    },
    "last_visited": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>크롤러가 도메인을 마지막으로 방문한 날짜</em><br>UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”<br>예:<br><code>2022-10-10 12:57:46 +00:00</code>"
    },
    "country_iso_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>도메인 ISO 코드</em><br>대상 도메인이 속하는 것으로 판단된 국가의 ISO 코드"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>도메인 언어</em><br>대상 도메인이 연결된 것으로 판단되는 언어 코드"
    },
    "content_language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>콘텐츠 언어</em><br>대상 도메인의 콘텐츠가 작성된 언어 코드"
    },
    "phone_numbers": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>대상의 전화번호</em><br>대상 웹사이트에 표시된 연락처 전화번호"
    },
    "emails": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>대상의 이메일</em><br>대상 웹사이트에 표시된 이메일"
    },
    "social_graph_urls": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>소셜 미디어 링크 및 핸들</em><br>대상 웹사이트의 소셜 그래프에서 감지된 소셜 미디어 URL"
    },
    "technologies": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_TechnologiesInfo"
        }
      ],
      "description": "<em>대상 도메인이 사용하는 기술</em><br>웹사이트에서 사용되는 기술 이름을 담은 객체를 포함합니다;<br>전체 기술 목록과 구조는 <a href=\"/v3/domain_analytics/technologies/technologies/\">기술 엔드포인트</a>를 참조하세요"
    }
  },
  "description": "items 배열"
}
```

### Response36Afe1097B20_TechnologiesInfo

`#/components/schemas/Response36Afe1097B20_TechnologiesInfo`

```json
{
  "type": "object",
  "properties": {
    "add_ons": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "analytics": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "web_development": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "security": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "business_tools": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "sales": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "other": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "user_generated_content": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "booking": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "privacy": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "servers": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "location": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "content": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "media": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "marketing": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "communication": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "utilities": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    }
  }
}
```