Zoek een IP-adres op vanaf je backend

Herleid een opgegeven IP-adres naar beschikbare land-, regio-, stad- en geschatte coördinaatgegevens. De IP-lookup-API van Watch-IP accepteert IPv4- en IPv6-invoer en geeft een JSON-resultaat terug op basis van een IP-geolocatiedatabase van een externe partij. Gebruik een geheime API-sleutel op je server, en bouw je applicatie rond expliciete matches, ontbrekende records en velden die null kunnen zijn.

Bekijk lookup-abonnementen Bespreek toegang tot lookup →

Geef het adres op dat je wilt herleiden

Roep GET /v1/lookup/{ip} aan met een IP-adres dat door je applicatie is verzameld, geauthenticeerd met Authorization: Bearer en een geheime sleutel. De lookup herleidt het adres in de URL in plaats van de verbinding die is gebruikt om het verzoek te doen, wat het geschikt maakt voor backend-workflows die al IP-adressen bevatten, waaronder rapportage en regionale verrijking. Controleer hoe je applicatie het IP-adres van een eindgebruiker verkrijgt voordat je op doorgestuurde headers vertrouwt; vertrouw alleen het proxypad dat je zelf beheert. Voor een gewone websitebezoekersintegratie biedt het browsergeolocatie-endpoint een ander pad met een publiceerbare sleutel en regionale verrijking.

Van één adres naar een batch

Als je workflow meerdere IP-adressen bevat, accepteert het batch-endpoint er tot 100 in één verzoek en geeft resultaten in dezelfde volgorde terug. Het gebruikt dezelfde vorm van het lookupresultaat en hetzelfde authenticatiemodel met een geheime sleutel aan de serverkant. Batchen verandert hoe je de verzoeken verstuurt — het lookupgebruik wordt nog steeds per IP gemeten, dus één batch is geen eenheid van lookupgebruik.

Bouw rond geschatte gegevens

Een IP kan een gedeelde gateway, hostingnetwerk, VPN-exit of mobiele providerverbinding vertegenwoordigen. Locatierecords kunnen onvolledig zijn of verschillen tussen gegevensleveranciers. Gebruik lookup als context voor het door jou opgegeven adres, geen bewijs van de woonplaats of identiteit van een persoon.

Velden in het antwoord

ip: Het invoeradres dat bij dit resultaat hoort.
found: Of er een overeenkomend databaserecord is gevonden. False kan ook betekenen dat de database niet beschikbaar is of niet is geladen — het bewijst niet dat het adres geen locatiegegevens heeft.
country, continent: Land- en continentcodes, indien beschikbaar.
region: Een subdivisie-identificatie uit de huidige koppeling, niet altijd een volledige regionaam.
city, latitude, longitude: Geschatte stad en coördinaten, indien beschikbaar in de brondatabase.
postalCode, timezone: Niet ingevuld door de huidige brondatabase — altijd null.

Doe een server-side verzoek

cURL — GET /v1/lookup/{ip}

curl --fail-with-body \
  'https://api.watch-ip.com/v1/lookup/8.8.8.8' \
  --header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}"

Stel eerst WATCH_IP_SECRET_KEY in de omgeving van je server in. 8.8.8.8 is een syntactisch geldig voorbeeldadres; dit fragment belooft geen specifiek land, stad of antwoord ervoor.

Veelgestelde vragen

Kan ik deze API gebruiken om het IP-adres van iemand anders op te zoeken?

Het endpoint accepteert een opgegeven IP-adres en geeft beschikbare locatiegegevens uit de database terug, geen naam, exact adres of identiteit van een persoon. Gebruik alleen gegevens die je bevoegd bent te verwerken.

Ondersteunt het IPv6?

Het endpoint valideert IPv4- en IPv6-invoer. Een geldig adres kan nog steeds geen databaserecord of sommige locatievelden hebben.

Bevat lookup tijdzone, ASN of VPN-detectie?

Nee. Het huidige lookupantwoord bevat geen ASN of beveiligingsindicatoren, en de bron, een database van een externe partij, vult geen tijdzone- of postcodevelden in. Bekijk bezoekersgeolocatie apart als het model van de verbindende client daarbij past.

Kan ik het verzoek vanuit browser-JavaScript versturen?

Nee — stel een geheime lookupsleutel nooit bloot in browsercode. Doe lookup-aanroepen vanaf je backend, en gebruik het bezoekers-endpoint met een publiceerbare sleutel voor directe browsergeolocatie.

Is dit inbegrepen bij een gratis bezoekerssleutel?

Nee. Lookup gebruikt een aparte geheime sleutel en abonnementsfamilie; het gratis bezoekersabonnement geeft geen toegang tot server-side lookup.

Wat betekent found: false?

De lookup gaf geen overeenkomend record terug. In de huidige implementatie kan dit ook gebeuren wanneer de database niet beschikbaar is of niet is geladen, dus toon "Locatie niet beschikbaar" en houd dit resultaat gescheiden van ongeldige invoer, authenticatiefouten en ratelimietfouten.