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.

Last updated