DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ドメインページ
1 つの target のうち被リンクがあるページと、クローラーから見た各ページの情報:main_domain、domain、tld、page、ip、first_visited、prev_visited、fetch_time。どのページが実際にリンクを獲得しているかを見つけるのに使います。クロールメタデータではなくページ単位の被リンク数が必要な場合は、post_dataforseo_backlinks_domain_pages_summary_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 返してカウントする被リンクを設定します
任意フィールド
このフィールドを使用して、集計メトリクスに返して使用する被リンクを選択できます
指定可能な値:all- すべての被リンクを返してカウントしますlive- 最後のチェックで見つかった被リンクを返してカウントしますlost- 失われた被リンクを返してカウントしますデフォルト値:
live - exclude型: boolean | null
_internal _backlinks サブドメインから
targetへの内部被リンクを結果から除外するかどうかを示します
任意フィールドtrueに設定すると、targetと同じドメインのサブドメインからの内部被リンクのデータは結果に含まれませんfalseに設定すると、内部リンクが結果に含まれます
デフォルト値:true - filters型: array (object | null)[] | null
結果フィルタリングパラメータの配列
任意フィールド
複数のフィルターを同時に追加できます(最大 8 個)
条件の間に論理演算子and、orを設定します
次の演算子がサポートされています:regex,not_regex,=,<>,in,not_in,like,not_like,ilike,not_ilike,match,not_match%演算子をlike、not_likeと組み合わせて、0 文字以上の任意の文字列に一致させることができます
例:["meta.internal_links_count",">","1"][["meta.external_links_count",">","2"],
"and",
["backlinks",">","10"]][["first_visited",">","2017-10-23 11:31:45 +00:00"],
"and",
[["title","like","%seo%"],"or",["referring_domains",">","10"]]]空のオブジェクト - 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- 結果を降順で並び替えます
並び替えの種類はカンマで設定します
例:["page_summary.backlinks,desc"]
1 回のリクエストで設定できる並び替えルールは 3 つまでです
複数の並び替えルールはカンマで区切ります
例:["page_summary.backlinks,desc","page_summary.rank,asc"] - rank型: string | null
_scale - tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます - target型: string
ドメインまたはサブドメイン
必須フィールド
ドメインまたはサブドメインはhttps://とwww.を付けずに指定します
例:forbes.com
- 型: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト(USD)
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveTaskInfo
- 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
項目の配列
- content型: string | null
_encoding エンコーディングの種類
- domain型: string | null
ドメイン
ページが見つかったドメイン - encoded型: integer | null
_size エンコード後のページサイズ
エンコードされたページのサイズをバイト単位で示します - fetch型: string | null
_time クローラーがページに最後にアクセスした日時
UTC 形式:“yyyy-mm-dd hh-mm-ss +00:00”
例:2017-01-24 13:20:59 +00:00 - first型: string | null
_visited ページへの初回アクセス日時
クローラーがこのページに初めてアクセスした日時
UTC 形式:“yyyy-mm-dd hh-mm-ss +00:00”
例:2017-01-24 13:20:59 +00:00 - ip型: string | null
IP アドレス
- location型: string | null
Location ヘッダー
ページのリダイレクト先 URL が存在する場合に、その URL を示します - main型: string | null
_domain メインウェブサイトのドメイン
メインウェブサイトのドメインにはサブドメインは含まれません - media型: string | null
_type ページの表示に使用されるメディアの種類
- meta型: object | null · Response36Afe1097B20_BacklinksPageMeta
ページメタデータ
- canonical型: string | null
正規ページ
- charset型: string | null
文字エンコーディング
例:utf-8 - external型: integer | null 形式: int64
_links _count ページの外部リンク数
- h1型: array (string | null)[] | null
h1 タグ
h1タグの内容 - h2型: array (string | null)[] | null
h2 タグ
h2タグの内容 - h3型: array (string | null)[] | null
h3 タグ
h3タグの内容 - images型: array (string | null)[] | null
_alt altタグの内容 - images型: integer | null 形式: int64
_count ページの画像数
- internal型: integer | null 形式: int64
_links _count ページの内部リンク数
- language型: string | null
ページコンテンツの言語
例:en - page型: integer | null
_spam _score - platform型: array (string | null)[] | null
_type プラットフォームの種類
- powered型: array (string | null)[] | null
_by CMS の詳細
- social型: object | null
_media _tags - property型: string | null
Name
- technologies型: object | null
ウェブサイトの技術
- property型: string | null
Name
- title型: string | null
ページタイトル
- words型: integer | null 形式: int64
_count ページの単語数
- page型: string | null
ページ URL
関連ページの URL - page型: object | null · Response36Afe1097B20_PageSummary
_summary このページの被リンクデータを含みます
- backlinks型: integer | null 形式: int64
被リンク数を示します
- backlinks型: integer | null 形式: int64
_spam _score - broken型: integer | null 形式: int64
_backlinks 壊れた被リンク数
pageを指す壊れた被リンク数 - 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 - property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- referring型: object | null
_links _platform _types - 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 - property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- referring型: integer | null 形式: int64
_main _domains 参照メインドメイン数を示します
- referring型: integer | null 形式: int64
_main _domains _nofollow Signed 64-bit integers (long type).
- referring型: integer | null 形式: int64
_pages pageを指すページ数を示します - referring型: integer | null 形式: int64
_pages _nofollow pageに少なくとも 1 つの nofollow リンクを指している参照ページ数 - referring型: integer | null 形式: int64
_subnets 参照サブネットワーク数
- prev型: string | null
_visited クローラーがページに最後にアクセスする前の日時
UTC 形式:“yyyy-mm-dd hh-mm-ss +00:00”
例:2017-01-24 13:20:59 +00:00 - server型: string | null
サーバーバージョン
- size型: integer | null
ページサイズをバイト単位で示します
- status型: integer | null
_code 一般的なステータスコード
レスポンスコードの完全なリストはこちらで確認できます
注:関連する例外やエラー状態を処理するための必要なシステムを設計することを強くお勧めします - tld型: string | null
- type型: string | null
要素の種類
- items型: integer | null 形式: int64
_count items配列内の項目数 - target型: string | null
POST 配列の
target - 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/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "forbes.com",
"limit": 5,
"filters": [
[
"page_summary.backlinks",
">",
5
],
"and",
[
"page",
"like",
"%sites%"
]
]
}
]'
{
"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,
"main_domain": null,
"domain": null,
"tld": null,
"page": null,
"ip": null,
"first_visited": null,
"prev_visited": null,
"fetch_time": null,
"status_code": null,
"location": null,
"size": null,
"encoded_size": null,
"content_encoding": null,
"media_type": null,
"server": null,
"meta": {
"0": "[",
"1": "M",
"2": "a",
"3": "x",
"4": " ",
"5": "D",
"6": "e",
"7": "p",
"8": "t",
"9": "h",
"10": " ",
"11": "E",
"12": "x",
"13": "c",
"14": "e",
"15": "e",
"16": "d",
"17": "e",
"18": "d",
"19": "]",
"social_media_tags": "[Max Depth Exceeded]"
},
"page_summary": {
"0": "[",
"1": "M",
"2": "a",
"3": "x",
"4": " ",
"5": "D",
"6": "e",
"7": "p",
"8": "t",
"9": "h",
"10": " ",
"11": "E",
"12": "x",
"13": "c",
"14": "e",
"15": "e",
"16": "d",
"17": "e",
"18": "d",
"19": "]",
"referring_main_domains_nofollow": "[Max Depth Exceeded]",
"referring_links_tld": "[Max Depth Exceeded]",
"referring_links_types": "[Max Depth Exceeded]",
"referring_links_attributes": "[Max Depth Exceeded]",
"referring_links_platform_types": "[Max Depth Exceeded]",
"referring_links_semantic_locations": "[Max Depth Exceeded]",
"referring_links_countries": "[Max Depth Exceeded]"
}
}
]
}
]
}
]
}