Referensi API

Geolokasi IP (DB-IP Lite)

Cari negara, provinsi/region, kota, koordinat, serta ASN dan organisasi jaringan dari alamat IPv4 atau IPv6, termasuk alamat pemanggil sendiri lewat /ip/me. Datanya adalah DB-IP Lite (IP to City Lite dan IP to ASN Lite) yang dilisensikan CC BY 4.0 dan diperbarui DB-IP setiap bulan. DB-IP sendiri menyebut versi Lite sebagai subset dengan cakupan dan akurasi yang lebih rendah dari database komersialnya, jadi hasil tingkat kota bersifat perkiraan.

Data per · Sumber: DB-IP Lite (IP Geolocation by DB-IP)

Endpoint utama
GET https://use.apiindonesia.id/api/v1/ip/:ip
Jumlah endpoint
3
Autentikasi
Header x-api-key (buat gratis di dashboard)
Harga
2 kredit (Rp2) per request sukses; request gagal gratis
Format
JSON (REST), contoh cURL, JavaScript, Python
Sumber data
IP Geolocation by DB-IP (https://db-ip.com). Sumber data: DB-IP Lite (https://db-ip.com/db/lite.php), dilisensikan di bawah Creative Commons Attribution 4.0 International (CC BY 4.0). Setiap respons sukses menyertakan meta.attribution berisi atribusi, lisensi, tautan lisensi, tautan ke db-ip.com, dan penandaan perubahan. Lisensi DB-IP mewajibkan aplikasi web yang menampilkan atau memakai hasilnya untuk memasang tautan balik ke DB-IP.com, misalnya teks "IP Geolocation by DB-IP" yang ditautkan ke https://db-ip.com, jadi kewajiban itu juga berlaku untuk aplikasi Anda bila menampilkan hasil API ini. Yang diubah API Indonesia: rentang IP dan lokasi dinormalisasi ke JSON, dan rentang "ZZ" (privat/reserved) dilaporkan sebagai reserved: true dengan kolom lokasi null. API Indonesia tidak berafiliasi dengan maupun didukung oleh DB-IP.
Ringkasan Produk

Apa yang Anda dapat dari API ini

Cari negara, provinsi/region, kota, koordinat, serta ASN dan organisasi jaringan dari alamat IPv4 atau IPv6, termasuk alamat pemanggil sendiri lewat /ip/me. Datanya adalah DB-IP Lite (IP to City Lite dan IP to ASN Lite) yang dilisensikan CC BY 4.0 dan diperbarui DB-IP setiap bulan. DB-IP sendiri menyebut versi Lite sebagai subset dengan cakupan dan akurasi yang lebih rendah dari database komersialnya, jadi hasil tingkat kota bersifat perkiraan.

IP Geolocation by DB-IP (https://db-ip.com). Sumber data: DB-IP Lite (https://db-ip.com/db/lite.php), dilisensikan di bawah Creative Commons Attribution 4.0 International (CC BY 4.0). Setiap respons sukses menyertakan meta.attribution berisi atribusi, lisensi, tautan lisensi, tautan ke db-ip.com, dan penandaan perubahan. Lisensi DB-IP mewajibkan aplikasi web yang menampilkan atau memakai hasilnya untuk memasang tautan balik ke DB-IP.com, misalnya teks "IP Geolocation by DB-IP" yang ditautkan ke https://db-ip.com, jadi kewajiban itu juga berlaku untuk aplikasi Anda bila menampilkan hasil API ini. Yang diubah API Indonesia: rentang IP dan lokasi dinormalisasi ke JSON, dan rentang "ZZ" (privat/reserved) dilaporkan sebagai reserved: true dengan kolom lokasi null. API Indonesia tidak berafiliasi dengan maupun didukung oleh DB-IP.

Cakupan
3

endpoint siap pakai dalam produk ini, dengan respons JSON dan pola error yang konsisten.

Akses
API key

Bisa dicoba dengan bonus 3.000 kredit saat daftar, lalu dipakai di production lewat satu API key API Indonesia.

Contoh resource
https://use.apiindonesia.id/api/v1/ip/:ip

Negara (kode ISO 3166-1 alpha-2), kode benua, region, kota, lintang/bujur, ASN beserta nama organisasinya, dan rentang DB-IP tempat alamat itu berada. IPv6 boleh ditulis langsung di path; alamat IPv4-mapped (::ffff:a.b.c.d) dicari sebagai IPv4. Alamat yang tidak valid dijawab 400, alamat tanpa rentang yang cocok dijawab 404, dan keduanya tidak memotong kredit.

Contoh skenario produk

Bagian ini membedakan halaman produk dari dokumentasi. Dokumentasi menjawab cara memanggil endpoint; halaman ini menjawab kenapa endpoint tersebut masuk akal untuk fitur Anda.

  • Personalisasi & lokalisasi: pilih bahasa, mata uang, atau zona waktu default berdasarkan negara pengunjung.
  • Keamanan & antifraud ringan: tandai login atau transaksi dari negara atau ASN yang tidak biasa untuk pemeriksaan tambahan.
  • Analitik: kelompokkan log akses per negara, kota, atau operator jaringan tanpa memelihara database IP sendiri.

Contoh Pemakaian

Request
curl "https://use.apiindonesia.id/api/v1/ip/36.66.0.1" \
  -H "x-api-key: YOUR_API_KEY"
Respons · 200 OK
{
  "success": true,
  "data": {
    "ip": "36.66.0.1",
    "version": 4,
    "reserved": false,
    "continent_code": "AS",
    "country_code": "ID",
    "region": "Jakarta",
    "city": "Jakarta",
    "latitude": -6.18354,
    "longitude": 106.824,
    "asn": { "number": 7713, "organization": "Telekomunikasi Indonesia (PT)" },
    "network": { "start": "36.66.0.0", "end": "36.66.0.255" }
  },
  "meta": {
    "attribution": {
      "source": "IP Geolocation by DB-IP",
      "license": "CC BY 4.0",
      "license_url": "https://creativecommons.org/licenses/by/4.0/",
      "source_url": "https://db-ip.com",
      "attribution_page": "https://db-ip.com/db/lite.php",
      "notice": "Data diubah: rentang IP dan lokasi dinormalisasi ke format JSON API Indonesia; rentang \"ZZ\" dilaporkan sebagai reserved. Bukan endorsement dari DB-IP."
    }
  }
}

Artikel Terkait

Harga 2 kredit (Rp2) per request sukses; request gagal gratis. Bonus 3.000 kredit sekali saat daftar, tanpa kartu kredit dan tanpa jatah bulanan.

Pertanyaan seputar API Geolokasi IP (DB-IP Lite)

Data apa yang dikembalikan?

Kode negara, kode benua, region, kota, lintang/bujur, ASN dan nama organisasi, serta rentang DB-IP tempat alamat itu berada, untuk IPv4 dan IPv6.

Seberapa akurat hasilnya?

Datanya DB-IP Lite, yang menurut DB-IP adalah subset dengan cakupan dan akurasi lebih rendah dari versi komersialnya. Negara umumnya lebih andal daripada kota; anggap kota dan koordinat sebagai perkiraan.

Apakah saya perlu mencantumkan atribusi?

Ya, bila aplikasi Anda menampilkan atau memakai hasilnya di halaman web. Lisensi CC BY 4.0 DB-IP mewajibkan tautan balik, misalnya "IP Geolocation by DB-IP" yang menaut ke https://db-ip.com. Setiap respons sudah membawa meta.attribution.

Berapa harga batch?

POST /api/v1/ip/batch dihitung per panggilan: 100 kredit untuk 1 sampai 100 alamat. Untuk kurang dari 50 alamat, panggil /ip/{ip} satu per satu (2 kredit per panggilan) karena lebih murah.

Mulai Sekarang

Mulai Integrasi
Hari Ini

Daftar gratis dan dapatkan bonus 3.000 kredit (Rp3.000) setelah email diverifikasi, ambil API key, lalu langsung call endpoint pertama Anda. Tanpa kartu kredit, tanpa proses approval yang ribet.

Visualisasi gelombang titik