v0.2.0-beta

OpenAPI 3.1.0

Domain Perujuk

Felo API Support

MIT

Server

https://openapi.felo.ai

Pustaka Klien

Shell Curl

DataForSEO

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

DataForSEO Operasi

post/v1/beta/dataforseo/backlinks/referring_domains/live

Domain Perujuk

Domain yang menautkan ke satu target, satu baris per domain dengan domain, rank, backlinks, first_seen, lost_date, backlinks_spam_score, broken_backlinks, dan broken_pages. Domain perujuk lebih penting daripada jumlah backlink mentah, karena seribu tautan dari satu domain tetap satu relasi. Untuk tautan individual gunakan post_dataforseo_backlinks_backlinks_live; untuk merangkum lebih jauh ke operator jaringan, gunakan post_dataforseo_backlinks_referring_networks_live.

Referensi harga

Pengukuran: biaya respons yang dilaporkan.
Perkiraan referensi per permintaan: USD 0,0276.
Pengali referensi pelanggan: 1,0. Jangan menerapkannya lagi pada jumlah tagihan pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukan kredit Felo. Biaya akhir mengikuti catatan penagihan Felo.

Isi

application/json

Tipe: array (object | null)[]
- backlinks_filters
  Tipe: array (object | null)[] | null
  
  memfilter backlink dari target Anda
  field opsional
  Anda dapat menggunakan field ini untuk memfilter backlink awal yang akan disertakan dalam kumpulan data untuk metrik agregat target Anda
  Anda dapat memfilter backlink berdasarkan semua field yang tersedia dalam respons endpoint ini
  dengan parameter ini, Anda dapat menyertakan hanya backlink dofollow dalam respons dan membuat kumpulan data backlink yang fleksibel untuk menghitung metrik
  contoh:
  "backlinks_filters": ["dofollow", "=", true]
  
  Objek kosong
- backlinks_status_type
  Tipe: string | null
  
  tentukan backlink mana yang dikembalikan dan dihitung
  field opsional
  Anda dapat menggunakan field ini untuk memilih backlink mana yang akan dikembalikan dan digunakan untuk metrik teragregasi target Anda;
  nilai yang mungkin:
  all - semua backlink akan dikembalikan dan dihitung;
  live - backlink yang ditemukan selama pemeriksaan terakhir akan dikembalikan dan dihitung;
  lost - backlink yang hilang akan dikembalikan dan dihitung;
  
  nilai default: live
- exclude_internal_backlinks
  Tipe: boolean | null
  
  menunjukkan apakah backlink dari subdomain target dikecualikan
  field opsional
  jika ditetapkan ke false, backlink dari subdomain target akan dilewati dan Anda tidak akan menerima domain yang sama dalam respons;
  nilai default: true
- filters
  Tipe: array (object | null)[] | null
  
  array parameter pemfilteran hasil
  field opsional
  Anda dapat menambahkan beberapa filter sekaligus (maksimum 8 filter)
  Anda harus menyetel operator logika and, or di antara kondisi
  operator berikut didukung:
  regex, not_regex, =, <>, in, not_in, like, not_like, match, not_match
  Anda dapat menggunakan operator % dengan like dan not_like untuk mencocokkan string apa pun dengan nol atau lebih karakter
  contoh:
  ["referring_pages",">","1"]
  
  [["referring_pages",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["domain","like","%dataforseo.com%"],"or",["referring_domains",">","10"]]]
  
  Daftar lengkap filter yang tersedia dapat dilihat di sini.
  
  Objek kosong
- include_indirect_links
  Tipe: boolean | null
  
  menunjukkan apakah tautan tidak langsung ke target akan disertakan dalam hasil
  field opsional
  jika ditetapkan ke true, hasil akan menyertakan data tentang tautan tidak langsung yang mengarah ke halaman yang mengalihkan ke target, atau mengarah ke halaman kanonis
  jika ditetapkan ke false, tautan tidak langsung akan diabaikan
  nilai default: true
- include_subdomains
  Tipe: boolean | null
  
  menunjukkan apakah subdomain dari target akan disertakan dalam pencarian
  field opsional
  jika disetel ke false, subdomain akan diabaikan
  nilai default: true
- internal_list_limit
  Tipe: integer | null
  
  jumlah maksimum elemen dalam array internal
  field opsional
  Anda dapat menggunakan field ini untuk membatasi jumlah elemen dalam array berikut:
  referring_links_tld
  referring_links_types
  referring_links_attributes
  referring_links_platform_types
  referring_links_semantic_locations
  
  nilai default: 10
  nilai maksimum: 1000
