Skip to content
/ ip-address-lookup Public

IP address lookup by troubleshootings.tools shows the public-facing IPv4 address by visiting the webpage with related information such as location, ISP, PTR record and much more. There are a variety of display options, starting on the web page itself, a preview of the link shared through a messenger or similar, or via API on a different web page…

troubleshooting.tools/lookup/ip/
0 stars 0 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

disisto/ip-address-lookup

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
img
img
 
 
README.md
README.md
 
 

Repository files navigation

IP Address Lookup

IP address lookup by troubleshootings.tools shows the public-facing IPv4 address by visiting the webpage with related information such as location, ISP, PTR record and much more. There are a variety of display options, starting on the web page itself, a preview of the link shared through a messenger or similar, or via API on a different web page or app.

Content

  1. ) Web page
  2. ) Webhook
  3. ) Open Graph
  4. ) OpenSearch
  5. ) HTML search form
  6. ) API
  7. ) Limitations and caveats

1.) Web page

Explore your own public-facing IPv4 address

  1. Visit with a web browser https://troubleshooting.tools/lookup/ip/
  2. The page already display your public-facing IP address including all related informations

Explore any other public IPv4 address

  1. Visit with a web browser https://troubleshooting.tools/lookup/ip/
  2. Enter an IP address in the search form
  3. Hit enter key or submit button

2.) Webhook

Beside the classic form input on the web page, the web page supports also webhooks. This possibility is ideal to share a link and guide the recipient directly to the results.

URL: https://troubleshooting.tools/lookup/ip/ {ipv4_address}

Example: https://troubleshooting.tools/lookup/ip/8.8.4.4

3.) Open Graph

Sharing the Webhook link into a web page or app that support the Open Graph protocol gives the opportunity to share a small excerpt of the results, without that the recipient need to visit the webpage itself.

Examples

Slack:

Discord:

Mattermost:

WhatsApp:

Telegram:

Twitter:

4.) Open Search

The browser integration of troubleshooting.tools allows to use the browser address bar as a search input field, when needed, without visiting the original web page before.

This function is called OpenSearch and works with Apple Safari, Microsoft Edge, Mozilla Firefox and Google Chrome. Before we can start using it, we have to setup our browser for this function. Here an example for Google Chrome:

At the top right, click More and then Settings.

Under "Search engine," click Manage search engines.

To the right of "Other search engines," click Add.

Fill out the text fields as shown below and click Add.

Search engine:
Enter troubleshooting.tools or a name of your choice.

Keyword:
Enter the character "t" or a keyword of your choice, to trigger later the search function.

URL with %s in place of query:
https://troubleshooting.tools/lookup/ip/%s






The setup is complete. You are still able to continue to enter a URL in the address bar or any search terms that trigger a Google search.

The new feature is, if you enter an "t" followed by a space, then you activate the troubleshooting.tools search.

This cause that Google Chrome address bar react like the search field on this website.

5.) HTML search form

To integrate the search bar into a different web page a few line are needed. The look and feel can be adjusted as desired.

<form method="post" action="https://troubleshooting.tools/lookup/ip/">
  <input type="text" name="ip" placeholder="">
  <input type="submit" value="&#128269;">
</form>

6.) API

The API allows to integrate the results of the IP Address Lookup results on a different web page or app. Different formats and level of outputs are available, which can be adjust based on the need.

Format Level URL Output
Plaintext 0 https://api.troubleshooting.tools/lookup/ip/ {ipv4_address} IP Address
JSON 0 https://api.troubleshooting.tools/lookup/ip/json/ {ipv4_address} IP Address, PTR Record
JSON 0 https://api.troubleshooting.tools/lookup/ip/json/lvl0/ {ipv4_address} IP Address, PTR Record
JSON 1 https://api.troubleshooting.tools/lookup/ip/json/lvl1/ {ipv4_address} IP Address, PTR Record, Country code/name, Region name, City Name, Latitude, Longitude
JSON 2 https://api.troubleshooting.tools/lookup/ip/json/lvl2/ {ipv4_address} IP Address, PTR Record, Country code/name, Region name, City Name, Latitude, Longitude, ISP, RIR, Network Range, CIDR, Name, Handle, Autonomous System (AS)

