Felo API PlatformFelo API Platform
DataForSEO のエンドポイント一覧
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 操作

ページインターセクション

​

複数のターゲット URL に同時にリンクしているページ（ドメインではありません）。⚠️ targets は位置をキーとするオブジェクトで、裸のドメインではなく完全な URL を受け取ります。各行には page_intersection とターゲットごとの summary が含まれます。ドメイン単位の相当エンドポイントは post_dataforseo_backlinks_domain_intersection_live で、まずこちらを使用してください。

料金の参考情報

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

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

リクエストボディ
application/json
  • 型: array (object | null)[]
    • backlinks_status_type
      型: string | null

      返してカウントする被リンクを設定します
      任意フィールド
      このフィールドを使用して、targets の集計メトリクスに返して使用する被リンクを選択できます
      指定可能な値:
      all - すべての被リンクを返してカウントします
      live - 最後のチェックで見つかった被リンクを返してカウントします
      lost - 失われた被リンクを返してカウントします

      デフォルト値: live

    • exclude_internal_backlinks
      型: boolean | null

      サブドメインから target への内部被リンクを結果から除外するかどうかを示します
      任意フィールド
      true に設定すると、target と同じドメインのサブドメインからの内部被リンクのデータは結果に含まれません
      false に設定すると、内部リンクが結果に含まれます
      デフォルト値: true

    • exclude_targets
      型: array string[] | null

      除外するドメイン、サブドメイン、またはウェブページ
      任意フィールド
      最大 10 個のドメイン、サブドメイン、ウェブページを設定できます
      この配列を使用すると、結果には targets にリンクしているものの exclude_targets にはリンクしていない参照ページが含まれます
      例:
      "exclude_targets": [<br>"bbc.com",<br>"https://www.apple.com/iphone/*",<br>"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.rank",">","80"]

      [["2.page_from_rank",">","55"],
      "and",
      ["1.original","=","true"]]

      [["1.first_seen",">","2017-10-23 11:31:45 +00:00"],
      "and",
      [["1.acnhor","like","%seo%"],"or",["1.text_pre","not_like","%seo%"]]]

      使用可能なフィルターの完全な一覧はこちらをご覧ください。

      空のオブジェクト
    • include_indirect_links
      型: boolean | null

      targets への間接リンクを結果に含めるかどうかを示します
      任意フィールド
      true に設定すると、結果には、ターゲットにリダイレクトするページまたは正規ページを指すページへの間接リンクのデータが含まれます
      false に設定すると、間接リンクは無視されます
      デフォルト値: true

    • include_subdomains
      型: boolean | null

      targets のサブドメインを検索に含めるかどうかを示します
      任意フィールド
      false に設定すると、サブドメインは無視されます
      デフォルト値: true

    • internal_list_limit
      型: integer | null

      内部配列内の要素の最大数
      任意フィールド
      このフィールドを使用して、次の配列内の要素数を制限できます:
      attributes
      domain_from_platform_type

      デフォルト値: 10
      最大値: 1000

    • intersection_mode
      型: string | null

      被リンクの積集合を取るかどうかを示します
      任意フィールド
      このフィールドを使用して、指定した URL の結果の積集合を取るか統合するかを指定します
      指定可能な値: all、partial
      all - すべての被リンクに基づく結果
      partial - 積集合の被リンクのみに基づく結果
      デフォルト値: all

    • limit
      型: integer | null

      返される被リンクの最大数
      任意フィールド

      デフォルト値: 100
      最大値: 1000

    • offset
      型: integer | null

      返される被リンクの結果配列内のオフセット
      任意フィールド

      デフォルト値: 0
      10 を指定すると、結果配列の最初の 10 件の被リンクがスキップされ、後続の被リンクのデータが返されます

    • order_by
      型: array string[] | null

      結果の並び替えルール
      任意フィールド
      filters 配列と同じ値を使用して結果を並び替えられます
      指定可能な並び替えの種類:
      asc - 結果を昇順で並び替えます
      desc - 結果を降順で並び替えます
      並び替えの種類はカンマで設定します
      例:
      ["rank,desc"]
      1 回のリクエストで設定できる並び替えルールは 3 つまでです
      複数の並び替えルールはカンマで区切ります
      例:
      ["domain_from_rank,desc","page_from_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": {<br>"1": "http://planet.postgresql.org/",<br>"2": "http://gborg.postgresql.org/"<br>}

      • propertyName
        型: string | null
レスポンス
  • 200
    型: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo
    • cost
      型: number | null 形式: double

      タスクの総コスト（USD）

    • status_code
      型: integer | null

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

    • status_message
      型: string | null

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

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

      タスクの配列

      • 型: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveTaskInfo
        • 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

            関連する被リンクと参照ドメインのデータを含みます

            • page_intersection
              型: object | null

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

              • propertyName
                型: array (object | null)[] | null
                • alt
                  型: string | null

                  画像の代替テキスト
                  被リンクの type が image でない場合、このフィールドは null になります

                • anchor
                  型: string | null

                  被リンクのアンカーテキスト

                • attributes
                  型: array (string | null)[] | null

                  参照リンクのリンク属性
                  例:
                  nofollow

                • backlink_spam_score
                  型: integer | null

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

                • dofollow
                  型: boolean | null

                  被リンクが dofollow かどうかを示します
                  false の場合、その被リンクは nofollow です

                • domain_from
                  型: string | null

                  ターゲットドメインまたはウェブページを参照しているドメイン

                • domain_from_country
                  型: string | null

                  参照ドメインの ISO 国コード

                • domain_from_ip
                  型: string | null

                  参照ドメインの IP アドレス

                • domain_from_is_ip
                  型: boolean | null

                  そのドメインが IP かどうかを示します
                  true の場合、そのドメインは IP アドレスとして機能し、ドメイン名を持ちません

                • domain_from_platform_type
                  型: array (string | null)[] | null

                  参照ドメインのプラットフォームタイプ

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

                • domain_from_rank
                  型: integer | null

                  参照ドメインのドメインランク
                  クローラーが最後にその被リンクを確認した時点のドメインランクを示します；
                  domain_from_rank は、リンクデータベースにおけるノードランキングの手法に基づいて計算されます。これは元の Google PageRank アルゴリズムで採用された原則です
                  この指標と計算方法の詳細については、こちらのヘルプセンター記事を参照してください

                • domain_to
                  型: string | null

                  被リンクが指しているドメイン

                • first_seen
                  型: string | null

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

                • group_count
                  型: integer | null 形式: int64

                  このドメインからの被リンクの総数を示します
                  たとえば、mode が one_per_domain に設定されている場合、このフィールドはこのドメインからの被リンクの総数を示します

                • indirect_link_path
                  型: array (object | null)[] | null

                  間接リンクパス
                  url_to に至る 1 つの URL または一連の URL を示します

                  • status_code
                    型: integer | null

                    一般的なステータスコード
                    レスポンスコードの完全なリストはこちらで確認できます
                    注：関連する例外やエラー状態を処理するための必要なシステムを設計することを強くお勧めします

                  • type
                    型: string | null

                    要素の種類

                  • url
                    型: string | null

                    間接リンク URL

                • is_broken
                  型: boolean | null

                  被リンクが壊れているかどうかを示します
                  true の場合、その被リンクは 4xx または 5xx ステータスコードを返すページを指しています

                • is_indirect_link
                  型: boolean | null

                  被リンクが間接リンクかどうかを示します
                  true の場合、その被リンクは、url_to にリダイレクトするページ、または正規ページを指す間接リンクです

                • is_lost
                  型: boolean | null

                  被リンクが削除されたかどうかを示します
                  true の場合、その被リンクまたはページ全体が削除されています

                • is_new
                  型: boolean | null

                  被リンクが新規かどうかを示します
                  true の場合、その被リンクはクローラーが前回ページにアクセスしたときに検出されたものです

                • item_type
                  型: string | null

                  リンクタイプ
                  指定可能な値:
                  anchor、image、link、meta、canonical、alternate、redirect

                • last_seen
                  型: string | null

                  クローラーが被リンクに最後にアクセスした日時
                  UTC 形式：“yyyy-mm-dd hh-mm-ss +00:00”
                  例:
                  2019-11-15 12:57:46 +00:00

                • links_count
                  型: integer | null 形式: int64

                  参照ページで見つかった同一の被リンク数

                • original
                  型: boolean | null

                  クローラーが最初にアクセスしたときに被リンクが参照ページに存在していたかどうかを示します

                • page_from_encoding
                  型: string | null

                  参照ページの文字エンコーディング
                  例:
                  utf-8

                • page_from_external_links
                  型: integer | null

                  参照ページで見つかった外部リンク数

                • page_from_internal_links
                  型: integer | null

                  参照ページで見つかった内部リンク数

                • page_from_language
                  型: string | null

                  参照ページの言語
                  ISO 639-1 形式
                  例:
                  en

                • page_from_rank
                  型: integer | null

                  参照ページのページランク
                  page_from_rank は、リンクデータベースにおけるノードランキングの手法に基づいて計算されます。これは元の Google PageRank アルゴリズムで採用された原則です
                  この指標と計算方法の詳細については、こちらのヘルプセンター記事を参照してください

                • page_from_size
                  型: integer | null

                  参照ページのサイズ（バイト単位）
                  例:
                  63357

                • page_from_status_code
                  型: integer | null

                  参照ページが返す HTTP ステータスコード
                  例:
                  200

                • page_from_title
                  型: string | null

                  参照ページのタイトル

                • prev_seen
                  型: string | null

                  クローラーが被リンクに最後にアクセスする前の日時
                  UTC 形式：“yyyy-mm-dd hh-mm-ss +00:00”
                  例:
                  2019-11-15 12:57:46 +00:00

                • rank
                  型: integer | null

                  被リンクのランク
                  rank は、リンクデータベースにおけるノードランキングの手法に基づいて計算されます。これは元の Google PageRank アルゴリズムで採用された原則です
                  この指標と計算方法の詳細については、こちらのヘルプセンター記事を参照してください

                • semantic_location
                  型: string | null

                  被リンクが見つかった HTML のセマンティック要素を示します
                  セマンティック要素の完全な一覧はこちらで確認できます
                  例:
                  article、section、summary

                • text_post
                  型: string | null

                  アンカーテキストの後のスニペット

                • text_pre
                  型: string | null

                  アンカーテキストの前のテキストスニペット

                • tld_from
                  型: string | null

                  参照 URL のトップレベルドメイン

                • type
                  型: string | null

                  要素の種類

                • url_from
                  型: string | null

                  被リンクが見つかったページの URL

                • url_from_https
                  型: boolean | null

                  参照 URL が HTTPS で保護されているかどうかを示します
                  true の場合、その参照 URL は HTTPS で保護されています

                • url_to
                  型: string | null

                  被リンクが指している URL

                • url_to_https
                  型: boolean | null

                  被リンクが指している URL が HTTPS で保護されているかどうかを示します
                  true の場合、その URL は HTTPS で保護されています

                • url_to_redirect_target
                  型: string | null

                  リダイレクト先の URL
                  リダイレクトが指しているターゲットページ

                • url_to_spam_score
                  型: integer | null

                  参照先ページのスパムスコア
                  値が null の場合、クローラーはリンク先のウェブページにまだアクセスしていません
                  この指標の計算方法の詳細については、こちらのヘルプセンターのページを参照してください

                • url_to_status_code
                  型: integer | null

                  参照先ページのステータスコード
                  値が null の場合、クローラーはリンク先のウェブページにまだアクセスしていません
                  例:
                  200

            • summary
              型: object | null · Response36Afe1097B20_IntersectionSummaryInfo

              ページ交差のサマリーを含みます

              • intersections_count
                型: integer | null 形式: int64

                交差の総数

          • items_count
            型: integer | null 形式: int64

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

          • targets
            型: object | null

            POST 配列の targets

            • 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
Request Example for post/v1/beta/dataforseo/backlinks/page_intersection/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/page_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "football.com",
      "2": "fifa.com"
    },
    "exclude_targets": [
      "skysports.com"
    ],
    "limit": 5,
    "order_by": [
      "1.rank,desc"
    ],
    "filters": [
      [
        "2.domain_from_rank",
        ">",
        400
      ],
      "and",
      [
        "1.dofollow",
        "=",
        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": [
            {
              "page_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

操作成功

Page Intersection

ヘルプが必要ですか？

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