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/backlinks/live

被リンク

1 つの target への個々の被リンク。リンクごとに 1 行です。total_count、items_count、items、およびページング用の search_after_token を返します。最初の数ページを超えたら、offset ではなくこのトークンを使用してください。mode と custom_mode がグループ化を制御し、backlinks_status_type がライブ、喪失、すべてを選択します。行ではなく件数が必要な場合は post_dataforseo_backlinks_summary_live、リンク元ドメインをグループ化して見る場合は post_dataforseo_backlinks_referring_domains_live を使用してください。

料金の参考情報

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

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

リクエストボディ

application/json

型: array (object | null)[]
- backlinks_status_type
  型: string | null
  
  返してカウントする被リンクを設定
  任意フィールド
  このフィールドを使用して、target に対して返し、集計メトリクスに使用する被リンクを選択できます；
  指定可能な値：
  all - すべての被リンクを返してカウントします；
  live - 最後のチェックで見つかった被リンクを返してカウントします；
  lost - 失われた被リンクを返してカウントします；
  
  デフォルト値：live
- custom_mode
  型: object | null
  
  詳細な結果のグループ化タイプ
  任意フィールド
  このオブジェクトを使用して、field ごとに指定した数の被リンクを取得します
  custom_mode を使用すると、mode は無視されます
  例:
  "custom_mode": {"field": "domain", "value": 100}
  
  propertyName
  型: object | null
- exclude_internal_backlinks
  型: boolean | null
  
  サブドメインから target への内部被リンクを結果から除外するかどうかを示します
  任意フィールド
  true に設定すると、target と同じドメインのサブドメインからの内部被リンクのデータは結果に含まれません
  false に設定すると、内部リンクが結果に含まれます
  デフォルト値: true
- filters
  型: array (object | null)[] | null
  
  結果フィルタリングパラメータの配列
  任意フィールド
  複数のフィルターを同時に追加できます（最大 8 個）
  条件の間に論理演算子 and、or を設定します
  次の演算子がサポートされています:
  =, <>, in, not_in, like, not_like, ilike, not_ilike, regex, not_regex, match, not_match
  % 演算子を like、not_like と組み合わせて、0 文字以上の任意の文字列に一致させることができます
  例:
  ["rank",">","80"]
  
  [["page_from_rank",">","55"], "and", ["dofollow","=",true]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["anchor","like","%seo%"],"or",["text_pre","like","%seo%"]]]
  
  使用可能なフィルターの完全な一覧はこちらをご覧ください。
  
  空のオブジェクト
- include_subdomains
  型: boolean | null
  
  target のサブドメインを検索に含めるかどうかを示します
  任意フィールド
  false に設定すると、サブドメインは無視されます
  デフォルト値: true
- limit
  型: integer | null
  
  返される被リンクの最大数
  任意フィールド
  
  デフォルト値: 100
  最大値: 1000
- mode
  型: string | null
  
  結果のグループ化タイプ
  任意フィールド
  指定可能なグループ化タイプ:
  as_is - すべての被リンクを返します
  one_per_domain - ドメインごとに 1 件の被リンクを返します
  one_per_anchor - アンカーごとに 1 件の被リンクを返します
  
  デフォルト値: as_is
- offset
  型: integer | null
  
  返される被リンクの結果配列内のオフセット
  任意フィールド
  
  デフォルト値: 0
  10 を指定すると、結果配列の最初の 10 件の被リンクがスキップされ、後続の被リンクのデータが返されます
  注意: 最大値は 20,000 です。さらに多くの結果をオフセットする場合は search_after_token を使用してください
- 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
  
  このパラメータの動作とランキング指標の計算方法については、こちらのヘルプセンターの記事をご覧ください
- search_after_token
  型: string | null
  
  後続のリクエスト用トークン
  任意フィールド
  各リクエストのレスポンスの対応するフィールドで提供されます
  このパラメータを使用すると、1 回のリクエストで 20,000 件を超える結果を取得する際のタイムアウトを回避できます
  レスポンス配列内の一意の search_after_token 値を指定すると、最初のタスクの後続の結果を取得できます
  search_after_token の値は後続のタスクごとに一意です
  注意: リクエストで search_after_token を指定する場合、他のすべてのパラメータは前のリクエストと同一である必要があります