- limit
  Tipe: integer | null
  
  jumlah maksimum domain yang dikembalikan
  field opsional
  nilai default: 100
  nilai maksimum: 1000
- offset
  Tipe: integer | null
  
  offset dalam array hasil domain yang dikembalikan
  field opsional
  nilai default: 0
  jika Anda menentukan nilai 10, sepuluh domain pertama dalam array hasil akan dilewati dan data akan disediakan untuk halaman berikutnya
- order_by
  Tipe: array string[] | null
  
  aturan pengurutan hasil
  field opsional
  Anda dapat menggunakan nilai yang sama seperti dalam array filters untuk mengurutkan hasil
  jenis pengurutan yang tersedia:
  asc - hasil akan diurutkan dalam urutan menaik
  desc - hasil akan diurutkan dalam urutan menurun
  Anda harus menggunakan koma untuk menyetel jenis pengurutan
  contoh:
  ["backlinks,desc"]
  perhatikan bahwa Anda tidak dapat menyetel lebih dari tiga aturan pengurutan dalam satu permintaan
  Anda harus menggunakan koma untuk memisahkan beberapa aturan pengurutan
  contoh:
  ["backlinks,desc","rank,asc"]
- rank_scale
  Tipe: string | null
  
  menentukan skala yang digunakan untuk menghitung dan menampilkan nilai rank, domain_from_rank, dan page_from_rank
  field opsional
  
  Anda dapat menggunakan parameter ini untuk memilih apakah nilai rank disajikan pada skala 0–100 atau 0–1000
  
  nilai yang tersedia:
  one_hundred — nilai rank ditampilkan pada skala 0–100
  one_thousand — nilai rank ditampilkan pada skala 0–1000
  
  nilai default: one_thousand
  
  pelajari lebih lanjut tentang cara parameter ini bekerja dan cara metrik peringkat dihitung dalam artikel Pusat Bantuan ini
- tag
  Tipe: string | null
  
  pengenal tugas yang ditentukan pengguna
  field opsional
  batas karakter adalah 255
  Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
  Anda akan menemukan nilai tag yang ditentukan di objek data pada respons
