IP Lookup

Here is an example API documentation for the endpoint used for IP Lookup.

REQUEST

Endpoint

https://stopbot.net/api/iplookup?apikey={APIKEY}&ip={IP}

Method

GET

Parameters

  • apikey (string, required): The API key provided to the user.
  • ip (string, required): The IP address of the visitor.

Example Request

curl "https://stopbot.net/api/iplookup?apikey=9ca6f45b2e9821b3a964c0f79cb67dc3&ip=1.1.1.1"

Example Response

Success Response

If the HTTP response is 200 (success response), it will generate the following response:
{
"ip": "1.1.1.1",
"hostname": "",
"asn": 13335,
"company": "Cloudflare, Inc.",
"isp": "Cloudflare, Inc.",
"city": "Marble Bar",
"district": "East Pilbara",
"region": "Western Australia",
"postcode": "",
"country": "Australia",
"countryCode": "AU",
"latitude": -20.5,
"longitude": 120.15,
"timezone": "Australia\/Perth",
"status": "success",
"timeResponse": "2023-07-21 03:55:57"
}

Description on successful response

  • hostname: The visitor's hostname.
  • asn: The Autonomous System Number (ASN) that identifies the internet service provider.
  • company: The company associated with the visitor's IP.
  • isp: The Internet Service Provider (ISP) name.
  • city: The city where the visitor is located.
  • district: The district or area associated with the IP address.
  • region: The region where the visitor is located.
  • postcode: The postal code associated with the IP address.
  • country: The country where the visitor is located.
  • countryCode: The ISO-3166 alpha-2 country code.
  • latitude: The latitude coordinate of the IP address location.
  • longitude: The longitude coordinate of the IP address location.
  • timezone: The timezone of the IP address location.

Failed Response

If the HTTP response is 400 or 401 (failed response), it will generate the following response:
{
"status": "failed",
"timeResponse": "2023-06-8 23:00"
}

Description on failed response:

  • status: Response Status: The value is "failed" if the request fails.
  • timeResponse: Date and time when the response was sent.