Kembali ke beranda

Dokumentasi API

API REST Index Instan — versi 1

Mulai cepat

1. Ambil API key

Tersedia di semua paket, lewat Dasbor → Profil → Akses API.

2. Kirim URL Anda

Satu POST ke endpoint submit. Hingga 500 URL sekali request, diproses tiga per batch.

3. Pantau perayapannya

Riwayat menunjukkan posisi setiap URL. Riwayat disimpan 48 jam.

Autentikasi

Endpoint yang butuh autentikasi membaca API key Anda dari header Authorization: Bearer. API key selalu diawali ixid_ dan dibuat lewat Dasbor → Profil → Akses API.

# API key Anda mengautentikasi setiap request
curl https://indexinstan.com/api/user/credits \
  -H "Authorization: Bearer ixid_API_KEY_ANDA"

API key setara dengan kata sandi Anda: jangan pernah menaruhnya di kode yang dikirim ke browser, di repositori publik, atau di dalam URL. Kalau bocor, buat ulang dari dasbor — yang lama langsung berhenti berfungsi.

Batasan

500

URL per request

3 URL

Ukuran batch

48 jam

Riwayat disimpan

10 req/dtk

Laju permintaan

Endpoints

POST/api/indexing/submitPerlu API key

Submit URL

Mengirim hingga 500 URL ke Google. URL masuk antrean dan diproses tiga per batch.

Isi request

{
  "urls": [
    "https://situsanda.com/halaman-1",
    "https://situsanda.com/halaman-2",
    "https://situsanda.com/halaman-3"
  ]
}

Respons

{
  "success": true,
  "submitted": 3,
  "failed": 0,
  "creditsUsed": 3,
  "remainingCredits": 61,
  "results": [
    { "url": "https://situsanda.com/halaman-1", "status": "submitted" },
    { "url": "https://situsanda.com/halaman-2", "status": "submitted" },
    { "url": "https://situsanda.com/halaman-3", "status": "submitted" }
  ]
}

Error

  • 400Tidak ada URL valid yang dikirim
  • 402Kredit tidak mencukupi
  • 429Terlalu banyak permintaan — kurangi lajunya
  • 503Layanan index sedang tidak tersedia
GET/api/indexing/history?page=1&limit=20Perlu API key

Lihat riwayat

Mengambil daftar submit Anda dengan paginasi. URL disimpan selama 48 jam.

Respons

{
  "submissions": [
    {
      "_id": "abc123",
      "url": "https://situsanda.com/halaman-1",
      "status": "submitted",
      "searchEngine": "google",
      "creditsUsed": 1,
      "createdAt": "2026-09-07T12:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "pages": 3
  }
}

Error

  • 401API key tidak ada atau tidak valid
GET/api/user/creditsPerlu API key

Lihat sisa kredit

Mengembalikan sisa kredit, paket Anda, dan biaya satu kali submit.

Respons

{
  "credits": 80,
  "planName": "Pemula",
  "planExpiresAt": "2099-12-31T00:00:00Z",
  "creditCosts": { "credit_cost_url_indexing": 1 }
}

Error

  • 401API key tidak ada atau tidak valid
GET/api/plansPublic

Daftar paket

Mengembalikan semua paket yang aktif. Tidak perlu autentikasi.

Respons

{
  "plans": [
    {
      "name": "Pemula",
      "price": 5,
      "credits": 80,
      "currency": "USD",
      "billingPeriod": "lifetime",
      "features": ["80 kredit index", "…"]
    }
  ]
}

Ada pertanyaan soal API? Hubungi kami, kami balas dalam 24 jam.