Watch-IP

Referensi API pencarian IP massal

POST/v1/lookup

Versi batch dari GET /v1/lookup/{ip} — menyelesaikan hingga 100 alamat IPv4/IPv6 dalam satu request backend, dikembalikan dalam urutan yang sama saat dikirim.

Autentikasi

Sediakan secret key lewat Authorization: Bearer YOUR_SECRET_KEY, jenis key yang sama seperti endpoint pencarian satu-IP.

Isi request

ips
Sebuah array berisi 1–100 string alamat IPv4/IPv6. Seluruh batch divalidasi sebelum satu pun pencarian dijalankan — satu alamat yang salah bentuk menggagalkan seluruh panggilan.

Error

400
Array ips kosong, lebih dari 100 IP, atau ada IP yang salah bentuk di mana pun dalam array-nya.
401
API key hilang atau tidak valid.
403
Publishable key digunakan, bukan secret key.
429
Rate limit terlampaui untuk jendela satu menit saat ini.

Contoh

Request

curl https://api.watch-ip.com/v1/lookup \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ips": ["203.0.113.1", "2001:db8::1"]}'

Respons

{
  "results": [
    { "ip": "203.0.113.1", "country": "US", "region": "TX", "city": "Austin", "postalCode": null, "latitude": 30.2672, "longitude": -97.7431, "continent": "NA", "timezone": null, "found": true },
    { "ip": "2001:db8::1", "country": null, "region": null, "city": null, "postalCode": null, "latitude": null, "longitude": null, "continent": null, "timezone": null, "found": false }
  ]
}

Batas

Setiap IP dalam batch ditagih dan dicatat secara individual — satu panggilan berisi 100 IP mencatat 100 event penggunaan pencarian, bukan satu. IP duplikat yang dikirim dua kali ditagih dua kali. Untuk rate limit per menit, seluruh panggilan dihitung sebagai satu request. Data lokasi untuk endpoint ini disediakan oleh DB-IP (IP Geolocation by DB-IP, db-ip.com — CC BY 4.0).

Halaman terkait