v0.2.0-beta

OpenAPI 3.1.0

Irisan Domain

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

Irisan Domain

Domain yang menautkan ke beberapa target sekaligus. ⚠️ targets di sini adalah objek berkunci posisi - {"1": "a.com", "2": "b.com"} - bukan array seperti yang diterima endpoint massal. exclude_targets menghapus situs dari perbandingan. Setiap baris membawa domain_intersection dan summary per target. Gunakan untuk menemukan siapa yang menautkan ke kompetitor Anda tetapi tidak ke Anda. Padanan tingkat halaman adalah post_dataforseo_backlinks_page_intersection_live.

Referensi harga

Pengukuran: biaya respons yang dilaporkan.
Perkiraan referensi per permintaan: USD 0,06.
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
 
 menetapkan backlink mana yang akan dikembalikan dan dihitung
 field opsional
 Anda dapat menggunakan field ini untuk memilih backlink mana yang akan dikembalikan dan digunakan untuk metrik agregat targets;
 nilai yang tersedia:
 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 disetel ke false, backlink dari subdomain target akan dilewati dan Anda tidak akan menerima domain yang sama dalam respons;
 nilai default: true
- exclude_targets
 Tipe: array string[] | null
 
 domain, subdomain, atau halaman web yang ingin Anda kecualikan
 field opsional
 Anda dapat menentukan hingga 10 domain, subdomain, atau halaman web
 jika Anda menggunakan array ini, hasil akan berisi domain perujuk yang menautkan ke targets tetapi tidak menautkan ke exclude_targets
 contoh:
 "exclude_targets": [ "bbc.com", "https://www.apple.com/iphone/*", "https://dataforseo.com/apis/*"]
- 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, ilike, not_ilike, match, not_match
 Anda dapat menggunakan operator % dengan like dan not_like untuk mencocokkan string apa pun dengan nol atau lebih karakter
 contoh:
 ["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"]]]
 
 Daftar lengkap filter yang tersedia dapat dilihat di sini.
 
 Objek kosong
- include_indirect_links
 Tipe: boolean | null
 
 menunjukkan apakah tautan tidak langsung ke targets akan disertakan dalam hasil
 field opsional
 jika disetel ke true, hasil akan menyertakan data tentang tautan tidak langsung yang mengarah ke halaman yang mengalihkan ke target, atau mengarah ke halaman kanonis
 jika disetel 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
- intersection_mode
 Tipe: string | null
 
 menunjukkan apakah backlink akan diinterseksi
 field opsional
 gunakan field ini untuk menginterseksi atau menggabungkan hasil untuk domain yang ditentukan
 nilai yang tersedia: all, partial
 all - hasil didasarkan pada semua backlink;
 partial - hasil hanya didasarkan pada backlink yang beririsan;
 nilai default: all
- limit
 Tipe: integer | null
 
 jumlah maksimum hasil yang dikembalikan
 field opsional
 nilai default: 100
 nilai maksimum: 1000
- offset
 Tipe: integer | null
 
 offset dalam array hasil yang dikembalikan
 field opsional
 nilai default: 0
 jika Anda menentukan nilai 10, sepuluh backlink pertama dalam array hasil akan dilewati dan data akan disediakan untuk backlink 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
- targets
 Tipe: object | null
 
 domain, subdomain, atau halaman web untuk mendapatkan tautan
 field wajib
 Anda dapat menetapkan hingga 20 domain, subdomain, atau halaman web
 domain atau subdomain harus ditentukan tanpa https:// dan www.
 halaman harus ditentukan dengan URL absolut (termasuk http:// atau https://)
 contoh:
 "targets": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }
 
 propertyName
 Tipe: string | null

Respons

200
Tipe: object | null · Response36Afe1097B20_BacklinksDomainIntersectionLiveResponseInfo
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_BacklinksDomainIntersectionLiveTaskInfo
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

berisi domain yang menautkan ke semua targets dari array POST

domain_intersection
Tipe: object | null

berisi data tentang domain yang menautkan ke target terkait yang ditentukan dalam array POST
data disediakan dalam objek terpisah yang sesuai dengan domain, subdomain, atau halaman yang ditentukan dalam objek targets

propertyName
Tipe: object | null · Response36Afe1097B20_BacklinksDomainIntersection
backlinks
Tipe: integer | null Format: int64

menunjukkan jumlah backlink

backlinks_spam_score
Tipe: integer | null Format: int64

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

broken_backlinks
Tipe: integer | null Format: int64

jumlah backlink rusak

broken_pages
Tipe: integer | null

jumlah halaman rusak

first_seen
Tipe: string | null

tanggal dan waktu saat perayap kami pertama kali menemukan backlink dari target ini
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 target 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:
2019-11-15 12:57:46 +00:00

rank
Tipe: integer | null

peringkat yang dirujuk ke target dari array POST
menunjukkan peringkat yang dirujuk domain perujuk (target di atas) ke target Anda dari array POST;
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

jumlah domain perujuk

referring_domains_nofollow
Tipe: integer | null Format: int64

jumlah domain yang menunjuk setidaknya satu tautan nofollow ke target terkait

referring_ips
Tipe: integer | null Format: int64

jumlah alamat IP perujuk

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

Integer numbers.

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

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

Integer numbers.

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

propertyName
Tipe: integer | null

Integer numbers.

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

Integer numbers.

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

Integer numbers.

referring_main_domains
Tipe: integer | null Format: int64

jumlah domain utama perujuk

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

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

target
Tipe: string | null

domain yang menautkan ke target terkait dari array POST

type
Tipe: string | null

jenis elemen

summary
Tipe: object | null · Response36Afe1097B20_IntersectionSummaryInfo

berisi ringkasan irisan domain

intersections_count
Tipe: integer | null Format: int64

total jumlah irisan

items_count
Tipe: integer | null Format: int64

jumlah hasil yang dikembalikan dalam array items

targets
Tipe: object | null

domain target, subdomain, atau halaman web dalam array POST

propertyName
Tipe: string | null
total_count
Tipe: integer | null Format: int64

jumlah total hasil yang relevan dengan permintaan Anda

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/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
  }
]'

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

Operasi berhasil

Irisan Domain

AutentikasiRequired

DataForSEO

Irisan Domain

Referensi harga