API dan server MCP GetLinkFast

Kegunaannya

• Agensi dan tim SEO: hubungkan alat internal dan dasbor pemantauan Anda ke akun Anda. Katalog, keranjang, pesanan, dan status dapat dibaca dalam JSON.
• Agen AI: minta Claude Code atau Cursor “carikan 5 situs keuangan dengan DR 40+ lalu pesan”. Agen mencari, menunjukkan ringkasan, dan hanya memesan setelah Anda setuju.
• Make, n8n, Zapier: cukup satu modul HTTP dan satu kunci.

API menjual artikel tamu (guest_post), penyisipan tautan (link_insertion), dan paket SEO/GEO, hanya dengan kredit. Pembelian kredit dan penawaran lain tetap di dasbor.

Membuat kunci

1. Buka Dasbor → Akses API.
2. Beri nama kunci (misalnya “Agen Claude” atau “Laporan Make”) dan pilih izinnya. Pada kunci yang boleh memesan, Anda dapat menetapkan batas per pesanan dan batas selama 24 jam.
3. Salin kunci. Kunci diawali glf_live_ dan hanya ditampilkan sekali: kami hanya menyimpan sidik jarinya.
4. Kirimkan di header setiap permintaan: Authorization: Bearer glf_live_…

Maksimal 10 kunci aktif per organisasi. Kunci yang dicabut langsung berhenti berfungsi, begitu pula kunci anggota yang keluar dari organisasi. Jauhkan kunci dari repositori kode Anda: siapa pun yang memegangnya bertindak atas nama organisasi Anda.

Izin sebuah kunci

Setiap kunci memiliki satu atau beberapa izin. Permintaan tanpa izin yang diperlukan menerima 403 insufficient_scope, dan agen AI hanya melihat alat yang diizinkan.

Mulai cepat

Semua rute diawali https://www.getlinkfast.com/api/v1. Pertahankan www: alamat tanpa www akan mengalihkan, dan klien HTTP tidak lagi mengirim header Authorization setelah pengalihan.

Jumlah dalam euro belum termasuk PPN. Respons dalam JSON, dengan bidang dalam snake_case.

curl https://www.getlinkfast.com/api/v1/account \
  -H "Authorization: Bearer glf_live_…"

curl "https://www.getlinkfast.com/api/v1/sites?dr_min=40&language=fr&product=guest_post&sort=dr&dir=desc&page_size=10" \
  -H "Authorization: Bearer glf_live_…"

curl -X POST https://www.getlinkfast.com/api/v1/cart/items \
  -H "Authorization: Bearer glf_live_…" \
  -H "Content-Type: application/json" \
  -d '{"site_id":"8a1f0c3e-5b7d-4e2a-9c61-0f3b2d4e6a17","product_type":"guest_post","target_url":"https://www.example.com/invoicing","anchor":"invoicing software","topic":"How to choose invoicing software for a small business"}'

Ganti site_id dengan id situs dari langkah 2. Jangan pernah mengirim harga: server yang menghitungnya.

curl -X POST https://www.getlinkfast.com/api/v1/checkout \
  -H "Authorization: Bearer glf_live_…" \
  -H "Idempotency-Key: order-2026-10-14-001"

Respons memberikan id pesanan, jumlah yang didebit, dan sisa saldo Anda. Lalu pantau progresnya dengan GET /orders/{id}.

Memesan dengan kredit

API hanya memesan dengan kredit dan tidak pernah memicu pembayaran kartu. Kredit diisi ulang di dasbor.

Pesanan mengambil baris guest_post dan link_insertion dari keranjang. Baris lain, yang ditambahkan dari dasbor, tetap di keranjang dan tercantum di skipped_items.

Tidak ada batas bawaan: saldo Anda satu-satunya batas. Pada kunci yang boleh memesan, tetapkan batas per pesanan dan batas selama 24 jam bergulir. Pesanan yang melampauinya ditolak (403 spending_limit_exceeded, dengan sisa yang tersedia), tanpa debit.

Saldo tidak cukup: 402 insufficient_credits, dengan jumlah yang kurang dan tautan halaman Kredit, untuk diteruskan ke anggota tim Anda. Tidak ada yang didebit.

