v0.2.0-beta

OpenAPI 3.1.0

ドメインインターセクション

Felo API Support

MIT

サーバー

https://openapi.felo.ai

クライアントライブラリ

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO 操作

post/v1/beta/dataforseo/backlinks/domain_intersection/live

ドメインインターセクション

複数のターゲットに同時にリンクしているドメイン。⚠️ ここでの targets は位置をキーとするオブジェクト（{"1": "a.com", "2": "b.com"}）であり、一括エンドポイントが受け取る配列ではありません。exclude_targets は比較からサイトを除外します。各行には domain_intersection とターゲットごとの summary が含まれます。競合他社にはリンクしているが自分にはリンクしていないサイトを見つけるのに使います。ページ単位の相当エンドポイントは post_dataforseo_backlinks_page_intersection_live です。

料金の参考情報

計量方式：レスポンスで報告されるコスト。
参考リクエスト見積もり：0.06 USD。
参考顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。

参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。

リクエストボディ

application/json

型: array (object | null)[]
- backlinks_filters
 型: array (object | null)[] | null
 
 target の被リンクをフィルタリングします
 任意フィールド
 このフィールドを使用して、target の集計メトリクス用データセットに含める初期被リンクをフィルタリングできます
 このエンドポイントのレスポンスで利用可能なすべてのフィールドで被リンクをフィルタリングできます
 このパラメータを使用すると、レスポンスに dofollow の被リンクのみを含め、指標を計算するための柔軟な被リンクデータセットを作成できます
 例:
 "backlinks_filters": [["dofollow", "=", true]]
 
 空のオブジェクト
- backlinks_status_type
 型: string | null
 
 返してカウントする被リンクを設定します
 任意フィールド
 このフィールドを使用して、targets の集計メトリクスに返して使用する被リンクを選択できます
 指定可能な値:
 all - すべての被リンクを返してカウントします
 live - 最後のチェックで見つかった被リンクを返してカウントします
 lost - 失われた被リンクを返してカウントします
 
 デフォルト値: live
- exclude_internal_backlinks
 型: boolean | null
 
 target のサブドメインからの被リンクを除外するかどうかを示します
 任意フィールド
 false に設定すると、target のサブドメインからの被リンクは除外され、レスポンスに同じドメインは含まれません
 デフォルト値: true
- exclude_targets
 型: array string[] | null
 
 除外するドメイン、サブドメイン、またはウェブページ
 任意フィールド
 最大 10 個のドメイン、サブドメイン、ウェブページを指定できます
 この配列を使用すると、結果には targets にリンクしているものの exclude_targets にはリンクしていない参照ドメインが含まれます
 例:
 "exclude_targets": [ "bbc.com", "https://www.apple.com/iphone/*", "https://dataforseo.com/apis/*"]
- 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 文字以上の任意の文字列に一致させることができます
 例:
 ["1.internal_links_count",">","1"]
 
 [["2.referring_pages",">","2"], "and", ["1.backlinks",">","10"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["2.target","like","%dataforseo.com%"],"or",["1.referring_domains",">","10"]]]
 
 使用可能なフィルターの完全な一覧はこちらをご覧ください。
 
 空のオブジェクト
- include_indirect_links
 型: boolean | null
 
 targets への間接リンクを結果に含めるかどうかを示します
 任意フィールド
 true に設定すると、結果には、ターゲットにリダイレクトするページまたは正規ページを指すページへの間接リンクのデータが含まれます
 false に設定すると、間接リンクは無視されます
 デフォルト値: true
- include_subdomains
 型: boolean | null
 
 target のサブドメインを検索に含めるかどうかを示します
 任意フィールド
 false に設定すると、サブドメインは無視されます
 デフォルト値: true
- internal_list_limit
 型: integer | null
 
 内部配列内の要素の最大数
 任意フィールド
 このフィールドを使用して、次の配列内の要素数を制限できます:
 referring_links_tld
 referring_links_types
 referring_links_attributes
 referring_links_platform_types
 referring_links_semantic_locations
 
 デフォルト値: 10
 最大値: 1000
- intersection_mode
 型: string | null
 
 被リンクの積集合を取るかどうかを示します
 任意フィールド
 このフィールドを使用して、指定したドメインの結果の積集合を取るか統合するかを指定します
 指定可能な値: all、partial
 all - すべての被リンクに基づく結果
 partial - 積集合の被リンクのみに基づく結果
 デフォルト値: all
- limit
 型: integer | null
 
 返される結果の最大数
 任意フィールド
 デフォルト値: 100
 最大値: 1000
- offset
 型: integer | null
 
 返される結果配列内のオフセット
 任意フィールド
 デフォルト値: 0
 10 を指定すると、結果配列の最初の 10 件の被リンクがスキップされ、後続の被リンクのデータが返されます
