DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Backlink
Tautan masuk individual ke satu target, satu baris per tautan. Mengembalikan total_count, items_count, items, dan search_after_token untuk penomoran halaman - gunakan token itu, bukan offset, setelah beberapa halaman pertama. mode dan custom_mode mengatur pengelompokan, backlinks_status_type memilih live, lost, atau semua. Untuk jumlah, bukan baris, gunakan post_dataforseo_backlinks_summary_live; untuk domain yang menautkan secara berkelompok, post_dataforseo_backlinks_referring_domains_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.
- Tipe: array (object | null)[]
- backlinksTipe: string | null
_status _type 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 teragregasitargetAnda;
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 - customTipe: object | null
_mode jenis pengelompokan hasil terperinci
field opsional
gunakan objek ini untuk mendapatkan jumlah backlink tertentu perfield
jika Anda menggunakancustom_mode, makamodeakan diabaikan
contoh:"custom_mode": {"field": "domain", "value": 100}- propertyTipe: object | null
Name
- 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 - 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:=,<>,in,not_in,like,not_like,ilike,not_ilike,regex,not_regex,match,not_match
Anda dapat menggunakan operator%denganlikedannot_likeuntuk mencocokkan string apa pun dengan nol atau lebih karakter
contoh:["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%"]]]Objek kosong - includeTipe: boolean | null
_subdomains menunjukkan apakah subdomain dari
targetakan disertakan dalam pencarian
field opsional
jika disetel kefalse, subdomain akan diabaikan
nilai default:true - limitTipe: integer | null
jumlah maksimum backlink yang dikembalikan
field opsionalnilai default:
100
nilai maksimum:1000 - modeTipe: string | null
jenis pengelompokan hasil
field opsional
jenis pengelompokan yang tersedia:as_is- mengembalikan semua backlinkone_per_domain- mengembalikan satu backlink per domainone_per_anchor- mengembalikan satu backlink per anchornilai default:
as_is - 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;
Catatan: nilai maksimum adalah20,000, gunakansearch_after_tokenjika Anda ingin mengambil lebih banyak hasil - 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
- searchTipe: string | null
_after _token token untuk permintaan berikutnya
field opsional
disediakan di field yang identik pada respons setiap permintaan;
gunakan parameter ini untuk menghindari timeout saat mencoba memperoleh lebih dari20,000hasil dalam satu permintaan;
dengan menentukan nilaisearch_after_tokenunik dari array respons, Anda akan mendapatkan hasil berikutnya dari tugas awal;
nilaisearch_after_tokenunik untuk setiap tugas berikutnya;
Catatan: jikasearch_after_tokenditentukan dalam permintaan, semua parameter lain harus identik dengan permintaan sebelumnya - 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 - targetTipe: string
domain, subdomain, atau halaman web untuk mendapatkan backlink
field wajib
domain atau subdomain harus ditentukan tanpahttps://danwww.
halaman harus ditentukan dengan URL absolut (termasukhttp://atauhttps://)
- Tipe: object | null · Response36Afe1097B20_BacklinksBacklinksLiveResponseInfo200
- 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_BacklinksBacklinksLiveTaskInfo
- 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
- customTipe: object | null
_mode mode khusus yang ditentukan dalam array POST
- propertyTipe: object | null
Name
- itemsTipe: array (object | null)[] | null
berisi data backlink dan domain perujuk yang relevan
- 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 - 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 - imageTipe: string | null
_url URL gambar
URL yang mengarah ke gambar di sumber asli atau penyimpanan DataForSEO (jika sumber asli tidak tersedia) - 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,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
peringkat backlink
peringkat yang diteruskan backlink tersebut ketargetrankdihitung 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 - rankedTipe: object | null · Response36Afe1097B20_RankedKeywordsInfo
_keywords _info - pageTipe: integer | null Format: int64
_from _keywords _count _top _10 Signed 64-bit integers (long type).
- pageTipe: integer | null Format: int64
_from _keywords _count _top _100 Signed 64-bit integers (long type).
- pageTipe: integer | null Format: int64
_from _keywords _count _top _3 Signed 64-bit integers (long type).
- semanticTipe: string | null
_location - textTipe: string | null
_post cuplikan setelah teks anchor
- textTipe: string | null
_pre cuplikan 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
- itemsTipe: integer | null Format: int64
_count jumlah hasil yang dikembalikan dalam array
items - modeTipe: string | null
mode yang ditentukan dalam array POST
- searchTipe: string | null
_after _token token untuk permintaan berikutnya
dengan menentukansearch_after_tokenunik saat menetapkan tugas baru, Anda akan mendapatkan hasil lanjutan dari tugas awal;
nilaisearch_after_tokenunik untuk setiap tugas berikutnya - targetTipe: string | null
domain target dalam array POST
- 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/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
}
]
}
]
}