Setelah itu semuanya berjalan seperti dari dasbor: email konfirmasi dan pemantauan di layar Pesanan, tempat pesanan membawa nama kunci yang membuatnya.

Header Idempotency-Key

• Wajib pada POST /checkout dan POST /packs/orders: 8 hingga 128 karakter ASCII yang dapat dicetak, tanpa spasi. Tanpanya: 400 idempotency_key_required.
• Satu nilai sama dengan satu niat pembelian. Mengirim ulang nilai yang sama mengembalikan pesanan asli (200, "replayed": true) tanpa debit kedua, meskipun keranjang telah berubah sejak itu.
• Setelah batas waktu habis atau jaringan terputus, ulangi dengan nilai yang sama: Anda tidak akan membayar dua kali.
• Untuk pembelian baru, buat nilai baru, misalnya UUID.
• Pada POST /checkout maupun POST /packs/orders, nilai yang sudah dipakai untuk pembelian lain ditolak: 409 idempotency_conflict, tanpa debit. Untuk paket, nilai yang sama yang dikirim dengan isi berbeda juga ditolak.
• Di sisi MCP, token konfirmasi memegang peran ini: Anda tidak perlu membuat apa pun.

Batas

• 120 permintaan per menit per kunci untuk membaca, dan jumlah yang sama, secara terpisah, untuk keranjang: yang satu tidak mengurangi yang lain.
• 10 panggilan per menit per kunci ke rute atau alat pembelian — termasuk pengulangan, penolakan, dan langkah ringkasan MCP.
• 300 permintaan HTTP per menit per kunci di server MCP. Setiap alat yang dipanggil juga dihitung dalam batas izinnya.
• Melebihi itu: 429 rate_limited. Lama menunggu, dalam detik, diberikan oleh header Retry-After lewat HTTP, dan oleh details.retry_after_seconds dalam hasil alat MCP.
• Maksimal 100 hasil per halaman (page_size).
• Isi permintaan: maksimal 1 MB.

Kode galat

Setiap galat memiliki bentuk yang sama. Uji code: nilainya stabil. message berbahasa Inggris dan ditujukan untuk pengembang; details menyebutkan bidang yang salah atau jumlahnya.

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this order. Nothing was debited. Ask a human to top up at credits_url, then retry with the same Idempotency-Key.",
    "details": {
      "missing_amount": 42,
      "credits_url": "https://www.getlinkfast.com/dashboard/credits"
    }
  }
}

Server MCP

Server MCP memberi agen AI Anda fungsi yang sama dengan API, dengan kunci yang sama. Alamatnya: https://www.getlinkfast.com/api/mcp.

Claude Code

Satu perintah di terminal Anda:

claude mcp add --transport http getlinkfast https://www.getlinkfast.com/api/mcp --header "Authorization: Bearer glf_live_…"

Cursor

Di ~/.cursor/mcp.json. Hindari file .cursor/mcp.json milik proyek: file itu sering berakhir di repositori, bersama kuncinya.

{
  "mcpServers": {
    "getlinkfast": {
      "url": "https://www.getlinkfast.com/api/mcp",
      "headers": {
        "Authorization": "Bearer glf_live_…"
      }
    }
  }
}

Claude Desktop

Claude Desktop tidak mengirim header khusus ke server jarak jauh, sehingga tidak dapat meneruskan kunci Anda. Ia akan terhubung langsung melalui koneksi OAuth yang direncanakan di versi mendatang. Untuk saat ini, gunakan Claude Code atau Cursor: keduanya mengirim kunci di header Authorization.

Alat

Agen hanya melihat alat yang diizinkan oleh izin kunci: kunci tanpa hak memesan tidak memiliki alat pembelian apa pun.

read

search_sitesget_sitelist_site_pageslist_categoriesget_accountlist_ordersget_orderget_auditquote_packlist_auditsget_plan

cart

get_cartadd_to_cartupdate_cart_itemremove_cart_itemadd_audit_pagerun_auditcancel_planned_link

purchase

checkoutorder_packplan_links

Pembelian dua langkah

