Referensi
Referensi API backlink: aksi, biaya, dan error
Satu halaman berisi fakta yang dibutuhkan monitor: berapa biaya setiap aksi, cara kerja paginasi, dan apa yang dilakukan API saat terjadi kesalahan.

Aksi berdasarkan biaya kredit
| Biaya | Aksi | Catatan |
|---|---|---|
| Gratis, tanpa kunci | domain, overview, stats, suggest | Cocok untuk dashboard dan pengecek DR |
| 1 kredit | bulk_dr, compare, top, dr_distribution, tld_breakdown | bulk_dr menerima hingga 2.000 domain (GET domains= atau body POST); compare hingga 20 |
| 2 kredit | refdomains, backlinks, anchors, toppages, anchor_cloud, intersect | intersect membutuhkan 2 hingga 10 domain |
| 3 kredit | search, keyword | Pencarian teks penuh pada anchor, judul, dan URL; keyword menemukan siapa yang ditautkan dengan anchor yang tepat |
Autentikasi dan kode status
Berikan kunci sebagai key= atau sebagai header bearer. Periksa kode HTTP sebelum mengurai body.
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://seouptr.com/api.php?action=anchors&q=yourdomain.com&per=100"
# a cron-safe wrapper
code=$(curl -s -o out.json -w '%{http_code}' "$URL")
case "$code" in
200) jq '._credits' out.json ;; # cost and remaining balance
401) echo 'bad or missing key' ;;
402) echo 'out of credit: top up' ;;
*) echo "unexpected $code" ;;
esacParameter dan error
| Item | Nilai | Arti |
|---|---|---|
q | sebuah domain | Target pencarian |
page, per | per dari 10 hingga 5000 | Paginasi; jumlah baris per panggilan dibatasi 1.000, paginasi mendalam dibatasi 50.000 |
sort, order | order=asc atau desc | Pengurutan baris yang dikembalikan |
ok | di setiap respons | Apakah panggilan berhasil |
_credits | hanya respons terautentikasi | Biaya panggilan dan saldo tersisa |
| HTTP 401 | kunci hilang atau salah | Periksa kunci atau header |
| HTTP 402 | kredit habis | Isi ulang dengan USDT (TRC-20) |

