DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ドメインページサマリー
1 つの target のページ単位の被リンク指標。url ごとに 1 行で、rank、backlinks、first_seen、lost_date、backlinks_spam_score、broken_backlinks、broken_pages を含みます。post_dataforseo_backlinks_summary_live のページ単位版で、後者はドメイン全体について同じ指標を返します。代わりにこれらのページのクロールメタデータが必要な場合は、post_dataforseo_backlinks_domain_pages_live を使用してください。
料金の参考情報
- 計量方式：レスポンスで報告されるコスト。
- 参考リクエスト見積もり：0.0276 USD。
- 参考顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- backlinks型: array (object | null)[] | null
_filters targetの被リンクをフィルタリング
任意フィールド
このフィールドを使用して、targetの集計メトリクス用データセットに含める初期被リンクをフィルタリングできます
被リンクはこのエンドポイントのレスポンスで利用可能なすべてのフィールドでフィルタリングできます
このパラメーターを使用すると、レスポンスに dofollow の被リンクのみを含め、指標計算用の柔軟な被リンクデータセットを作成できます
例："backlinks_filters": [["dofollow", "=", true]]空のオブジェクト - backlinks型: string | null
_status _type 返してカウントする被リンクを設定
任意フィールド
このフィールドを使用して、targetに対して返し、集計メトリクスに使用する被リンクを選択できます；
指定可能な値：all- すべての被リンクを返してカウントします；live- 最後のチェックで見つかった被リンクを返してカウントします；lost- 失われた被リンクを返してカウントします；デフォルト値：
live - exclude型: boolean | null
_internal _backlinks targetのサブドメインからの被リンクを除外するかどうかを示します
任意フィールドfalseに設定すると、targetドメインのサブドメインからの被リンクは除外され、レスポンスに同じドメインは含まれません
デフォルト値:true - filters型: array (object | null)[] | null
結果フィルターパラメーターの配列
任意フィールド
複数のフィルターを同時に追加できます（最大 8 個）
条件の間には論理演算子and、orを設定してください
次の演算子がサポートされています：regex、not_regex、=、<>、in、not_in、like、not_like、ilike、not_ilike、match、not_matchlikeとnot_likeで%演算子を使用すると、0 文字以上の任意の文字列に一致させられます
例：["referring_links_types.anchors",">","1"][["broken_pages",">","2"],
"and",
["backlinks",">","10"]][["first_seen",">","2017-10-23 11:31:45 +00:00"],
"and",
[["anchor","like","%seo%"],"or",["referring_domains",">","10"]]]使用可能なフィルターの完全なリストはこちらで確認できます。
空のオブジェクト - include型: boolean | null
_indirect _links targetへの間接リンクを結果に含めるかどうかを示します
任意フィールドtrueに設定すると、結果には、target にリダイレクトするページまたは正規ページを指すページへの間接リンクのデータが含まれますfalseに設定すると、間接リンクは無視されます
デフォルト値：true - include型: boolean | null
_subdomains targetドメインのサブドメインを検索に含めるかどうかを示します
任意フィールドfalseに設定すると、サブドメインは無視されます
デフォルト値:true - internal型: integer | null
_list _limit 内部配列内の要素の最大数
任意フィールド
このフィールドを使用して、次の配列内の要素数を制限できます:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locationsデフォルト値:
10
最大値:1000 - limit型: integer | null
返されるアンカーの最大数
任意フィールド
デフォルト値:100
最大値:1000 - offset型: integer | null
返されるアンカーの結果配列内のオフセット
任意フィールド
デフォルト値:010を指定すると、結果配列の最初の 10 件のアンカーがスキップされ、後続のアンカーのデータが返されます - order型: array string[] | null
_by 結果の並び替えルール
任意フィールドfilters配列と同じ値を使用して結果を並び替えられます
指定可能な並び替えの種類:asc- 結果を昇順で並び替えますdesc- 結果を降順で並び替えます
並び替えの種類はカンマで設定します
例:["backlinks,desc"]
1 回のリクエストで設定できる並び替えルールは 3 つまでです
複数の並び替えルールはカンマで区切ります
例:["backlinks,desc","rank,asc"] - rank型: string | null
_scale - tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます - target型: string
サマリーデータを取得するドメイン、サブドメイン、またはウェブページ
必須フィールド
ドメインまたはサブドメインはhttps://とwww.を付けずに指定します
ページは絶対 URL（http://またはhttps://を含む）で指定します
- 型: object | null · Response36Afe1097B20_BacklinksDomainPagesSummaryLiveResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_BacklinksDomainPagesSummaryLiveTaskInfo
- 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
項目の配列
- backlinks型: integer | null 形式: int64
被リンク数
- backlinks型: integer | null 形式: int64
_spam _score - broken型: integer | null 形式: int64
_backlinks 壊れた被リンク数
このページを指す壊れた被リンクの数 - broken型: integer | null
_pages 壊れたページ数
被リンクが指している、4xx または 5xx ステータスコードを返すページの数 - first型: string | null
_seen クローラーがこのページへの被リンクを初めて検出した日時
UTC 形式："yyyy-mm-dd hh-mm-ss +00:00"
例:2019-11-15 12:57:46 +00:00 - lost型: string | null
_date このページへの最後の被リンクが失われた日時
クローラーがページにアクセスし、4xx または 5xx ステータスコードが返されたとき、または最後の被リンクが削除された日時を示します
UTC 形式："yyyy-mm-dd hh-mm-ss +00:00"
例:2017-01-24 13:20:59 +00:00 - rank型: integer | null
- referring型: integer | null 形式: int64
_domains ページを参照しているドメイン数を示します
- referring型: integer | null 形式: int64
_domains _nofollow pageに少なくとも 1 つの nofollow リンクを指しているドメイン数 - referring型: integer | null 形式: int64
_ips 参照 IP アドレス数
このページを指す IP アドレスの数 - referring型: object | null
_links _attributes 参照リンクのリンク属性
参照リンクのリンク属性と、属性ごとのリンク数を示します- property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- referring型: object | null
_links _countries 参照リンクの ISO 国コード
参照リンクが配置されているドメインの ISO 国コードと、国ごとのリンク数を示します- property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- referring型: object | null
_links _platform _types 参照プラットフォームの種類
参照プラットフォームの種類と、プラットフォームごとのリンク数を示します指定可能な値:
cms、blogs、ecommerce、message-boards、wikis、news、organization- property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- referring型: object | null
_links _semantic _locations - property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- referring型: object | null
_links _tld 参照リンクのトップレベルドメイン
トップレベルドメインと、それぞれの参照リンク数を含みます- property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- referring型: object | null
_links _types 参照リンクの種類
参照リンクの種類と、種類ごとのリンク数を示します
指定可能な値:anchor、image、link、meta、canonical、alternate、redirect- property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- referring型: integer | null 形式: int64
_main _domains 参照メインドメイン数を示します
- referring型: integer | null 形式: int64
_main _domains _nofollow pageに少なくとも 1 つの nofollow リンクを指しているメインドメイン数 - referring型: integer | null 形式: int64
_pages 関連する
urlを指すページ数を示します - referring型: integer | null 形式: int64
_pages _nofollow pageに少なくとも 1 つの nofollow リンクを指している参照ページ数 - referring型: integer | null 形式: int64
_subnets 参照サブネットワーク数
- type型: string | null
要素の種類
- url型: string | null
ページ URL
- items型: integer | null 形式: int64
_count 結果配列内の項目数
- target型: string | null
POST 配列のターゲット
- total型: integer | null 形式: int64
_count データベース内の関連項目の総数
- 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/domain_pages_summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "forbes.com",
"limit": 4,
"order_by": [
"backlinks,desc"
]
}
]'
{
"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,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"url": null,
"rank": null,
"backlinks": null,
"first_seen": null,
"lost_date": null,
"backlinks_spam_score": null,
"broken_backlinks": null,
"broken_pages": null,
"referring_domains": null,
"referring_domains_nofollow": null,
"referring_main_domains": null,
"referring_main_domains_nofollow": null,
"referring_ips": null,
"referring_subnets": null,
"referring_pages": null,
"referring_pages_nofollow": null,
"referring_links_tld": null,
"referring_links_types": null,
"referring_links_attributes": null,
"referring_links_platform_types": null,
"referring_links_semantic_locations": null,
"referring_links_countries": null
}
]
}
]
}
]
}