Plaintext Example:

Endpoint: "Automatic discovery"
https://api.troubleshooting.tools/lookup/ip/
Example Request:
curl -X GET https://api.troubleshooting.tools/lookup/ip/
Example Response:
102.216.69.156
Endpoint: "IP Address Lookup"
https://api.troubleshooting.tools/lookup/ip/{ipaddress}
Example Request:
curl -X GET https://api.troubleshooting.tools/lookup/ip/8.8.4.4
Example Response:
8.8.4.4
Example Response, when IP Address is invalid:
Invalid IP address
Example Response, when IP address is not public and therefore reserved:
Reserved IP address

JSON Example:

Endpoint: "Automatic discovery"
https://api.troubleshooting.tools/lookup/ip/json/
Example Request:
curl -X GET https://api.troubleshooting.tools/lookup/ip/json/
Example Response:
{
  "ip": "102.216.69.156",
  "invalid": false,
  "reserved": false,
  "ptr_record": "No PTR record found"
}
Endpoint: "IP Address Lookup"
https://api.troubleshooting.tools/lookup/ip/json/{ipaddress}
Example Request:
curl -X GET https://api.troubleshooting.tools/lookup/ip/json/8.8.4.4
Example Response:
{
  "ip": "8.8.4.4",
  "invalid": false,
  "reserved": false,
  "ptr_record": "dns.google"
}
Example Response, when IP Address is invalid:
{
  "ip": "8.8.4.256",
  "invalid": true,
  "reserved": false
}
Example Response, when IP address is not public and therefore reserved:
{
  "ip": "192.168.1.1",
  "invalid": false,
  "reserved": true,
  "additional_context": {
    "address_block": "192.168.0.0/16",
    "name": "Private-Use",
    "rfc": "RFC1918",
    "allocation_date": "1996-02"
  }
}
Endpoint: "Automatic discovery" Level 1
https://api.troubleshooting.tools/lookup/ip/json/lvl1/
Example Request:
curl -X GET https://api.troubleshooting.tools/lookup/ip/json/lvl1/
Example Response:
{
  "ip": "102.216.69.156",
  "invalid": false,
  "reserved": false,
  "ptr_record": "No PTR record found",
  "location_data": {
    "ipVersion": 4,
    "ipAddress": "102.216.69.156",
    "latitude": -1.28333,
    "longitude": 36.816669,
    "countryName": "Kenya",
    "countryCode": "KE",
    "timeZone": "+03:00",
    "zipCode": "-",
    "cityName": "Nairobi",
    "regionName": "Nairobi City"
  }
}
Endpoint: "IP Address Lookup"
https://api.troubleshooting.tools/lookup/ip/json/lvl1/{ipaddress}
Example Request:
curl -X GET https://api.troubleshooting.tools/lookup/ip/json/lvl1/8.8.4.4
Example Response:
{
  "ip": "8.8.4.4",
  "invalid": false,
  "reserved": false,
  "ptr_record": "dns.google",
  "location_data": {
    "ipVersion": 4,
    "ipAddress": "8.8.4.4",
    "latitude": 37.386051,
    "longitude": -122.083847,
    "countryName": "United States of America",
    "countryCode": "US",
    "timeZone": "-07:00",
    "zipCode": "94035",
    "cityName": "Mountain View",
    "regionName": "California"
  }
}
Example Response, when IP Address is invalid:
{
  "ip": "8.8.4.256",
  "invalid": true,
  "reserved": false
}
Example Response, when IP address is not public and therefore reserved:
{
  "ip": "192.168.1.1",
  "invalid": false,
  "reserved": true,
  "additional_context": {
    "address_block": "192.168.0.0/16",
    "name": "Private-Use",
    "rfc": "RFC1918",
    "allocation_date": "1996-02"
  }
}
Endpoint: "Automatic discovery" Level 2
https://api.troubleshooting.tools/lookup/ip/json/lvl2/
Example Request:
curl -X GET https://api.troubleshooting.tools/lookup/ip/json/lvl2/
Example Response:
{
  "ip": "102.216.69.156",
  "invalid": false,
  "reserved": false,
  "ptr_record": "No PTR record found",
  "location_data": {
    "ipVersion": 4,
    "ipAddress": "102.216.69.156",
    "latitude": -1.28333,
    "longitude": 36.816669,
    "countryName": "Kenya",
    "countryCode": "KE",
    "timeZone": "+03:00",
    "zipCode": "-",
    "cityName": "Nairobi",
    "regionName": "Nairobi City"
  },
  "registry_data": {
    "rir": "AFRINIC",
    "netRange": "102.216.68.0 - 102.216.69.255",
    "cidr": "102.216.68.0/23",
    "name": "not provided",
    "handle": "102.216.68.0 - 102.216.69.255",
    "parent": "102.216.68.0 - 102.216.71.255",
    "netType": "ASSIGNED PA",
    "originAS": "not provided",
    "lastChanged": "Thu, 23 Nov 2023 06:40:00 GMT",
    "remark": "not provided",
    "isp": "not provided",
    "country": "KE",
    "address": "Airtel Networks Kenya Limited, Nairobi, Other",
    "source": "https://search.arin.net/rdap/?query=102.216.69.156"
  }
}
Endpoint: "IP Address Lookup"
https://api.troubleshooting.tools/lookup/ip/json/lvl2/{ipaddress}
Example Request:
curl -X GET https://api.troubleshooting.tools/lookup/ip/json/lvl2/8.8.4.4
Example Response:
{
  "ip": "8.8.4.4",
  "invalid": false,
  "reserved": false,
  "ptr_record": "dns.google",
  "location_data": {
    "ipVersion": 4,
    "ipAddress": "8.8.4.4",
    "latitude": 37.386051,
    "longitude": -122.083847,
    "countryName": "United States of America",
    "countryCode": "US",
    "timeZone": "-07:00",
    "zipCode": "94035",
    "cityName": "Mountain View",
    "regionName": "California"
  },
  "registry_data": {
    "rir": "ARIN",
    "netRange": "8.8.4.0 - 8.8.4.255",
    "cidr": "8.8.4.0/24",
    "name": "GOGL",
    "handle": "NET-8-8-4-0-2",
    "parent": "NET-8-0-0-0-0",
    "netType": "DIRECT ALLOCATION",
    "originAS": "not provided",
    "lastChanged": "Thu, 28 Dec 2023 22:24:56 GMT",
    "remark": "not provided",
    "isp": "Google LLC",
    "country": "not provided",
    "address": "1600 Amphitheatre Parkway, Mountain View, CA, 94043, United States",
    "source": "https://search.arin.net/rdap/?query=8.8.4.4"
  }
}
Example Response, when IP Address is invalid:
{
  "ip": "8.8.4.256",
  "invalid": true,
  "reserved": false
}
Example Response, when IP address is not public and therefore reserved:
{
  "ip": "192.168.1.1",
  "invalid": false,
  "reserved": true,
  "additional_context": {
    "address_block": "192.168.0.0/16",
    "name": "Private-Use",
    "rfc": "RFC1918",
    "allocation_date": "1996-02"
  }
}

Error handling:

  • Invalid IP address
    • Every input that can't be identified as IPv4 address will trigger an error message.
  • Reserved IP address
    • Address Blocks that matches with the following list will trigger an error message.
  • HTTP 429: Too Many Requests
    • Rate limit: 250 requests per second.
    • This limit may be adjusted without prior notice based on server resource demand.

7.) Limitations and caveats

IPv6

  • IPv6 detection is not supported.
  • IPv6 lookup support is considered, but not planned.

All mentioned trademarks are the property of their respective owners.

About

IP address lookup by troubleshootings.tools shows the public-facing IPv4 address by visiting the webpage with related information such as location, ISP, PTR record and much more. There are a variety of display options, starting on the web page itself, a preview of the link shared through a messenger or similar, or via API on a different web page…

troubleshooting.tools/lookup/ip/

Topics

api ip-address ip ip-address-location ip-address-geolocation ip-address-lookup ip-address-web-service ip-address-tool ip-address-information-getting

Resources

Readme
Activity

Stars

0 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published