- target
  Tipe: string
  
  domain, subdomain, atau halaman web untuk mendapatkan domain perujuk
  field wajib
  domain atau subdomain harus ditentukan tanpa https:// dan www.
  halaman harus ditentukan dengan URL absolut (termasuk http:// atau https://)

Respons

200
Tipe: object | null · Response36Afe1097B20_BacklinksReferringDomainsLiveResponseInfo
cost
Tipe: number | null Format: double

total biaya tugas, USD

status_code
Tipe: integer | null

kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

status_message
Tipe: string | null

pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

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

array tugas

Tipe: object | null · Response36Afe1097B20_BacklinksReferringDomainsLiveTaskInfo
cost
Tipe: number | null Format: double

total biaya tugas, USD

data
Tipe: object | null

berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

propertyName
Tipe: object | null
id
Tipe: string | null

pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

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

Jalur URL

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

array hasil

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

array items

backlinks
Tipe: integer | null Format: int64

menunjukkan jumlah backlink yang menunjuk ke target

backlinks_spam_score
Tipe: integer | null Format: int64

skor spam rata-rata semua backlink yang menunjuk ke domain
pelajari lebih lanjut tentang cara metrik dihitung di halaman pusat bantuan ini

broken_backlinks
Tipe: integer | null Format: int64

jumlah backlink rusak
jumlah backlink rusak yang menunjuk ke domain

broken_pages
Tipe: integer | null

jumlah halaman rusak
jumlah halaman yang merespons dengan kode status 4xx atau 5xx tempat backlink menunjuk

domain
Tipe: string | null

domain perujuk

first_seen
Tipe: string | null

tanggal dan waktu saat perayap kami pertama kali menemukan backlink
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2019-11-15 12:57:46 +00:00

lost_date
Tipe: string | null

tanggal dan waktu saat backlink terakhir dari domain ini hilang
menunjukkan tanggal dan waktu saat perayap kami mengunjungi halaman dan halaman merespons dengan kode status 4xx atau 5xx, atau saat backlink terakhir dihapus
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2017-01-24 13:20:59 +00:00

rank
Tipe: integer | null

peringkat domain
volume peringkat yang diteruskan situs web perujuk ke target
rank dihitung berdasarkan metode pemeringkatan node dalam basis data bertautan - prinsip yang digunakan dalam algoritma Google PageRank asli
pelajari lebih lanjut tentang metrik dan cara perhitungannya di artikel pusat bantuan ini

referring_domains
Tipe: integer | null Format: int64

menunjukkan jumlah domain perujuk
perhatikan bahwa kami menghitung domain utama (domain akar, seperti example.com) dan subdomainnya (mis. blog.example.com) secara terpisah untuk metrik ini

referring_domains_nofollow
Tipe: integer | null Format: int64

jumlah domain yang menunjuk setidaknya satu tautan nofollow ke target

referring_ips
Tipe: integer | null Format: int64

jumlah alamat IP perujuk
jumlah alamat IP yang menunjuk ke halaman ini

referring_links_attributes
Tipe: object | null

atribut tautan dari tautan perujuk
menunjukkan atribut tautan dari tautan perujuk dan jumlah tautan untuk setiap atribut

propertyName
Tipe: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_countries
Tipe: object | null

kode negara ISO dari tautan perujuk
menunjukkan kode negara ISO dari domain tempat tautan perujuk berada dan jumlah tautan per negara

propertyName
Tipe: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_platform_types
Tipe: object | null

jenis platform perujuk
menunjukkan jenis platform perujuk dan jumlah tautan per platform

nilai yang mungkin: cms, blogs, ecommerce, message-boards, wikis, news, organization

propertyName
Tipe: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
Tipe: object | null

lokasi semantik dari tautan perujuk
menunjukkan elemen semantik dalam HTML tempat tautan perujuk berada dan jumlah tautan untuk setiap lokasi semantik

Anda dapat melihat daftar lengkap elemen semantik di sini
contoh:
article, section, summary

propertyName
Tipe: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_tld
Tipe: object | null

domain tingkat atas dari tautan perujuk
berisi domain tingkat atas dan jumlah tautan perujuk untuk masing-masing

propertyName
Tipe: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_types
Tipe: object | null

jenis tautan perujuk
menunjukkan jenis tautan perujuk dan jumlah tautan untuk setiap jenis
nilai yang mungkin:
anchor, image, link, meta, canonical, alternate, redirect

propertyName
Tipe: integer | null Format: int64

Signed 64-bit integers (long type).

referring_main_domains
Tipe: integer | null Format: int64

menunjukkan jumlah domain utama perujuk
jumlah domain utama (akar) yang merujuk ke target Anda

referring_main_domains_nofollow
Tipe: integer | null Format: int64

jumlah domain utama yang menunjuk setidaknya satu tautan nofollow ke target

referring_pages
Tipe: integer | null Format: int64

menunjukkan jumlah halaman yang menunjuk ke target yang ditentukan

referring_pages_nofollow
Tipe: integer | null Format: int64

jumlah halaman perujuk yang menunjuk setidaknya satu tautan nofollow ke target

referring_subnets
Tipe: integer | null Format: int64

jumlah subjaringan perujuk

type
Tipe: string | null

jenis elemen

items_count
Tipe: integer | null Format: int64

jumlah item dalam array items

target
Tipe: string | null

target dalam array POST

total_count
Tipe: integer | null Format: int64

jumlah total item relevan dalam basis data
jumlah total domain utama yang merujuk ke target Anda;
example.com dan blog.example.com dihitung sebagai satu domain perujuk

result_count
Tipe: integer | null Format: int64

jumlah elemen dalam array hasil

status_code
Tipe: integer | null

kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

status_message
Tipe: string | null

pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

time
Tipe: string | null

waktu eksekusi, detik

tasks_count
Tipe: integer | null Format: int64

jumlah tugas dalam array tasks

tasks_error
Tipe: integer | null Format: int64

jumlah tugas dalam array tasks yang dikembalikan dengan error

time
Tipe: string | null

total waktu eksekusi, detik

version
Tipe: string | null

versi API saat ini
application/json
400

Permintaan tidak dapat diproses. Periksa parameter permintaan.
401

Kunci API Felo yang valid diperlukan.
402

Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.
403

Akun tidak diizinkan melakukan operasi ini.
429

Batas permintaan atau batas pengeluaran telah tercapai.
502

Layanan tidak dapat menyelesaikan permintaan.
503

API atau layanan penagihan untuk sementara tidak tersedia.
504

Layanan kehabisan waktu saat memproses permintaan.
default

Respons error; respons passthrough upstream dapat menggunakan format penyedia

application/json

post/v1/beta/dataforseo/backlinks/referring_domains/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/referring_domains/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "backlinko.com",
    "limit": 5,
    "order_by": [
      "rank,desc"
    ],
    "exclude_internal_backlinks": true,
    "backlinks_filters": [
      "dofollow",
      "=",
      true
    ],
    "filters": [
      "backlinks",
      ">",
      100
    ]
  }
]'

Tampilkan Skema

{
  "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,
              "domain": 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
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Domain Perujuk

AutentikasiRequired

DataForSEO

Domain Perujuk

Referensi harga