- order_by
 型: array string[] | null
 
 結果の並び替えルール
 任意フィールド
 filters 配列と同じ値を使用して結果を並び替えられます
 指定可能な並び替えの種類:
 asc - 結果を昇順で並び替えます
 desc - 結果を降順で並び替えます
 並び替えの種類はカンマで設定します
 例:
 ["backlinks,desc"]
 1 回のリクエストで設定できる並び替えルールは 3 つまでです
 複数の並び替えルールはカンマで区切ります
 例:
 ["backlinks,desc","rank,asc"]
- rank_scale
 型: string | null
 
 rank、domain_from_rank、page_from_rank の値を計算・表示する際のスケールを定義します
 任意フィールド
 
 このパラメータを使用して、rank 値を 0〜100 と 0〜1000 のどちらのスケールで表示するかを選択できます
 
 指定可能な値:
 one_hundred — rank 値は 0〜100 のスケールで表示されます
 one_thousand — rank 値は 0〜1000 のスケールで表示されます
 
 デフォルト値: one_thousand
 
 このパラメータの動作とランキング指標の計算方法については、こちらのヘルプセンターの記事をご覧ください
- tag
 型: string | null
 
 ユーザー定義のタスク識別子
 任意フィールド
 文字数上限は 255 です
 このパラメーターを使ってタスクを識別し、結果と照合できます
 指定した tag の値は、レスポンスの data オブジェクトに含まれます
- targets
 型: object | null
 
 リンクを取得するドメイン、サブドメイン、またはウェブページ
 必須フィールド
 最大 20 個のドメイン、サブドメイン、ウェブページを設定できます
 ドメインまたはサブドメインは https:// と www. を付けずに指定します
 ページは絶対 URL（http:// または https:// を含む）で指定します
 例:
 "targets": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }
 
 propertyName
 型: string | null

レスポンス

200
型: object | null · Response36Afe1097B20_BacklinksDomainIntersectionLiveResponseInfo
cost
型: number | null 形式: double

タスクの総コスト（USD）

status_code
型: integer | null

一般的なステータスコードレスポンスコードの完全な一覧はこちらです

status_message
型: string | null

一般的な情報メッセージ一般的な情報メッセージの完全な一覧はこちらです

tasks
型: array (object | null)[] | null

タスクの配列

型: object | null · Response36Afe1097B20_BacklinksDomainIntersectionLiveTaskInfo
cost
型: number | null 形式: double

タスクの総コスト（USD）

data
型: object | null

POST リクエストで指定したものと同じパラメーターを含みます

propertyName
型: object | null
id
型: string | null

タスク識別子当社システム内で UUID 形式の一意のタスク識別子

path
型: array (string | null)[] | null

URL パス

result
型: array (object | null)[] | null

結果の配列

items
型: array (object | null)[] | null

POST 配列のすべての targets にリンクしているドメインを含みます

domain_intersection
型: object | null

POST 配列で指定されたターゲットにリンクしているデータを含みます
データは、targets オブジェクトで指定されたドメイン、サブドメイン、またはページに対応する個別のオブジェクトで提供されます

propertyName
型: object | null · Response36Afe1097B20_BacklinksDomainIntersection
backlinks
型: integer | null 形式: int64

被リンク数を示します

backlinks_spam_score
型: integer | null 形式: int64

target を指す被リンクの平均スパムスコア
この指標の計算方法の詳細については、こちらのヘルプセンターのページを参照してください

broken_backlinks
型: integer | null 形式: int64

壊れた被リンク数

broken_pages
型: integer | null

壊れたページ数

first_seen
型: string | null

クローラーがこの target からの被リンクを初めて検出した日時
UTC 形式：“yyyy-mm-dd hh-mm-ss +00:00”
例:
2019-11-15 12:57:46 +00:00

lost_date
型: string | null

この target からの最後の被リンクが失われた日時
クローラーがページにアクセスし、4xx または 5xx ステータスコードが返されたとき、または最後の被リンクが削除された日時を示します
UTC 形式：“yyyy-mm-dd hh-mm-ss +00:00”
例:
2019-11-15 12:57:46 +00:00

rank
型: integer | null

POST 配列の target から参照されているランク
参照ドメイン（上記の target）が POST 配列のターゲットに渡すランクを示します；
rank は、リンクデータベースにおけるノードランキングの手法に基づいて計算されます。これは元の Google PageRank アルゴリズムで採用された原則です
この指標と計算方法の詳細については、こちらのヘルプセンター記事を参照してください

referring_domains
型: integer | null 形式: int64

参照ドメイン数

