Dokumentasi & Panduan

Cara kerjanya

1. Server Anda mengirim daftar URL halaman ke IndexLaunch, ditandatangani dengan kunci API Anda.
2. IndexLaunch memeriksa setiap URL, memotong satu kredit per URL, dan mengirimkannya ke mesin pencari untuk di-crawl. Anda menerima satu ID untuk setiap URL.
3. Gunakan ID tersebut untuk memeriksa status setiap URL kapan saja.

Siapkan dalam 4 langkah

1. Masuk dan buat kunci di Pengaturan → Akses API. Kunci hanya ditampilkan sekali, jadi segera salin.
2. Simpan kunci sebagai variabel lingkungan rahasia di server atau CI Anda, misalnya INDEXLAUNCH_API_KEY. Jangan pernah menaruhnya di kode browser atau repositori publik.
3. Verifikasi setiap domain yang URL-nya akan Anda kirim (Settings → Domain Verification). Mesin pencari menolak URL dari situs yang belum diverifikasi.
4. Panggil API dari backend, skrip, atau pipeline deploy Anda. Contoh di bawah siap disalin.

Autentikasi

Kirim kunci Anda di header Authorization pada setiap permintaan sebagai Bearer YOUR_KEY. Semua permintaan menggunakan HTTPS dan JSON.

Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

Kirim URL

Kirim hingga 500 URL lengkap (diawali https://) per permintaan. Setiap URL memakan satu kredit. Respons berisi satu ID per URL, dengan urutan yang sama seperti saat Anda mengirimnya.

POST https://www.indexlaunch.site/api/v1/submit
Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

{ "urls": ["https://example.com/page-1", "https://example.com/page-2"] }

200 OK
{ "submitted": 2, "ids": ["j57...", "j58..."] }

Periksa status URL

Gunakan ID dari respons pengiriman. Anda hanya dapat membaca URL yang dikirim oleh akun Anda sendiri.

GET https://www.indexlaunch.site/api/v1/urls/j57...
Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

200 OK
{
  "id": "j57...",
  "url": "https://example.com/page-1",
  "status": "indexed",
  "submittedAt": 1757740800000,
  "indexedAt": 1757741100000
}

Kolom respons

id

ID pengiriman.

url

URL yang Anda kirim.

status

Salah satu nilai status di bawah ini.

submittedAt

Waktu pengiriman, dalam milidetik sejak epoch Unix.

indexedAt

Waktu mesin pencari menerimanya. Tidak ada sampai saat itu.

Nilai status

pending

Diterima dan menunggu dikirim. Sebagian besar URL berlanjut dalam beberapa menit.

indexed

Diterima mesin pencari dan masuk antrean crawl. Dasbor menampilkannya sebagai “Submitted”. Ini belum memastikan halaman sudah terindeks.

failed

Mesin pencari tidak menerima URL tersebut, paling sering karena domainnya belum diverifikasi. Kredit dikembalikan secara otomatis.

refunded

URL tertahan lebih dari 7 hari, sehingga kredit dikembalikan secara otomatis.

Contoh kode

curl -X POST https://www.indexlaunch.site/api/v1/submit \
  -H "Authorization: Bearer $INDEXLAUNCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://example.com/new-post"]}'

const res = await fetch("https://www.indexlaunch.site/api/v1/submit", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INDEXLAUNCH_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    urls: ["https://example.com/new-post", "https://example.com/pricing"],
  }),
});

const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(`Submitted ${data.submitted} URLs`, data.ids);

import os
import requests

res = requests.post(
    "https://www.indexlaunch.site/api/v1/submit",
    headers={"Authorization": f"Bearer {os.environ['INDEXLAUNCH_API_KEY']}"},
    json={"urls": ["https://example.com/new-post"]},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"])
print(data["submitted"], data["ids"])

# .github/workflows/indexlaunch.yml
name: Submit new pages
on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  submit:
    runs-on: ubuntu-latest
    steps:
      - name: Send changed URLs to IndexLaunch
        env:
          INDEXLAUNCH_API_KEY: ${{ secrets.INDEXLAUNCH_API_KEY }}
        run: |
          curl --fail-with-body -X POST https://www.indexlaunch.site/api/v1/submit \
            -H "Authorization: Bearer $INDEXLAUNCH_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{"urls": ["https://example.com/new-post"]}'

Error

Error mengembalikan JSON dengan kolom error berisi pesan yang dapat Anda tampilkan atau catat.

400

Permintaan tidak valid: body tidak memiliki daftar urls, ada URL yang tidak valid, lebih dari 500 URL dikirim, kredit tidak mencukupi, atau permintaan datang terlalu cepat.

401

Kunci tidak ada, salah, atau sudah dicabut.

403

Akun ditangguhkan.

404

Tidak ada pengiriman dengan ID tersebut di akun Anda.

Praktik yang baik

• Kirim hanya halaman baru atau yang berubah, bukan seluruh situs Anda di setiap deploy.
• Gabungkan URL dalam satu permintaan, alih-alih mengirim satu permintaan per URL.
• Jika Anda menerima “Too many requests” atau pesan batas laju, tunggu satu menit lalu coba lagi. Batas persis akun Anda ditampilkan di Pengaturan → Akses API.
• Jika kunci bocor, cabut di Pengaturan dan buat kunci baru. Kunci yang dicabut langsung berhenti berfungsi.