- tag
  型: string | null
  
  ユーザー定義のタスク識別子
  任意フィールド
  文字数上限は 255 です
  このパラメーターを使ってタスクを識別し、結果と照合できます
  指定した tag の値は、レスポンスの data オブジェクトに含まれます
- target
  型: string
  
  被リンクを取得するドメイン、サブドメイン、またはウェブページ
  必須フィールド
  ドメインまたはサブドメインは https:// と www. を付けずに指定します
  ページは絶対 URL（http:// または https:// を含む）で指定します

レスポンス

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

タスクの総コスト（USD）

status_code
型: integer | null

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

status_message
型: string | null

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

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

タスクの配列

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

結果の配列

custom_mode
型: object | null

POST 配列で指定されたカスタムモード

propertyName
型: object | null
items
型: 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 に設定されている場合、このフィールドはこのドメインからの被リンクの総数を示します

image_url
型: string | null

画像の URL
元のリソースまたは DataForSEO ストレージ内の画像への URL（元のソースが利用できない場合）

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、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

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

ranked_keywords_info
型: object | null · Response36Afe1097B20_RankedKeywordsInfo
page_from_keywords_count_top_10
型: integer | null 形式: int64

Signed 64-bit integers (long type).

page_from_keywords_count_top_100
型: integer | null 形式: int64

Signed 64-bit integers (long type).

page_from_keywords_count_top_3
型: integer | null 形式: int64

Signed 64-bit integers (long type).

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

items_count
型: integer | null 形式: int64

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

mode
型: string | null

POST 配列で指定されたモード

search_after_token
型: string | null

後続のリクエスト用のトークン
新しいタスクを設定するときに一意の search_after_token を指定すると、最初のタスクの後続結果を取得できます；
search_after_token の値は後続のタスクごとに一意です

target
型: string | null

POST 配列のターゲットドメイン

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/backlinks/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/backlinks/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "mode": "as_is",
    "filters": [
      "dofollow",
      "=",
      true
    ],
    "limit": 5
  }
]'

スキーマを表示

{
  "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,
          "mode": null,
          "custom_mode": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "domain_from": null,
              "url_from": null,
              "url_from_https": null,
              "domain_to": null,
              "url_to": null,
              "url_to_https": null,
              "tld_from": null,
              "is_new": null,
              "is_lost": null,
              "backlink_spam_score": null,
              "rank": null,
              "page_from_rank": null,
              "domain_from_rank": null,
              "domain_from_platform_type": [
                "[Max Depth Exceeded]"
              ],
              "domain_from_is_ip": null,
              "domain_from_ip": null,
              "domain_from_country": null,
              "page_from_external_links": null,
              "page_from_internal_links": null,
              "page_from_size": null,
              "page_from_encoding": null,
              "page_from_language": null,
              "page_from_title": null,
              "page_from_status_code": null,
              "first_seen": null,
              "prev_seen": null,
              "last_seen": null,
              "item_type": null,
              "attributes": [
                "[Max Depth Exceeded]"
              ],
              "dofollow": null,
              "original": null,
              "alt": null,
              "image_url": null,
              "anchor": null,
              "text_pre": null,
              "text_post": null,
              "semantic_location": null,
              "links_count": null,
              "group_count": null,
              "is_broken": null,
              "url_to_status_code": null,
              "url_to_spam_score": null,
              "url_to_redirect_target": null,
              "ranked_keywords_info": "[Max Depth Exceeded]",
              "is_indirect_link": null,
              "indirect_link_path": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "search_after_token": null
        }
      ]
    }
  ]
}

操作成功

ヘルプが必要ですか？

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

被リンク

認証Required

DataForSEO

被リンク

料金の参考情報

ヘルプが必要ですか？