referring_domains_nofollow
型: integer | null 形式: int64

対応するターゲットに少なくとも 1 つの nofollow リンクを指しているドメイン数

referring_ips
型: integer | null 形式: int64

参照 IP アドレス数

referring_links_attributes
型: object | null

参照リンクのリンク属性
参照リンクのリンク属性と、属性ごとのリンク数を示します

propertyName
型: integer | null

Integer numbers.

referring_links_countries
型: object | null

参照リンクの ISO 国コード
参照リンクが配置されているドメインの ISO 国コードと、国ごとのリンク数を示します

referring_links_platform_types
型: object | null

参照プラットフォームの種類
参照プラットフォームの種類と、プラットフォームごとのリンク数を示します

指定可能な値: cms、blogs、ecommerce、message-boards、wikis、news、organization

propertyName
型: integer | null

Integer numbers.

referring_links_semantic_locations
型: object | null

参照リンクのセマンティックロケーション
参照リンクが配置されている HTML のセマンティック要素と、セマンティックロケーションごとのリンク数を示します
セマンティック要素の完全な一覧はこちらで確認できます

propertyName
型: integer | null

Integer numbers.

referring_links_tld
型: object | null

参照リンクのトップレベルドメイン
トップレベルドメインと、それぞれの参照リンク数を含みます

propertyName
型: integer | null

Integer numbers.

referring_links_types
型: object | null

参照リンクのタイプ
参照リンクのタイプと、タイプごとのリンク数を示します
指定可能な値:
anchor、image、link、meta、canonical、alternate、redirect

propertyName
型: integer | null

Integer numbers.

referring_main_domains
型: integer | null 形式: int64

参照メインドメイン数

referring_main_domains_nofollow
型: integer | null 形式: int64

target に少なくとも 1 つの nofollow リンクを指しているメインドメイン数

referring_pages
型: integer | null 形式: int64

target を指すページ数を示します

referring_pages_nofollow
型: integer | null 形式: int64

target に少なくとも 1 つの nofollow リンクを指している参照ページ数

referring_subnets
型: integer | null 形式: int64

参照サブネットワーク数

target
型: string | null

POST 配列の対応するターゲットにリンクしているドメイン

type
型: string | null

要素の種類

summary
型: object | null · Response36Afe1097B20_IntersectionSummaryInfo

ドメイン交差のサマリーを含みます

intersections_count
型: integer | null 形式: int64

交差の総数

items_count
型: integer | null 形式: int64

items 配列で返される結果の数

targets
型: object | null

POST 配列のターゲットドメイン、サブドメイン、またはウェブページ

propertyName
型: string | null
total_count
型: integer | null 形式: int64

リクエストに関連する結果の総数

result_count
型: integer | null 形式: int64

result 配列内の要素数

status_code
型: integer | null

タスクのステータスコード DataForSEO によって生成され、次の範囲の値になります: 10000-60000 レスポンスコードの完全な一覧はこちらです

status_message
型: string | null

タスクの情報メッセージ一般的な情報メッセージの完全な一覧はこちらです

time
型: string | null

実行時間（秒）

tasks_count
型: integer | null 形式: int64

tasks 配列内のタスク数

tasks_error
型: integer | null 形式: int64

エラーで返された tasks 配列内のタスク数

time
型: string | null

合計実行時間（秒）

version
型: string | null

API の現在のバージョン
application/json
400

リクエストを処理できませんでした。リクエストパラメータを確認してください。
401

有効な Felo API キーが必要です。
402

請求要件が満たされていないため、リクエストを続行できません。
403

このアカウントにはこの操作を行う権限がありません。
429

リクエストまたは支出の上限に達しました。
502

サービスがリクエストを完了できませんでした。
503

API または請求サービスが一時的に利用できません。
504

リクエストの処理中にサービスがタイムアウトしました。
default

エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります

application/json

post/v1/beta/dataforseo/backlinks/domain_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "moz.com",
      "2": "ahrefs.com"
    },
    "include_subdomains": false,
    "exclude_targets": [
      "semrush.com"
    ],
    "limit": 5,
    "order_by": [
      "1.backlinks,desc"
    ],
    "exclude_internal_backlinks": true
  }
]'

スキーマを表示

{
  "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": [
        {
          "targets": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "domain_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

操作成功

ヘルプが必要ですか？

API・請求・アカウントのご質問はサポートへ。
Discord で Felo の開発者と交流できます。
更新履歴をご覧ください。
ボリューム価格や購買についてのご相談は営業窓口へ。
LLM での構築をお考えですか？llms.txt をご覧ください。

ドメインインターセクション

認証Required

DataForSEO

ドメインインターセクション

料金の参考情報

ヘルプが必要ですか？