DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
被リンク時系列サマリー
1 つの target の主要な被リンク指標の推移を、group_range（日、週、月）でグループ化して返します。date_from、date_to、group_range と各期間の項目を返します。合計ではなく増減が必要な場合は post_dataforseo_backlinks_timeseries_new_lost_live を使用してください。このエンドポイントは limit パラメータを受け付けないため、呼び出し頻度を下げることだけが調整手段です。
料金の参考情報
- 計量方式：レスポンスで報告されるコスト。
- 参考リクエスト見積もり：0.0273 USD。
- 参考顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- date型: string | null
_from 期間の開始日
任意フィールド
このフィールドは、サマリーデータを判定するしきい値として使用する日付を示します最小値:
2019-01-30
最大値はdate_toで指定した日付を超えることはできません
日付形式:"yyyy-mm-dd"
例:"2021-01-01" - date型: string | null
_to 期間の終了日
任意フィールド
このフィールドを指定しない場合、今日の日付がデフォルトで使用されます
最小値はdate_fromで指定した日付より前にはできません
最大値: 今日の日付
日付形式:"yyyy-mm-dd"
例:"2021-01-15" - group型: string | null
_range 結果のグループ化に使用する期間
任意フィールド
デフォルト値:month
指定可能な値:day、week、month、year注意:
dayの場合、date_fromとdate_toの間（両端を含む）のすべての日付に対応する項目を返しますweek/month/yearの場合、完全な週/月/年に対応する項目を返し、各項目はその週/月/年の最終日を示しますたとえば、次のように指定すると:
"group_range": "month",
"date_from": "2022-03-23",
"date_to": "2022-05-13"
2022-03-01 から 2022-05-31 までの項目、つまり2022-03-31、2022-04-30、2022-05-31の 3 つの日付に対応する項目を返します特定の
day/week/month/yearのデータがない場合は0を返します - include型: boolean | null
_subdomains targetのサブドメインを検索に含めるかどうかを示します
任意フィールドfalseに設定すると、サブドメインは無視されます
デフォルト値:true - rank型: string | null
_scale - tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます - target型: string
データを取得するドメイン
必須フィールド
ドメインはhttps://とwww.を付けずに指定します
例:"forbes.com"
- 型: object | null · Response36Afe1097B20_BacklinksTimeseriesSummaryLiveResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_BacklinksTimeseriesSummaryLiveTaskInfo
- 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
結果の配列
- date型: string | null
_from 期間の開始日
UTC 形式：“yyyy-mm-dd”
例:2019-01-01 - date型: string | null
_to 期間の終了日
UTC 形式："yyyy-mm-dd"
例:"2019-01-15" - group型: string | null
_range POST 配列の group_range
- items型: array (object | null)[] | null
関連するサマリーデータを含みます
- backlinks型: integer | null 形式: int64
指定された
dateの被リンク数 - backlinks型: integer | null 形式: int64
_nofollow 指定された
dateの nofollow 被リンク数 - date型: string | null
ターゲットのデータが保存された日時
UTC 形式："yyyy-mm-dd hh-mm-ss +00:00"
例:2019-11-15 12:57:46 +00:00 - rank型: integer | null
- referring型: integer | null 形式: int64
_domains 指定された
dateの参照ドメイン数
この指標では、参照ドメインに別個のドメインとしてカウントされるサブドメインが含まれます - referring型: integer | null 形式: int64
_domains _nofollow 指定された
dateにtargetへ少なくとも 1 つの nofollow リンクを指しているドメイン数 - referring型: integer | null 形式: int64
_ips 指定された
dateの参照 IP アドレス数
このページを指す IP アドレスの数 - referring型: integer | null 形式: int64
_main _domains 指定された
dateの参照メインドメイン数 - referring型: integer | null 形式: int64
_main _domains _nofollow 指定された
dateにtargetへ少なくとも 1 つの nofollow リンクを指しているメインドメイン数 - referring型: integer | null 形式: int64
_pages 指定された
dateにtargetを指すページ数 - referring型: integer | null 形式: int64
_pages _nofollow 指定された
dateにtargetへ少なくとも 1 つの nofollow リンクを指している参照ページ数 - referring型: integer | null 形式: int64
_subnets 指定された
dateの参照サブネットワーク数 - type型: string | null
要素の種類
- items型: integer | null 形式: int64
_count items配列で返される結果の数 - target型: string | null
POST 配列の
target
- 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/timeseries_summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"date_from": "2021-12-01",
"date_to": "2022-02-01",
"group_range": "month"
}
]'
{
"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": [
{
"target": null,
"date_from": null,
"date_to": null,
"group_range": null,
"items_count": null,
"items": [
{
"type": null,
"date": null,
"rank": null,
"backlinks": null,
"backlinks_nofollow": null,
"referring_pages": null,
"referring_pages_nofollow": null,
"referring_domains": null,
"referring_domains_nofollow": null,
"referring_main_domains": null,
"referring_main_domains_nofollow": null,
"referring_ips": null,
"referring_subnets": null
}
]
}
]
}
]
}