Merancang panggilan sebelum menjadwalkannya
Sebagian besar masalah API bermula dari permintaan, bukan respons. Integrasi seo backlinks api sebagian besar terdiri dari sejumlah keputusan kecil yang dibuat sebelum panggilan pertama. Tetapkan kunci, ukuran halaman, dan urutan pengurutan terlebih dahulu.
Jauhkan kunci dari skrip
Simpan kunci dalam variabel lingkungan atau tempat penyimpanan rahasia, bukan dalam file yang Anda commit. Berikan sebagai parameter key atau sebagai header bearer. Header menjaga kunci agar tidak masuk ke alamat yang cenderung berakhir di log.
Jangan tempel kunci live ke dalam tiket atau obrolan. Anggap kunci yang muncul di log bersama sebagai telah terekspos.
Pilih ukuran halaman dengan sengaja
Parameter per berjalan dari 10 hingga 5000, tetapi satu panggilan ditagih sekali untuk hingga 1.000 baris, sehingga halaman yang lebih besar berarti tagihan lebih sedikit. Katakan Anda membutuhkan 3.400 baris. Itu membutuhkan empat panggilan dengan 1.000 baris, bukan 340 panggilan dengan 10.
Pertahankan ukuran halaman tetap sama di setiap eksekusi agar file sejajar.
Tetapkan urutan pengurutan
Atur sort dan order secara eksplisit daripada mengandalkan default. Parameter yang identik membuat output dapat dibandingkan dari minggu ke minggu, sehingga diff menunjukkan perubahan nyata, bukan baris yang diacak ulang.
Urutan yang berubah adalah cara mudah menciptakan alarm palsu.
Membaca angka
Data adalah grafik tautan kami sendiri: 181.132.097 domain, 2.774.625.913 tautan domain-ke-domain, dan sekitar 798,5 miliar backlink. Data ini diperbarui sekitar sebulan sekali. Apa pun yang lebih baru dari itu tidak akan ada di dalamnya, itulah mengapa seo backlinks api sebaiknya dipanggil secara berkala setiap minggu.
DR adalah round(100 · log(ref_domains+1) / log(2·10^7)). Ini adalah logaritma. Karena itu, 100 domain rujukan bernilai 27, 1.000 bernilai 41, dan 10.000 bernilai 55, sehingga menggandakan jumlah tautan hanya menambah beberapa poin. Gunakan DR untuk memeringkatkan situs terhadap satu sama lain dan hitungan mentah untuk peringatan, seperti yang dilakukan tabel tingkat keparahan.
Harga bersifat prabayar. Tidak ada langganan dan tidak ada minimum. Kredit pendaftaran adalah $100, yang setara dengan 1.000.000 kredit. Bandingkan dengan unit API Ahrefs, yang dijual dalam paket mulai dari $129/bulan untuk 200.000 unit, dengan setidaknya 50 unit per permintaan.
Perencanaan biaya adalah perkalian sederhana. Panggilan refdomains mingguan untuk satu situs adalah 2 kredit dikali 4, atau 8 kredit per bulan, yang setara dengan $0.0008. Sepuluh situs membutuhkan sepuluh kali lipat dari itu. Resep tautan hilang dan pekerjaan kompetitor keduanya hanya menggunakan aksi dari tabel di atas.
Membaca error tanpa menebak-nebak
Kode error memberi tahu Anda siapa yang harus bertindak. Bacalah dengan cara itu. Respons kemudian menjadi keputusan pengalihan, bukan misteri. Dua kode yang paling penting untuk monitor adalah 401 dan 402.
401 dan 402 adalah masalah yang berbeda
401 berarti kunci hilang atau salah, dan tidak ada yang akan berhasil sampai seseorang memperbaikinya. 402 berarti akun kehabisan kredit, dan pengisian ulang akan mengatasinya. Arahkan ke pemilik yang berbeda agar orang yang tepat melihat pesan tersebut.
Kirimkan keduanya ke seseorang. Monitor yang gagal secara diam-diam lebih buruk daripada yang tidak pernah berjalan.
Periksa status sebelum body
Baca status HTTP terlebih dahulu dan bidang ok kedua. Respons dapat diuraikan sebagai JSON dan tetap membawa kegagalan, sehingga pemeriksaan lengkap hanya terjadi ketika keduanya berhasil. Catat status dengan setiap eksekusi, termasuk yang berhasil.
Coba ulang hanya apa yang dapat pulih
Mencoba ulang 401 membuang-buang panggilan dan mengisi log dengan kegagalan yang sama. Timeout jaringan berbeda. Coba ulang beberapa kali dengan jeda di antara percobaan, lalu hentikan.
Eksekusi yang berhenti dan memberi peringatan lebih berguna daripada loop coba ulang yang menyembunyikan kegagalan hingga saldo habis.
Catat status pada setiap eksekusi
Tulis status HTTP dan saldo ke log pada setiap eksekusi, termasuk yang berhasil. Ketika eksekusi gagal tiga minggu kemudian, baris itu adalah hal pertama yang ingin Anda lihat.
domain, overview, stats dan suggest tidak memerlukan kunci dan tidak berbiaya apa pun. Gunakan untuk memeriksa nama domain, ejaan yang tepat, atau ukuran kasar sebelum mengeluarkan satu kredit pun untuk aksi berbayar.
Sebelum memasukkan panggilan ke cron
- Biaya aksi diketahui dan dikalikan dengan jumlah eksekusi per bulan.
- Kode keluar dan status HTTP keduanya diperiksa.
- 402 mengirim peringatan ke manusia.
- Respons disimpan dalam urutan, sehingga diff tetap bersih.
- Kadensa sesuai dengan pembaruan bulanan.