1. Agen memanggil checkout atau order_pack tanpa confirmation_token: tidak ada yang didebit. Agen menerima ringkasan (baris, total, saldo setelah debit, sisa batas) dan sebuah confirmation_token.
2. Agen menunjukkan ringkasan itu kepada Anda. Jika Anda setuju, agen memanggil alat lagi dengan confirmation_token: pesanan dibuat dan didebit.
3. Token berlaku 10 menit. Jika keranjang, harga, atau kunci berubah sementara itu, token ditolak (confirmation_expired) dan agen mengulang langkah 1. Memanggil lagi dengan token yang sama setelah gangguan mengembalikan pesanan yang sama, tanpa debit kedua.

Klien yang ditulis sendiri

Server tanpa sesi: setiap pesan JSON-RPC dikirim sebagai POST dan respons datang dalam JSON. Kirim Accept: application/json, text/event-stream dan Content-Type: application/json, jika tidak server membalas 406. GET dan DELETE membalas 405.

curl -X POST https://www.getlinkfast.com/api/mcp \
  -H "Authorization: Bearer glf_live_…" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Audit dan perencanaan

Agen dapat mengaudit sebuah situs, lalu menyebar tautan selama beberapa bulan berdasarkan laporannya. Empat langkah, dengan alat server MCP.

1. run_audit memulai audit lengkap sebuah domain: pemeriksaan teknis, visibilitas di ChatGPT, dan situs tempat tautan akan membantu. Butuh beberapa menit. Tidak ada yang didebit, dan laporan dibuka dengan kuota audit organisasi jika ada. Batas: 10 audit per kunci per 24 jam; meminta domain yang sama lagi dalam satu jam mengembalikan audit yang sudah ada.
2. get_audit memberi status dan langkah saat ini, lalu laporan di summary saat status menjadi ready. Panggil setiap 30 sampai 60 detik. list_audits menampilkan audit organisasi, dari yang terbaru.
3. plan_links menyusun kalender dari audit yang sudah siap: anggaran bulanan dalam euro tanpa PPN (minimal 100 €), 2 sampai 12 bulan, dan opsional tanggal mulai serta halaman tujuan. Seperti pembelian, ada dua langkah. Tanpa token tidak ada yang disimpan: agen menerima kalender (tautan, tanggal kirim, total) dan confirmation_token yang berlaku 10 menit. Setelah Anda setuju, agen memanggil alat itu lagi dengan kolom yang sama dan token tersebut, lalu rencana disimpan.
4. get_plan mengikuti setiap tautan: halaman tujuan, anchor, harga, dan status (dijadwalkan, dipesan, diterbitkan, dibatalkan, atau gagal, dengan penyebab kegagalan seperti insufficient_credits). cancel_planned_link membatalkan tautan yang direncanakan melalui API, atau semua tautan domain yang belum dipesan. Tautan yang dijadwalkan oleh tim kami tetap di tempatnya: team_planned untuk satu tautan, skipped_team_planned untuk jumlahnya.

Tidak ada yang didebit saat rencana disimpan. Setiap tautan didebit dalam kredit pada hari pengirimannya, dengan harga yang dibaca ulang hari itu, saat proses harian pagi (sekitar 06:20 UTC). Jika saldo kurang hari itu, tautan tidak dipesan dan tampil gagal di get_plan. Tautan yang sudah dipesan tidak bisa dibatalkan lagi.

Hak akses: run_audit dan cancel_planned_link memerlukan cart, plan_links memerlukan purchase, dan get_audit, list_audits serta get_plan memerlukan read. Batas pengeluaran kunci berlaku juga untuk tautan yang direncanakan.

Di dasbor, halaman Delegasi menampilkan tautan ini di blok “Tautan terjadwal”. Pemilik organisasi dapat menghapus di sana tautan yang direncanakan lewat API. Tautan yang direncanakan tim kami hanya bisa dibaca.

Referensi

Setiap rute dengan izinnya dan alat MCP yang sesuai. Parameter, skema respons, dan galat per rute: deskripsi OpenAPI 3.1.

Ada pertanyaan tentang API? Tulis kepada kami, anggota tim kami akan menjawab.