Référence de l'API de recherche d'IP

GET/v1/lookup/{ip}

Résout une seule adresse IPv4 ou IPv6 que vous fournissez, à l'aide d'une base de données tierce de géolocalisation IP et d'ASN — une source de données et une forme de réponse différentes de GET /v1/geo. Réservé aux appels serveur à serveur ; appelez-le depuis votre backend, jamais depuis un navigateur.

Authentification

Fournissez une clé secrète via Authorization: Bearer YOUR_SECRET_KEY. Contrairement à la clé publiable utilisée par GET /v1/geo, cette clé doit rester sur votre serveur — utiliser une clé publiable ici renvoie 403.

Champs de la réponse

ip: L'adresse IP que vous avez fournie, renvoyée telle quelle.
country, city, continent: Position approximative issue de la base de données source, ou null si indisponible.
region: Un code de subdivision (par ex. « TX »), pas un nom de région — une forme différente du champ region de GET /v1/geo.
postalCode, timezone: Non renseignés par la source de données actuelle — toujours null.
latitude, longitude: Coordonnées approximatives, ou null si indisponibles.
found: False lorsque l'IP n'a aucun enregistrement correspondant ou que la base de données sous-jacente est temporairement indisponible — les deux cas ne sont pas distingués dans ce champ.

Erreurs

400: L'IP fournie n'est pas une adresse IPv4 ou IPv6 valide.
401: Clé API manquante ou invalide.
403: Une clé publiable a été utilisée au lieu d'une clé secrète.
429: Limite de débit dépassée pour la fenêtre d'une minute en cours.

Exemple

Requête

curl https://api.watch-ip.com/v1/lookup/203.0.113.1 \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

Réponse

{
  "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
}

Limites

Facturé par IP recherchée, indépendamment du volume de requêtes de votre forfait de géolocalisation du visiteur — voir la page produit de recherche d'IP pour la tarification et la disponibilité. Besoin de plus d'une IP par appel ? Utilisez plutôt le point de terminaison groupé. Les données de localisation de ce point de terminaison sont fournies par DB-IP (IP Geolocation by DB-IP, db-ip.com — CC BY 4.0).