# ドメイン Whois 概要
**API:** Data API
**Endpoint:** `POST /v1/beta/dataforseo/domain_analytics/whois/overview/live`
**Tags:** DataForSEO
SEO 指標で拡充された Whois レコード。各項目には `domain`、`created_datetime`、`changed_datetime`、`expiration_datetime`、`updated_datetime`、`first_seen`、`epp_status_codes`、`tld`、`registered`、`registrar` と、`metrics`、`backlinks_info` が含まれます。`limit`、`offset`、`offset_token` でページングし、`get_dataforseo_domains_whois_available_filters` のフィールドで絞り込めます。
### 料金の参考情報
- 計測方法：報告されたレスポンスコスト。
- 参考リクエスト見積もり：0.012 USD。
- 参照用の顧客乗数：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": {
"limit": {
"type": [
"integer",
"null"
],
"description": "返されるドメインの最大数
任意フィールド
デフォルト値: 100
最大値: 1000"
},
"offset": {
"type": [
"integer",
"null"
],
"description": "返される項目の結果配列内のオフセット
任意フィールド
デフォルト値: 0
値 10 を指定すると、結果配列の最初の 10 件の items が省略され、後続の項目のデータが提供されます
注意: このパラメーターは最大 10,000 件の結果を取得する場合にのみ使用することをお勧めします。10,000 件を超える結果を取得する場合は、代わりに offset_token を使用してください"
},
"offset_token": {
"type": [
"string",
"null"
],
"description": "後続のリクエスト用のトークン
任意フィールド
各リクエストのレスポンスの同じ名前のフィールドで提供されます
このパラメーターは、1 回のリクエストで 100,000 件を超える結果を取得する際のタイムアウトを回避するために使用します
レスポンス配列内の一意の offset_token 値を指定すると、最初のタスクの後続の結果を取得できます
offset_token の値は後続のタスクごとに一意です
注意: リクエストで offset_token を指定する場合、他のすべてのパラメーターは前回のリクエストと同一にする必要があります
このパラメーターの詳細については、ヘルプセンターをご覧ください"
},
"filters": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
]
},
"description": "結果フィルターパラメーターの配列
任意フィールド
複数のフィルターを同時に追加できます（最大 8 個）
条件の間には論理演算子 and、or を設定してください
次の演算子がサポートされています:
regex、<、<=、>、>=、=、<>、in、not_in、like、not_like
like と not_like で % 演算子を使用すると、0 文字以上の任意の文字列に一致させられます"
},
"order_by": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "結果の並べ替えルール
任意フィールド
filters 配列と同じ値を使用して結果を並べ替えられます
指定可能な並べ替えの種類:
asc - 結果は昇順で並べ替えられます
desc - 結果は降順で並べ替えられます
区切り文字としてカンマを使用します
例:
[\"metrics.organic.pos_1,desc\"]
デフォルトのルール:
[\"metrics.organic.count,desc\"]
注意:1 回のリクエストで設定できる並べ替えルールは 3 つまでです
複数の並べ替えルールはカンマで区切ってください
例:
[\"expiration_datetime,asc\",\"metrics.organic.etv,desc\",\"metrics.organic.pos_1,desc\"]"
},
"tag": {
"type": [
"string",
"null"
],
"description": "ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定した tag の値は、レスポンスの data オブジェクトに含まれます"
}
},
"example": [
{
"limit": 2,
"filters": [
[
"epp_status_codes",
"in",
[
"client_transfer_prohibited",
"client_update_prohibited"
]
]
]
}
]
}
]
},
"example": [
{
"limit": 2,
"filters": [
[
"epp_status_codes",
"in",
[
"client_transfer_prohibited",
"client_update_prohibited"
]
]
]
}
]
}
```
## Responses
### 200 — 操作成功
Headers:
- `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。
**application/json**
Schema: object | null
```json
{
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveResponseInfo"
}
]
}
```
### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。
### 401 — 有効な Felo API キーが必要です。
### 402 — 請求要件が満たされていないため、リクエストを続行できません。
### 403 — このアカウントにはこの操作を行う権限がありません。
### 429 — リクエストまたは支出の上限に達しました。
### 502 — サービスがリクエストを完了できませんでした。
### 503 — API または請求サービスが一時的に利用できません。
### 504 — リクエストの処理中にサービスがタイムアウトしました。
### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります
**application/json**
Schema:
```json
{}
```
## Schema definitions
### Response36Afe1097B20_BacklinksInfo
`#/components/schemas/Response36Afe1097B20_BacklinksInfo`
```json
{
"type": "object",
"properties": {
"referring_domains": {
"type": [
"integer",
"null"
],
"description": "平均参照ドメイン数",
"format": "int64"
},
"referring_main_domains": {
"type": [
"integer",
"null"
],
"description": "平均参照メインドメイン数",
"format": "int64"
},
"referring_pages": {
"type": [
"integer",
"null"
],
"description": "平均参照ページ数",
"format": "int64"
},
"dofollow": {
"type": [
"integer",
"null"
],
"description": "平均 dofollow リンク数",
"format": "int64"
},
"backlinks": {
"type": [
"integer",
"null"
],
"description": "平均被リンク数",
"format": "int64"
},
"time_update": {
"type": [
"string",
"null"
],
"description": "被リンクデータが更新された日時
UTC 形式：“yyyy-mm-dd hh-mm-ss +00:00”；
例:
2019-11-15 12:57:46 +00:00"
}
}
}
```
### 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_DomainAnalyticsWhoisOverviewLiveItem
`#/components/schemas/Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveItem`
```json
{
"type": "object",
"properties": {
"domain": {
"type": [
"string",
"null"
],
"description": "ドメイン名"
},
"created_datetime": {
"type": [
"string",
"null"
],
"description": "登録日時
ドメインが最初に登録された日時（ISO 8601 形式）
例:
\"1997-03-29 03:00:00 +00:00\""
},
"changed_datetime": {
"type": [
"string",
"null"
],
"description": "ドメインエントリが変更された日時
ドメインエントリが最後に変更された日時（ISO 8601 形式）
例:
\"2021-01-14 08:36:28 +00:00\""
},
"expiration_datetime": {
"type": [
"string",
"null"
],
"description": "ドメインが期限切れになる日時
ドメインの有効期限が切れる日時（ISO 8601 形式）
例:
\"2022-11-26 17:21:23 +00:00\""
},
"updated_datetime": {
"type": [
"string",
"null"
],
"description": "ドメインが更新された日時
ドメインが最後に更新された日時（ISO 8601 形式）
例:
\"2021-01-29 13:59:38 +00:00\""
},
"first_seen": {
"type": [
"string",
"null"
],
"description": "当社のクローラーが初めてドメインを検出した日時
UTC 形式: “yyyy-mm-dd hh-mm-ss +00:00”
例:
\"2019-11-15 12:57:46 +00:00\""
},
"epp_status_codes": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "拡張プロビジョニングプロトコルのステータスコード
ドメイン名登録のステータス（ICANN による定義）"
},
"tld": {
"type": [
"string",
"null"
],
"description": "トップレベルドメイン
DNS ルートゾーンのトップレベルドメイン"
},
"registered": {
"type": [
"boolean",
"null"
],
"description": "ドメインの登録ステータス
false の場合、ドメイン名の登録は期限切れです
注意: 期限切れのドメインはデータベースに短期間だけ残ります"
},
"registrar": {
"type": [
"string",
"null"
],
"description": "ドメインレジストラ
null の場合、ドメインレジストラは不明です
例:
NameCheap, Inc."
},
"metrics": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_MetricsBundleInfo"
}
],
"description": "指定したドメインに関連するランキングデータ"
},
"backlinks_info": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BacklinksInfo"
}
],
"description": "返されたドメインの被リンクデータ"
}
},
"description": "項目の配列"
}
```
### Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveResponseInfo
`#/components/schemas/Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveResponseInfo`
```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_DomainAnalyticsWhoisOverviewLiveTaskInfo"
}
]
},
"description": "タスクの配列"
}
}
}
]
}
```
### Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveResultInfo
`#/components/schemas/Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveResultInfo`
```json
{
"type": "object",
"properties": {
"total_count": {
"type": [
"integer",
"null"
],
"description": "当社データベース内のリクエストに関連する結果の総数",
"format": "int64"
},
"items_count": {
"type": [
"integer",
"null"
],
"description": "items 配列で返される結果の数",
"format": "int64"
},
"offset": {
"type": [
"integer",
"null"
],
"description": " POST リクエストで指定した結果のオフセット値"
},
"offset_token": {
"type": [
"string",
"null"
]
},
"items": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveItem"
}
]
},
"description": "ランキングとトラフィックのデータを含みます"
}
}
}
```
### Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveTaskInfo
`#/components/schemas/Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveTaskInfo`
```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_DomainAnalyticsWhoisOverviewLiveResultInfo"
}
]
},
"description": "結果の配列"
}
}
}
]
}
```
### Response36Afe1097B20_MetricsBundleInfo
`#/components/schemas/Response36Afe1097B20_MetricsBundleInfo`
```json
{
"type": "object",
"properties": {
"organic": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_MetricsInfo"
}
],
"properties": {
"is_new": {
"type": [
"integer",
"null"
],
"description": "新たにランク付けされた要素の数\nこのドメインで新たに見つかったランク付け要素の数を示します",
"format": "int64"
},
"is_up": {
"type": [
"integer",
"null"
],
"description": "ランクの上昇\nこのドメインの Google 検索でのランクが上昇した要素の数を示します",
"format": "int64"
},
"is_down": {
"type": [
"integer",
"null"
],
"description": "ランクの下落\nこのドメインの Google 検索でのランクが下落した要素の数を示します",
"format": "int64"
},
"is_lost": {
"type": [
"integer",
"null"
],
"description": "失われたランク付け要素\nこのドメインが以前 SERP に表示されていたものの、前回のチェックで見つからなかったランク付け要素の数を示します",
"format": "int64"
}
},
"description": "オーガニック検索のランキングとトラフィック データ"
},
"paid": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_MetricsInfo"
}
],
"description": "有料検索のランキングとトラフィック データ"
}
}
}
```
### Response36Afe1097B20_MetricsInfo
`#/components/schemas/Response36Afe1097B20_MetricsInfo`
```json
{
"type": "object",
"properties": {
"pos_1": {
"type": [
"integer",
"null"
],
"description": "ドメインが 1 位にランク付けされているオーガニック SERP の数"
},
"pos_2_3": {
"type": [
"integer",
"null"
],
"description": "ドメインが 2～3 位にランク付けされているオーガニック SERP の数"
},
"pos_4_10": {
"type": [
"integer",
"null"
],
"description": "ドメインが 4～10 位にランク付けされているオーガニック SERP の数"
},
"pos_11_20": {
"type": [
"integer",
"null"
],
"description": "ドメインが 11～20 位にランク付けされているオーガニック SERP の数"
},
"pos_21_30": {
"type": [
"integer",
"null"
],
"description": "ドメインが 21～30 位にランク付けされているオーガニック SERP の数"
},
"pos_31_40": {
"type": [
"integer",
"null"
],
"description": "ドメインが 31～40 位にランク付けされているオーガニック SERP の数"
},
"pos_41_50": {
"type": [
"integer",
"null"
],
"description": "ドメインが 41～50 位にランク付けされているオーガニック SERP の数"
},
"pos_51_60": {
"type": [
"integer",
"null"
],
"description": "ドメインが 51～60 位にランク付けされているオーガニック SERP の数"
},
"pos_61_70": {
"type": [
"integer",
"null"
],
"description": "ドメインが 61～70 位にランク付けされているオーガニック SERP の数"
},
"pos_71_80": {
"type": [
"integer",
"null"
],
"description": "ドメインが 71～80 位にランク付けされているオーガニック SERP の数"
},
"pos_81_90": {
"type": [
"integer",
"null"
],
"description": "ドメインが 81～90 位にランク付けされているオーガニック SERP の数"
},
"pos_91_100": {
"type": [
"integer",
"null"
],
"description": "ドメインが 91～100 位にランク付けされているオーガニック SERP の数"
},
"etv": {
"type": [
"number",
"null"
],
"description": "推定トラフィック量
ドメインへの推定オーガニック月間トラフィック
ドメインが上位表示されるすべてのキーワードの CTR（クリック率）と検索ボリュームの積で算出されます
指標の計算方法の詳細については、このヘルプセンター記事をご覧ください"
},
"count": {
"type": [
"integer",
"null"
],
"description": "ドメインを含むオーガニック SERP の総数",
"format": "int64"
},
"estimated_paid_traffic_cost": {
"type": [
"number",
"null"
],
"description": "オーガニック検索トラフィックを有料に変換する推定コスト
ドメインがランク付けされているすべてのキーワードについて、広告を配信する推定月間コスト（USD）を表します
この指標は、オーガニック etv と有料 cpc の値の積として計算され、Google 検索の PPC 広告を通じて推定月間オーガニック トラフィックを獲得するコストを示します
この指標の計算方法の詳細についてはこちらのヘルプセンター記事をご覧ください"
},
"is_new": {
"type": [
"integer",
"null"
],
"description": "新たにランク付けされた要素の数\nこのドメインで新たに見つかったランク付け要素の数を示します",
"format": "int64"
},
"is_up": {
"type": [
"integer",
"null"
],
"description": "ランクの上昇\nこのドメインの Google 検索でのランクが上昇した要素の数を示します",
"format": "int64"
},
"is_down": {
"type": [
"integer",
"null"
],
"description": "ランクの下落\nこのドメインの Google 検索でのランクが下落した要素の数を示します",
"format": "int64"
},
"is_lost": {
"type": [
"integer",
"null"
],
"description": "失われたランク付け要素\nこのドメインが以前 SERP に表示されていたものの、前回のチェックで見つからなかったランク付け要素の数を示します",
"format": "int64"
}
}
}
```