DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
一括の新規・喪失参照ドメイン
date_from 以降の多数の targets の新規・喪失参照ドメイン。ターゲットごとに new_referring_domains、lost_referring_domains、new_referring_main_domains、lost_referring_main_domains を返します。サイトが本当に関係を増やしているかを判断するときは、post_dataforseo_backlinks_bulk_new_lost_backlinks_live よりこちらを優先してください。ドメインはリンクより入れ替わりが少ないためです。このエンドポイントは limit パラメータを受け付けないため、呼び出し頻度を下げることだけが調整手段です。
料金の参考情報
- 計量方式：レスポンスで報告されるコスト。
- 参考リクエスト見積もり：0.06 USD。
- 参考顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- date型: string | null
_from 期間の開始日
任意フィールド
このフィールドは、新規および失われた参照ドメインを判定するしきい値として使用する日付を示します
指定した日付より後に当社のインデックスに現れた参照ドメインは新規と見なされます
指定した日付より後に見つからなかったものの、それ以前に存在していた参照ドメインは失われたと見なされますデフォルト値: 今日の日付から 1 か月前
たとえば今日が2021-10-13の場合、デフォルトのdate_fromは2021-09-13になります
最小値は今日の日付から 1 年前です
たとえば今日が2021-10-13の場合、最小のdate_fromは2020-10-13になります日付形式:
"yyyy-mm-dd"
例:"2021-01-01" - tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます - targets型: array string[]
新規および失われた参照ドメインを取得するドメイン、サブドメイン、またはウェブページ
必須フィールド
最大 1000 個のドメイン、サブドメイン、ウェブページを設定できます
ドメインまたはサブドメインはhttps://とwww.を付けずに指定します
ページは絶対 URL（http://またはhttps://を含む）で指定します
例:"targets": [<br> "forbes.com",<br> "cnn.com",<br> "bbc.com",<br> "yelp.com",<br> "https://www.apple.com/iphone/",<br> "https://ahrefs.com/blog/",<br> "ibm.com",<br> "https://variety.com/",<br> "https://stackoverflow.com/",<br> "www.trustpilot.com"<br>]
- 型: object | null · Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveTaskInfo
- cost型: number | null 形式: double
タスクの総コスト（USD）
- data型: object | null
POST リクエストで指定したものと同じパラメーターを含みます
- property型: object | null
Name
- id型: string | null
タスク識別子 当社システム内で UUID 形式の一意のタスク識別子
- path型: array (string | null)[] | null
URL パス
- result型: array (object | null)[] | null
結果の配列
- items型: array (object | null)[] | null
関連する被リンクと参照ドメインのデータを含みます
- lost型: integer | null 形式: int64
_referring _domains 失われた参照ドメイン数
targetの失われた参照ドメイン数 - lost型: integer | null 形式: int64
_referring _main _domains targetを指す失われた参照メインドメイン数 - new型: integer | null 形式: int64
_referring _domains 新規参照ドメイン数
targetを指す新規参照ドメイン数 - new型: integer | null 形式: int64
_referring _main _domains targetを指す新規参照メインドメイン数 - target型: string | null
POST 配列のドメイン、サブドメイン、またはウェブページ
- items型: integer | null 形式: int64
_count items配列で返される結果の数
- result型: integer | null 形式: int64
_count result 配列内の要素数
- status型: integer | null
_code タスクのステータスコード DataForSEO によって生成され、次の範囲の値になります: 10000-60000 レスポンスコードの完全な一覧はこちらです
- status型: string | null
_message タスクの情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- time型: string | null
実行時間（秒）
- 型: integer | null 形式: int64tasks
_count tasks 配列内のタスク数
- 型: integer | null 形式: int64tasks
_error エラーで返された tasks 配列内のタスク数
- 型: string | nulltime
合計実行時間（秒）
- 型: string | nullversion
API の現在のバージョン
application/json - 400
リクエストを処理できませんでした。リクエストパラメータを確認してください。
- 401
有効な Felo API キーが必要です。
- 402
請求要件が満たされていないため、リクエストを続行できません。
- 403
このアカウントにはこの操作を行う権限がありません。
- 429
リクエストまたは支出の上限に達しました。
- 502
サービスがリクエストを完了できませんでした。
- 503
API または請求サービスが一時的に利用できません。
- 504
リクエストの処理中にサービスがタイムアウトしました。
- default
エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/bulk_new_lost_referring_domains/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"targets": [
"forbes.com",
"cnn.com",
"bbc.com",
"yelp.com",
"https://www.apple.com/iphone/",
"https://ahrefs.com/blog/",
"ibm.com",
"https://variety.com/",
"https://stackoverflow.com/",
"www.trustpilot.com"
],
"datetime_from": "2026-12-31"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"items_count": null,
"items": [
{
"target": null,
"new_referring_domains": null,
"lost_referring_domains": null,
"new_referring_main_domains": null,
"lost_referring_main_domains": null
}
]
}
]
}
]
}