Catatan tentang paginasi
Urutan penting. Gunakan per=1000 untuk snapshot dan pertahankan sort dan order yang sama setiap minggu. Jika urutan berubah di antara eksekusi, diff akan menunjukkan noise. Itu adalah penyebab klasik alarm palsu.
Situs yang lebih besar? Untuk situs dengan lebih dari 1.000 domain rujukan, paginasi dengan page=1, page=2, dan seterusnya. Setiap halaman adalah panggilan yang ditagih terpisah. Paginasi mendalam dibatasi 50.000 baris, yang mencakup hampir setiap situs biasa.
Pertanyaan tentang referensi
- Aksi mana yang harus saya panggil pertama kali ketika saya tidak yakin tampilan domain?
- Mulailah dengan
overviewataudomain. Keduanya gratis dan tidak memerlukan kunci, serta menunjukkan ukuran kasar dan bentuk dasar data. Keluarkan kredit untukrefdomainsatauanchorshanya setelah itu. - Berapa biaya pemeriksaan penuh satu domain?
- Jumlahkan kredit setiap aksi, lalu kalikan dengan seberapa sering aksi tersebut berjalan. Bayangkan panggilan
refdomains, panggilananchors, dan panggilantld_breakdownpada satu domain, secara mingguan. Itu adalah 2 + 2 + 1 = 5 kredit per eksekusi, atau $0.0005. Selama empat minggu jumlahnya sekitar $0.002. - Mengapa dua hitungan untuk domain yang sama mungkin tidak cocok?
- Bandingkan yang serupa dengan yang serupa: aksi yang sama, parameter yang sama, dan periode pembaruan yang sama. Hitungan dari aksi yang berbeda tidak dapat dipertukarkan, dan hitungan yang diambil di tengah pembaruan dapat berbeda dari yang diambil seminggu kemudian.
- Bagaimana cara menguji pekerjaan cron tanpa menghabiskan kredit?
- Jalankan aksi gratis terlebih dahulu untuk memeriksa kabel, penanganan status, dan format output. Kemudian lakukan satu panggilan berbayar untuk membuktikan angka, dan batasi pekerjaan hanya satu eksekusi saat Anda menguji.
- Apakah paging berfungsi untuk situs dengan lebih dari 1.000 domain rujukan?
- Ya. Gunakan
pagedenganper. Setiap halaman adalah panggilan yang ditagih terpisah, dan paginasi mendalam dibatasi 50.000 baris, yang mencakup sebagian besar situs biasa.
Monitor yang bertahan dari minggu yang buruk
Monitor mendapatkan kepercayaan di minggu-minggu ketika segala sesuatu berjalan tidak sesuai rencana. Rencanakan respons lambat, saldo yang berubah, dan hasil parsial sebelum eksekusi pertama. Itu adalah peristiwa biasa. Setiap peristiwa harus meninggalkan baris yang jelas di log.
Timeout dan penarikan parsial
Atur timeout pada setiap panggilan, agar satu respons lambat tidak dapat menahan seluruh pekerjaan. Jika halaman dari penarikan multi-halaman gagal, catat halaman mana yang gagal dan mulai ulang dari sana. Dengan demikian Anda menghindari membayar dua kali untuk baris yang sudah Anda miliki.
Tandai file parsial sebagai parsial daripada menyimpannya sebagai snapshot normal. Jika tidak, diff berikutnya akan menunjukkan kehilangan yang sebenarnya tidak terjadi.
Pemeriksaan saldo
Baca _credits pada setiap respons terautentikasi dan tulis saldo tersisa ke log. Skrip kecil dapat membandingkannya dengan batas bawah yang Anda pilih dan mengirim peringatan sebelum eksekusi berikutnya.
Katakan batas bawahnya adalah 500 kredit. Eksekusi mingguan yang memakan 40 kredit menyisakan ruang untuk mengisi ulang sebelum 402 tiba di tengah malam.
Jaga setiap pekerjaan tetap membosankan
Berikan setiap pekerjaan satu file dan satu jadwal. Entri cron yang melakukan tiga hal dapat gagal dengan tiga cara, dan log tidak selalu dapat mengatakan mana yang terjadi. Dua pekerjaan kecil lebih mudah dipercaya daripada satu pekerjaan cerdas.
Sesuaikan jadwal dengan pembaruan
Sesuaikan jadwal pekerjaan dengan pembaruan bulanan, bukan dengan jam. Eksekusi harian mengembalikan file yang sama sebagian besar hari, yang menambah biaya dan noise tanpa menambah informasi. Mingguan biasanya sudah cukup.