Rechercher des adresses IP par lots
Envoyez une liste d'adresses IP à un seul point de terminaison et recevez une liste correspondante de résultats de localisation. L'API de recherche d'IP groupée de Watch-IP accepte jusqu'à 100 adresses IPv4 et IPv6 par requête pour les traitements d'enrichissement backend. Conservez votre clé secrète sur le serveur, traitez la réponse dans l'ordre d'entrée, et gérez les enregistrements manquants sans perdre le lien avec vos données d'origine.
Une requête, jusqu'à 100 adresses
Utilisez POST /v1/lookup avec un objet JSON contenant un tableau ips. Chaque lot accepté contient au moins une adresse et au plus 100, et vous pouvez mélanger des adresses IPv4 et IPv6 valides dans la même liste. La réponse enveloppe les résultats de recherche ordonnés dans un tableau results ; chaque résultat utilise la même forme que la recherche d'IP unique, y compris found et les champs de localisation pouvant être null.
Garder les résultats alignés avec vos enregistrements source
Pour un lot réussi, l'API renvoie un résultat pour chaque adresse d'entrée, dans le même ordre. Conservez vos propres identifiants d'enregistrement à côté de la liste soumise afin de pouvoir rattacher les résultats à vos lignes d'origine. Quand un enregistrement n'est pas trouvé, conservez la ligne et marquez la localisation comme indisponible ; quand seul un champ manque, conservez le reste du résultat. Ne remplacez pas des coordonnées manquantes par zéro, ce qui transformerait une absence de donnée en un emplacement trompeur sur une carte.
Valider avant de soumettre
Une liste vide, une liste de plus de 100 adresses ou une IP mal formée produit une erreur de requête — une adresse mal formée rejette l'ensemble du lot plutôt que de produire un résultat partiellement réussi pour les autres entrées. Validez les entrées et découpez les listes plus longues en lots avant de les envoyer, et conservez un suivi des lots déjà traités pour qu'une nouvelle tentative ne répète pas accidentellement une tâche entière.
Comprendre ce que le regroupement en lot change
Le regroupement en lot réduit le nombre de requêtes HTTP nécessaires pour soumettre une liste. Il ne change pas la source de données, n'ajoute pas de champs de sécurité et ne transforme pas 100 recherches en une seule unité d'usage — l'usage de recherche est enregistré par IP soumise sur les requêtes acceptées, donc le choix du forfait doit tenir compte à la fois du volume total de recherches et du débit de requêtes. La limite de débit par minute compte les appels HTTP, pas les éléments : un lot de jusqu'à 100 IP ou adresses e-mail compte pour une seule requête, tandis que chaque élément compte toujours séparément dans le plafond mensuel de requêtes.
Forme de la requête et de la réponse
- ips
- Corps de la requête : un tableau JSON de 1 à 100 adresses IPv4 ou IPv6.
- results
- Réponse : un tableau ordonné avec une entrée par adresse d'entrée, dans l'ordre soumis.
- results[].found, results[].country, ...
- Chaque résultat utilise la même forme et les mêmes règles de nullabilité que la réponse de recherche d'IP unique — voir la page produit de recherche d'IP.
Envoyer une requête groupée
cURL — POST /v1/lookup
curl --fail-with-body \
'https://api.watch-ip.com/v1/lookup' \
--header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}" \
--header 'Content-Type: application/json' \
--data '{"ips":["8.8.8.8","2001:4860:4860::8888"]}'Ces adresses de démonstration n'impliquent aucune valeur de localisation particulière. Définissez d'abord WATCH_IP_SECRET_KEY dans l'environnement de votre serveur.
Questions fréquentes
Combien d'adresses IP tiennent dans un lot ?
Le maximum actuel est de 100. Découpez les listes plus longues en requêtes contenant chacune de 1 à 100 adresses.
Un lot peut-il contenir à la fois de l'IPv4 et de l'IPv6 ?
Oui. Chaque adresse doit être valide, et la couverture de la base peut varier selon l'adresse.
Les résultats sont-ils renvoyés dans l'ordre d'entrée ?
Oui. Un lot accepté et réussi renvoie un résultat par adresse d'entrée, dans le même ordre.
Que se passe-t-il si une IP est mal formée ?
L'ensemble de la requête est rejeté. Validez vos entrées avant de les soumettre — ce point de terminaison ne fournit pas de succès partiel en cas d'entrée mal formée.
Un lot est-il facturé comme une seule recherche ?
Non. L'usage est mesuré par IP. Consultez la tarification de recherche actuelle et des exemples de facturation vérifiés avant d'estimer le coût d'une tâche volumineuse.
Puis-je importer un fichier CSV ?
Le point de terminaison documenté accepte un tableau JSON d'adresses. Votre application peut lire son propre CSV et soumettre des lots ; une interface hébergée d'import CSV ne fait pas partie de cette API.
La recherche groupée inclut-elle des vérifications VPN ou Tor ?
Non. La réponse groupée actuelle correspond au résultat de localisation d'une base de données tierce de géolocalisation. Les indicateurs de sécurité de la géolocalisation du visiteur constituent une capacité distincte, absente des réponses de recherche.