DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Irisan Halaman
Halaman yang menautkan ke beberapa URL target sekaligus, bukan domainnya. ⚠️ targets adalah objek berkunci posisi dan menerima URL lengkap, bukan domain telanjang. Setiap baris membawa page_intersection dan summary per target. Padanan tingkat domain adalah post_dataforseo_backlinks_domain_intersection_live, yang sebaiknya dicoba lebih dulu.
Referensi harga
- Pengukuran: biaya respons yang dilaporkan.
- Perkiraan referensi per permintaan: USD 0,033.
- 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.
- Tipe: array (object | null)[]
- backlinksTipe: string | null
_status _type 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 agregattargets;
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 - excludeTipe: boolean | null
_internal _backlinks menunjukkan apakah backlink internal dari subdomain ke
targetakan dikecualikan dari hasil
field opsional
jika disetel ketrue, hasil tidak akan menyertakan data tentang backlink internal dari subdomain domain yang sama dengantarget
jika disetel kefalse, tautan internal akan disertakan dalam hasil
nilai default:true - excludeTipe: array string[] | null
_targets domain, subdomain, atau halaman web yang ingin Anda kecualikan
field opsional
Anda dapat menetapkan hingga 10 domain, subdomain, atau halaman web
jika Anda menggunakan array ini, hasil akan berisi halaman perujuk yang menautkan ketargetstetapi tidak menautkan keexclude_targets
contoh:"exclude_targets": [<br>"bbc.com",<br>"https://www.apple.com/iphone/*",<br>"https://dataforseo.com/apis/*"] - filtersTipe: array (object | null)[] | null
array parameter pemfilteran hasil
field opsional
Anda dapat menambahkan beberapa filter sekaligus (maksimum 8 filter)
Anda harus menyetel operator logikaand,ordi antara kondisi
operator berikut didukung:regex,not_regex,=,<>,in,not_in,like,not_like,ilike,not_ilike,match,not_match
Anda dapat menggunakan operator%denganlikedannot_likeuntuk mencocokkan string apa pun dengan nol atau lebih karakter
contoh:["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%"]]]Objek kosong - includeTipe: boolean | null
_indirect _links menunjukkan apakah tautan tidak langsung ke
targetsakan disertakan dalam hasil
field opsional
jika disetel ketrue, hasil akan menyertakan data tentang tautan tidak langsung yang mengarah ke halaman yang mengalihkan ke target, atau mengarah ke halaman kanonis
jika disetel kefalse, tautan tidak langsung akan diabaikan
nilai default:true - includeTipe: boolean | null
_subdomains menunjukkan apakah subdomain dari
targetsakan disertakan dalam pencarian
field opsional
jika disetel kefalse, subdomain akan diabaikan
nilai default:true - internalTipe: integer | null
_list _limit jumlah maksimum elemen dalam array internal
field opsional
Anda dapat menggunakan field ini untuk membatasi jumlah elemen dalam array berikut:attributesdomain_from_platform_typenilai default:
10
nilai maksimum:1000 - intersectionTipe: string | null
_mode menunjukkan apakah backlink akan diinterseksi
field opsional
gunakan field ini untuk menginterseksi atau menggabungkan hasil untuk URL yang ditentukan
nilai yang tersedia:all,partialall- hasil didasarkan pada semua backlink;partial- hasil hanya didasarkan pada backlink yang beririsan;
nilai default:all - limitTipe: integer | null
jumlah maksimum backlink yang dikembalikan
field opsionalnilai default:
100
nilai maksimum:1000 - offsetTipe: integer | null
offset dalam array hasil backlink yang dikembalikan
field opsionalnilai default:
0
jika Anda menentukan nilai10, sepuluh backlink pertama dalam array hasil akan dilewati dan data akan disediakan untuk backlink berikutnya - orderTipe: array string[] | null
_by aturan pengurutan hasil
field opsional
Anda dapat menggunakan nilai yang sama seperti dalam arrayfiltersuntuk mengurutkan hasil
jenis pengurutan yang tersedia:asc- hasil akan diurutkan dalam urutan menaikdesc- hasil akan diurutkan dalam urutan menurun
Anda harus menggunakan koma untuk menyetel jenis pengurutan
contoh:["rank,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:["domain_from_rank,desc","page_from_rank,asc"] - rankTipe: string | null
_scale menentukan skala yang digunakan untuk menghitung dan menampilkan nilai
rank,domain_from_rank, danpage_from_rank
field opsionalAnda 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–100one_thousand— nilai rank ditampilkan pada skala 0–1000nilai default:
one_thousandpelajari lebih lanjut tentang cara parameter ini bekerja dan cara metrik peringkat dihitung dalam artikel Pusat Bantuan ini
- tagTipe: 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 nilaitagyang ditentukan di objekdatapada respons - targetsTipe: 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 tanpahttps://danwww.
halaman harus ditentukan dengan URL absolut (termasukhttp://atauhttps://)
contoh:"targets": {<br>"1": "http://planet.postgresql.org/",<br>"2": "http://gborg.postgresql.org/"<br>}- propertyTipe: string | null
Name
- Tipe: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo200
- Tipe: number | null Format: doublecost
total biaya tugas, USD
- Tipe: integer | nullstatus
_code kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini
- Tipe: string | nullstatus
_message pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini
- Tipe: array (object | null)[] | nulltasks
array tugas
- Tipe: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveTaskInfo
- costTipe: number | null Format: double
total biaya tugas, USD
- dataTipe: object | null
berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST
- propertyTipe: object | null
Name
- idTipe: string | null
pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID
- pathTipe: array (string | null)[] | null
Jalur URL
- resultTipe: array (object | null)[] | null
array hasil
- itemsTipe: array (object | null)[] | null
berisi data backlink dan domain perujuk yang relevan
- pageTipe: object | null
_intersection berisi data tentang halaman yang menautkan ke target terkait yang ditentukan dalam array POST
data disediakan dalam objek terpisah yang sesuai dengan halaman yang ditentukan dalam objektargets- propertyTipe: array (object | null)[] | null
Name - altTipe: string | null
teks alternatif gambar
field ini akan bernilainulljikatypebacklink bukan image - anchorTipe: string | null
teks anchor backlink
- attributesTipe: array (string | null)[] | null
atribut tautan dari tautan perujuk
contoh:nofollow - backlinkTipe: integer | null
_spam _score - dofollowTipe: boolean | null
menunjukkan apakah backlink bersifat dofollow
jikafalse, backlink bersifat nofollow - domainTipe: string | null
_from domain yang merujuk ke domain atau halaman web target
- domainTipe: string | null
_from _country kode negara ISO domain perujuk
- domainTipe: string | null
_from _ip alamat IP domain perujuk
- domainTipe: boolean | null
_from _is _ip menunjukkan apakah domain berupa IP
jikatrue, domain berfungsi sebagai alamat IP dan tidak memiliki nama domain - domainTipe: array (string | null)[] | null
_from _platform _type jenis platform domain perujuk
nilai yang mungkin:
cms,blogs,ecommerce,message-boards,wikis,news,organization - domainTipe: integer | null
_from _rank peringkat domain dari domain perujuk
menunjukkan peringkat domain saat perayap kami terakhir melihat backlink;domain_from_rankdihitung 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 - domainTipe: string | null
_to domain yang dituju backlink
- firstTipe: string | null
_seen 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 - groupTipe: integer | null Format: int64
_count menunjukkan jumlah total backlink dari domain ini
sebagai contoh, jikamodedisetel keone_per_domain, field ini akan menunjukkan jumlah total backlink yang berasal dari domain ini - indirectTipe: array (object | null)[] | null
_link _path jalur tautan tidak langsung
menunjukkan URL atau urutan URL yang mengarah keurl_to- statusTipe: integer | null
_code kode status umum
Anda dapat menemukan daftar lengkap kode respons di sini
Catatan: kami sangat menyarankan merancang sistem yang diperlukan untuk menangani kondisi pengecualian atau kesalahan terkait - typeTipe: string | null
jenis elemen
- urlTipe: string | null
URL tautan tidak langsung
- isTipe: boolean | null
_broken menunjukkan apakah backlink rusak
jikatrue, backlink menunjuk ke halaman yang merespons dengan kode status 4xx atau 5xx - isTipe: boolean | null
_indirect _link menunjukkan apakah backlink merupakan tautan tidak langsung
jikatrue, backlink adalah tautan tidak langsung yang menunjuk ke halaman yang mengalihkan keurl_to, atau menunjuk ke halaman kanonis - isTipe: boolean | null
_lost menunjukkan apakah backlink telah dihapus
jikatrue, backlink atau seluruh halaman telah dihapus - isTipe: boolean | null
_new menunjukkan apakah backlink baru
jikatrue, backlink ditemukan di halaman saat perayap kami terakhir mengunjunginya - itemTipe: string | null
_type jenis tautan
nilai yang mungkin:anchor,image,link,meta,canonical,alternate,redirect - lastTipe: string | null
_seen tanggal terbaru saat perayap kami mengunjungi backlink
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:2019-11-15 12:57:46 +00:00 - linksTipe: integer | null Format: int64
_count jumlah backlink identik yang ditemukan di halaman perujuk
- originalTipe: boolean | null
menunjukkan apakah backlink ada di halaman perujuk saat perayap kami pertama kali mengunjunginya
- pageTipe: string | null
_from _encoding pengodean karakter halaman perujuk
contoh:utf-8 - pageTipe: integer | null
_from _external _links jumlah tautan eksternal yang ditemukan di halaman perujuk
- pageTipe: integer | null
_from _internal _links jumlah tautan internal yang ditemukan di halaman perujuk
- pageTipe: string | null
_from _language bahasa halaman perujuk
dalam format ISO 639-1
contoh:en - pageTipe: integer | null
_from _rank - pageTipe: integer | null
_from _size ukuran halaman perujuk, dalam byte
contoh:63357 - pageTipe: integer | null
_from _status _code kode status HTTP yang dikembalikan halaman perujuk
contoh:200 - pageTipe: string | null
_from _title judul halaman perujuk
- prevTipe: string | null
_seen tanggal sebelum kunjungan terbaru perayap kami ke backlink
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:2019-11-15 12:57:46 +00:00 - rankTipe: integer | null
- semanticTipe: string | null
_location - textTipe: string | null
_post cuplikan setelah teks anchor
- textTipe: string | null
_pre cuplikan teks sebelum teks anchor
- tldTipe: string | null
_from domain tingkat atas dari URL perujuk
- typeTipe: string | null
jenis elemen
- urlTipe: string | null
_from URL halaman tempat backlink ditemukan
- urlTipe: boolean | null
_from _https menunjukkan apakah URL perujuk diamankan dengan HTTPS
jikatrue, URL perujuk diamankan dengan HTTPS - urlTipe: string | null
_to URL yang dituju backlink
- urlTipe: boolean | null
_to _https menunjukkan apakah URL yang dituju backlink diamankan dengan HTTPS
jikatrue, URL diamankan dengan HTTPS - urlTipe: string | null
_to _redirect _target URL target pengalihan
halaman target yang dituju pengalihan - urlTipe: integer | null
_to _spam _score - urlTipe: integer | null
_to _status _code kode status halaman yang dirujuk
jika nilainyanull, perayap kami belum mengunjungi halaman web yang dituju tautan
contoh:200
- summaryTipe: object | null · Response36Afe1097B20_IntersectionSummaryInfo
berisi ringkasan irisan halaman
- intersectionsTipe: integer | null Format: int64
_count total jumlah irisan
- itemsTipe: integer | null Format: int64
_count jumlah hasil yang dikembalikan dalam array
items - targetsTipe: object | null
targetsdari array POST- propertyTipe: string | null
Name
- totalTipe: integer | null Format: int64
_count jumlah total hasil yang relevan dengan permintaan
- resultTipe: integer | null Format: int64
_count jumlah elemen dalam array hasil
- statusTipe: integer | null
_code kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini
- statusTipe: string | null
_message pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini
- timeTipe: string | null
waktu eksekusi, detik
- Tipe: integer | null Format: int64tasks
_count jumlah tugas dalam array tasks
- Tipe: integer | null Format: int64tasks
_error jumlah tugas dalam array tasks yang dikembalikan dengan error
- Tipe: string | nulltime
total waktu eksekusi, detik
- Tipe: string | nullversion
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
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]"
}
]
}
]
}
]
}