EasyAPI (1.0.0)

Download OpenAPI specification:Download

A Complete API to Gather Information About Your IP Address, Geolocation, Timezone detection and Timezone comparison

Explore a versatile platform that not only decodes IP addresses but also offers geolocation insights, detailed address data, timezone references, and a future roadmap packed with validators for IBAN, emails, phone numbers, and more.

A Complete API to Gather Information About Your IP Address, Geolocation, Timezone detection and Timezone comparison

Explore a versatile platform that not only decodes IP addresses but also offers geolocation insights, detailed address data, timezone references, and a future roadmap packed with validators for IBAN, emails, phone numbers, and more.

Introduction

Welcome to EasyAPI's documentation. Our platform serves as a powerful tool to not only gather in-depth details about IP addresses but also to delve into geolocation insights, fetch detailed address information, and reference timezones. As we constantly evolve, our roadmap promises the introduction of validators for IBANs, emails, phone numbers, and a plethora of other functionalities. This document is designed to be your comprehensive guide, walking you through API authentication, rate limits, and more. Catering to both veteran developers and newcomers alike, we aim to provide all the resources you'll need to maximize the benefits of the EasyAPI service.


Authentication

The use of EasyAPI requires authentication to ensure secure and efficient data retrieval.

How to obtain an API key

  1. Navigate to EasyAPI's Dashboard.
  2. If you're not already a member, create an account and select an appropriate membership. Each membership has its unique set of credits.
  3. Once logged in, you'll find your API key on the dashboard. This unique identifier is necessary for making requests to the EasyAPI endpoints.

Note: Keep your API key secure. If you believe your key has been compromised, you can regenerate a new key from the dashboard at any time.

How to use API key to make requests

To use the API key in making requests, simply append it to your GET query by using the api_key parameter.

Example Request:

GET https://api.easyapi.io/v1.0/ip?api_key=YOUR_API_KEY_HERE

Example Response:

{
  "class": "ip_info",
  "properties": {
    "city": "Verona",
    "country": "Italy",
    "country_code": "IT",
    "datetime": {
      "date": "01/03/2024",
      "date_time": "01/03/2024 14:20:55",
      "date_time_txt": "Wednesday, January 03, 2024 14:20:55",
      "date_time_wti": "Wed, 03 Jan 2024 14:20:55 +0100",
      "date_time_ymd": "2024-01-03T14:20:55+0100",
      "day": "03",
      "day_abbr": "Wed",
      "day_full": "Wednesday",
      "day_wilz": "03",
      "hour_12_wilz": "02",
      "hour_12_wolz": "2",
      "hour_24_wilz": "14",
      "hour_24_wolz": "14",
      "hour_am_pm": "pm",
      "minutes": "20",
      "month": "01",
      "month_abbr": "Jan",
      "month_days": "03",
      "month_full": "January",
      "month_wilz": "01",
      "seconds": "55",
      "time": "14:20:55",
      "week": "00",
      "year": "2024",
      "year_abbr": "24"
    },
    "ip": "82.84.2.2",
    "location": "45.4317,10.9859",
    "postal": "37138",
    "privacy_flags": { "isDataCenter": false, "isTor": false, "isVPN": false },
    "state": "Province of Verona",
    "state_code": "VR",
    "timezone": {
      "capital": "Rome",
      "continent": "EU",
      "country": "Italy",
      "country_code": "IT",
      "currency_alpha_code": "EUR",
      "currency_code": "978",
      "currency_country_minor_unit": "2",
      "currency_country_name": "ITALY",
      "currency_name": "Euro",
      "ds": "I",
      "edgar": "L6",
      "fifa": "ITA",
      "fips": "IT",
      "gaul": "122",
      "geoname_id": "3175395",
      "id": "Europe/Rome",
      "independent": true,
      "ioc": "ITA",
      "iso3166_1_alpha_2": "IT",
      "iso3166_1_alpha_3": "ITA",
      "itu": "I",
      "languages": "it-IT,de-IT,fr-IT,sc,ca,co,sl",
      "location": "41.9, 12.483333333333333",
      "marc": "it",
      "phone_prefix": "39",
      "tld": ".it",
      "un_m49_code": "380",
      "wmo": "IY"
    }
  }
}

Remember to replace YOUR_API_KEY_HERE with your actual API key.


Information about rate limits

To maintain the integrity and performance of the EasyAPI service, we've implemented a rate limit. This ensures that the service remains available to all users without any hitches.

  • Rate Limit: 500 requests/minute/ip address

If you exceed the rate limit, the API will respond with a 428 status. Please adhere to this limit to ensure uninterrupted service.


Thank you for choosing EasyAPI. For further assistance or queries, don't hesitate to reach out. Visit our detailed documentation at docs.easyapi.io.

/v1.0/ip?api_key=API_KEY

This endpoint allows you to get detailed information about your current IP address.

Authorizations:
ApiKeyAuth

Responses

Response samples

Content type
application/json
{
  • "class": "ip_info",
  • "properties": {
    }
}

/v1.0/ip/{ip}?api_key=API_KEY

This endpoint allows you to get detailed information about a specific IP address.

Authorizations:
ApiKeyAuth
path Parameters
ip
required
string

Responses

Response samples

Content type
application/json
{
  • "class": "ip_info",
  • "properties": {
    }
}

/v1.0/timezone?timezone=Europe/Vienna&api_key=API_KEY

This endpoint allows you to get detailed information about a specific timezone.

Authorizations:
ApiKeyAuth
query Parameters
timezone
string

Responses

Response samples

Content type
application/json
{
  • "class": "timezone_info",
  • "properties": {
    }
}

/v1.0/address?address=ADDRESS&api_key=API_KEY

This endpoint allows you to get detailed information about an address.

Authorizations:
ApiKeyAuth
query Parameters
address
string

Responses

Response samples

Content type
application/json
{
  • "class": "address_info",
  • "properties": [
    ]
}

/v1.0/compare?ip1=IP1&address2=ADDRESS2&api_key=API_KEY

This endpoint allows you to compare 2 ip addresses, compare 2 timezones, compare 2 addresses, compare 1 ip and 1 timezone, compare 1 ip and 1 address, compare 1 timezone and 1 address. As a result, you will get the difference in time between those 2 timezones as well as detailed information about those 2 locations.

Authorizations:
ApiKeyAuth
query Parameters
ip1
string
ip2
string
timezone1
string
timezone2
string
address1
string
address2
string

Responses

Response samples

Content type
application/json
{
  • "class": "compare",
  • "properties": {
    }
}