apifreaks 1.0.3 → 1.0.4

data/reference.md

@@ -105,6 +105,116 @@ client.geolocation_lookup(api_key: "apiKey")
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.<a href="/lib/apifreaks/client.rb">geolocation_lookup_v2</a>() -> Apifreaks::Types::GeolocationLookupResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get detailed geolocation data for an IP address using the `v2.0/geolocation/lookup` endpoint including country, city, timezone, currency, and optional security and user-agent information
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.geolocation_lookup_v2(api_key: "apiKey")
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**api_key:** `String` — Your API key
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**format:** `Apifreaks::Types::GeolocationLookupRequestFormat` — Format of the response.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**ip:** `String` — IPv4, IPv6, or hostname for geolocation lookup
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**lang:** `Apifreaks::Types::GeolocationLookupRequestLang` — Response language for location fields
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**fields:** `String` — Comma separated list of fields to include in response
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**excludes:** `String` — Comma separated list of fields to exclude from response
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**include:** `String` — Additional data to include (location, network, security, currency, time_zone, user_agent, country_metadata , hostname, liveHostname, hostnameFallbackLivet)
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `Apifreaks::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -219,6 +329,120 @@ client.bulk_geolocation_lookup(
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.<a href="/lib/apifreaks/client.rb">bulk_geolocation_lookup_v2</a>(request) -> Internal::Types::Array[Apifreaks::Types::BulkGeolocationLookupResponseItem]</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Retrieve detailed geolocation data for multiple IP addresses in a single request using the `v2.0/geolocation/lookup` endpoint.
+Supports up to `50,000` IP-addresses/host-names per request.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.bulk_geolocation_lookup_v2(
+  api_key: "apiKey",
+  ips: ["ips"]
+)
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**api_key:** `String` — Your API key
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**format:** `Apifreaks::Types::BulkGeolocationLookupRequestFormat` — Format of the response.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**lang:** `String` — Language of the response.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**fields:** `String` — Comma-separated list of fields to include in the response. Can include "geo".
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**excludes:** `String` — Comma-separated list of fields to exclude from the response (except "ip").
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**include:** `String` — Comma-separated list of additional information to include in the response.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**ips:** `Internal::Types::Array[String]` — List of IP addresses or hostnames to lookup
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `Apifreaks::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -459,7 +683,153 @@ client.geocoder_search(
 <dl>
 <dd>
 
-**api_key:** `String` — Your API key
+**api_key:** `String` — Your API key
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**format:** `Apifreaks::Types::GeocoderSearchRequestFormat` — Format of the response.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**query:** `String` — Free-form search query, e.g. Wembley Stadium, London
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**limit:** `Integer` — Max number of results to return (1–40). May return fewer if matches are weak.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**min_lat:** `Integer` — Minimum latitude for the viewbox. Must be ≤ max_lat and between -90 and 90.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**max_lat:** `Integer` — Maximum latitude for the viewbox. Must be ≥ min_lat and between -90 and 90.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**min_lon:** `Integer` — Minimum longitude for the viewbox. Must be ≤ max_lon and between -180 and 180.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**max_lon:** `Integer` — Maximum longitude for the viewbox. Must be ≥ min_lon and between -180 and 180.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**accept_language:** `String` — Preferred language order for showing search results. This may either be a simple comma-separated list of language codes or a single entry. The results will be in the 1st language which is matched from the header. As a fallback if the results are not supported in the given language, 'en' will be used.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `Apifreaks::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.<a href="/lib/apifreaks/client.rb">geocoder_reverse</a>() -> Apifreaks::Types::GeocoderReverseResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Convert geographic coordinates (latitude and longitude) into a human-readable address or place name.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.geocoder_reverse(
+  api_key: "apiKey",
+  lat: 1.1,
+  lon: 1.1
+)
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**api_key:** `String` — Your API key
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**format:** `Apifreaks::Types::GeocoderReverseRequestFormat` — Format of the response.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**lat:** `Integer` — WGS84 latitude value ranging from -90 to 90.
     
 </dd>
 </dl>
@@ -467,7 +837,7 @@ client.geocoder_search(
 <dl>
 <dd>
 
-**format:** `Apifreaks::Types::GeocoderSearchRequestFormat` — Format of the response.
+**lon:** `Integer` — WGS84 longitude value ranging from -180 to 180.
     
 </dd>
 </dl>
@@ -475,7 +845,7 @@ client.geocoder_search(
 <dl>
 <dd>
 
-**query:** `String` — Free-form search query, e.g. Wembley Stadium, London
+**accept_language:** `String` — Preferred language order for showing search results. This may either be a simple comma-separated list of language codes or a single entry. The results will be in the 1st language which is matched from the header. As a fallback if the results are not supported in the given language, en will be used.
     
 </dd>
 </dl>
@@ -483,31 +853,66 @@ client.geocoder_search(
 <dl>
 <dd>
 
-**limit:** `Integer` — Max number of results to return (1–40). May return fewer if matches are weak.
+**request_options:** `Apifreaks::RequestOptions` 
     
 </dd>
 </dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.<a href="/lib/apifreaks/client.rb">domain_whois_lookup</a>() -> Apifreaks::Types::DomainWhoisLookupResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
 
 <dl>
 <dd>
 
-**min_lat:** `Integer` — Minimum latitude for the viewbox. Must be ≤ max_lat and between -90 and 90.
-    
+<dl>
+<dd>
+
+Retrieve current WHOIS information for a domain name.
+This endpoint provides detailed registration information including registrar details,
+dates, nameservers, and registrant information.
+</dd>
+</dl>
 </dd>
 </dl>
 
+#### 🔌 Usage
+
 <dl>
 <dd>
 
-**max_lat:** `Integer` — Maximum latitude for the viewbox. Must be ≥ min_lat and between -90 and 90.
-    
+<dl>
+<dd>
+
+```ruby
+client.domain_whois_lookup(
+  api_key: "apiKey",
+  domain_name: "domainName"
+)
+```
 </dd>
 </dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
 
 <dl>
 <dd>
 
-**min_lon:** `Integer` — Minimum longitude for the viewbox. Must be ≤ max_lon and between -180 and 180.
+<dl>
+<dd>
+
+**api_key:** `String` — Your API key
     
 </dd>
 </dl>
@@ -515,7 +920,7 @@ client.geocoder_search(
 <dl>
 <dd>
 
-**max_lon:** `Integer` — Maximum longitude for the viewbox. Must be ≥ min_lon and between -180 and 180.
+**format:** `Apifreaks::Types::DomainWhoisLookupRequestFormat` — Response format (defaults to json)
     
 </dd>
 </dl>
@@ -523,7 +928,7 @@ client.geocoder_search(
 <dl>
 <dd>
 
-**accept_language:** `String` — Preferred language order for showing search results. This may either be a simple comma-separated list of language codes or a single entry. The results will be in the 1st language which is matched from the header. As a fallback if the results are not supported in the given language, 'en' will be used.
+**domain_name:** `String` — Domain name for WHOIS lookup
     
 </dd>
 </dl>
@@ -543,7 +948,7 @@ client.geocoder_search(
 </dl>
 </details>
 
-<details><summary><code>client.<a href="/lib/apifreaks/client.rb">geocoder_reverse</a>() -> Apifreaks::Types::GeocoderReverseResponse</code></summary>
+<details><summary><code>client.<a href="/lib/apifreaks/client.rb">domain_whois_lookup_v2</a>() -> Apifreaks::Types::DomainWhoisLookupResponse</code></summary>
 <dl>
 <dd>
 
@@ -555,7 +960,9 @@ client.geocoder_search(
 <dl>
 <dd>
 
-Convert geographic coordinates (latitude and longitude) into a human-readable address or place name.
+Retrieve current WHOIS information for a domain name using the `v2.0/domain/whois/live` endpoint.
+This endpoint provides detailed registration information including registrar details,
+dates, nameservers, and registrant information.
 </dd>
 </dl>
 </dd>
@@ -570,10 +977,9 @@ Convert geographic coordinates (latitude and longitude) into a human-readable ad
 <dd>
 
 ```ruby
-client.geocoder_reverse(
+client.domain_whois_lookup_v2(
   api_key: "apiKey",
-  lat: 1.1,
-  lon: 1.1
+  domain_name: "domainName"
 )
 ```
 </dd>
@@ -597,23 +1003,7 @@ client.geocoder_reverse(
 <dl>
 <dd>
 
-**format:** `Apifreaks::Types::GeocoderReverseRequestFormat` — Format of the response.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**lat:** `Integer` — WGS84 latitude value ranging from -90 to 90.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**lon:** `Integer` — WGS84 longitude value ranging from -180 to 180.
+**format:** `Apifreaks::Types::DomainWhoisLookupRequestFormat` — Response format (defaults to json)
     
 </dd>
 </dl>
@@ -621,7 +1011,7 @@ client.geocoder_reverse(
 <dl>
 <dd>
 
-**accept_language:** `String` — Preferred language order for showing search results. This may either be a simple comma-separated list of language codes or a single entry. The results will be in the 1st language which is matched from the header. As a fallback if the results are not supported in the given language, en will be used.
+**domain_name:** `String` — Domain name for WHOIS lookup
     
 </dd>
 </dl>
@@ -641,7 +1031,7 @@ client.geocoder_reverse(
 </dl>
 </details>
 
-<details><summary><code>client.<a href="/lib/apifreaks/client.rb">domain_whois_lookup</a>() -> Apifreaks::Types::DomainWhoisLookupResponse</code></summary>
+<details><summary><code>client.<a href="/lib/apifreaks/client.rb">bulk_domain_whois_lookup</a>(request) -> Apifreaks::Types::BulkDomainWhoisLookupResponse</code></summary>
 <dl>
 <dd>
 
@@ -653,9 +1043,7 @@ client.geocoder_reverse(
 <dl>
 <dd>
 
-Retrieve current WHOIS information for a domain name.
-This endpoint provides detailed registration information including registrar details,
-dates, nameservers, and registrant information.
+Retrieve WHOIS information for `100 Domains per Request`.
 </dd>
 </dl>
 </dd>
@@ -670,9 +1058,9 @@ dates, nameservers, and registrant information.
 <dd>
 
 ```ruby
-client.domain_whois_lookup(
+client.bulk_domain_whois_lookup(
   api_key: "apiKey",
-  domain_name: "domainName"
+  domain_names: ["domainNames"]
 )
 ```
 </dd>
@@ -696,7 +1084,7 @@ client.domain_whois_lookup(
 <dl>
 <dd>
 
-**format:** `Apifreaks::Types::DomainWhoisLookupRequestFormat` — Response format (defaults to json)
+**format:** `Apifreaks::Types::BulkDomainWhoisLookupRequestFormat` — Format of the response.
     
 </dd>
 </dl>
@@ -704,7 +1092,7 @@ client.domain_whois_lookup(
 <dl>
 <dd>
 
-**domain_name:** `String` — Domain name for WHOIS lookup
+**domain_names:** `Internal::Types::Array[String]` — A list of domain names for which WHOIS data is requested.
     
 </dd>
 </dl>
@@ -724,7 +1112,7 @@ client.domain_whois_lookup(
 </dl>
 </details>
 
-<details><summary><code>client.<a href="/lib/apifreaks/client.rb">bulk_domain_whois_lookup</a>(request) -> Apifreaks::Types::BulkDomainWhoisLookupResponse</code></summary>
+<details><summary><code>client.<a href="/lib/apifreaks/client.rb">bulk_domain_whois_lookup_v2</a>(request) -> Apifreaks::Types::BulkDomainWhoisLookupResponse</code></summary>
 <dl>
 <dd>
 
@@ -736,7 +1124,7 @@ client.domain_whois_lookup(
 <dl>
 <dd>
 
-Retrieve WHOIS information for `100 Domains per Request`.
+Retrieve WHOIS information for `100 Domains per Request` using the `v2.0/domain/whois/live` endpoint.
 </dd>
 </dl>
 </dd>
@@ -751,7 +1139,7 @@ Retrieve WHOIS information for `100 Domains per Request`.
 <dd>
 
 ```ruby
-client.bulk_domain_whois_lookup(
+client.bulk_domain_whois_lookup_v2(
   api_key: "apiKey",
   domain_names: ["domainNames"]
 )
@@ -10413,7 +10801,166 @@ client.get_admin_unit_details(
 </dd>
 </dl>
 
-#### ⚙️ Parameters
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**api_key:** `String` — Your API key
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**format:** `Apifreaks::Types::GetAdminUnitDetailsRequestFormat` — Format of the response.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**country:** `String` — Country code in ISO 3166-1 alpha-2 format.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**admin_unit:** `String` — Optional admin code to fetch details for a specific administrative unit.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `Apifreaks::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.<a href="/lib/apifreaks/client.rb">get_cities</a>() -> Apifreaks::Types::GetCitiesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Retrieve a list of cities within a country, optionally filtered by an administrative unit code.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.get_cities(
+  api_key: "apiKey",
+  country: "country"
+)
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**api_key:** `String` — Your API key
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**format:** `Apifreaks::Types::GetCitiesRequestFormat` — Format of the response.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**country:** `String` — Country code in ISO 3166-1 alpha-2 format.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**admin_unit:** `String` — Administrative unit code used to filter cities within a specific region.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `Apifreaks::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.<a href="/lib/apifreaks/client.rb">get_supported_flags</a>() -> Internal::Types::Array[Apifreaks::Types::GetSupportedFlagsResponseItem]</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get list of all supported flags with their metadata
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
 
 <dl>
 <dd>
@@ -10421,31 +10968,23 @@ client.get_admin_unit_details(
 <dl>
 <dd>
 
-**api_key:** `String` — Your API key
-    
+```ruby
+client.get_supported_flags(api_key: "apiKey")
+```
 </dd>
 </dl>
-
-<dl>
-<dd>
-
-**format:** `Apifreaks::Types::GetAdminUnitDetailsRequestFormat` — Format of the response.
-    
 </dd>
 </dl>
 
+#### ⚙️ Parameters
+
 <dl>
 <dd>
 
-**country:** `String` — Country code in ISO 3166-1 alpha-2 format.
-    
-</dd>
-</dl>
-
 <dl>
 <dd>
 
-**admin_unit:** `String` — Optional admin code to fetch details for a specific administrative unit.
+**api_key:** `String` — Your API key
     
 </dd>
 </dl>
@@ -10465,7 +11004,7 @@ client.get_admin_unit_details(
 </dl>
 </details>
 
-<details><summary><code>client.<a href="/lib/apifreaks/client.rb">get_cities</a>() -> Apifreaks::Types::GetCitiesResponse</code></summary>
+<details><summary><code>client.<a href="/lib/apifreaks/client.rb">get_flags</a>() -> String</code></summary>
 <dl>
 <dd>
 
@@ -10477,7 +11016,7 @@ client.get_admin_unit_details(
 <dl>
 <dd>
 
-Retrieve a list of cities within a country, optionally filtered by an administrative unit code.
+Retrieve the flag for a specific country
 </dd>
 </dl>
 </dd>
@@ -10492,9 +11031,11 @@ Retrieve a list of cities within a country, optionally filtered by an administra
 <dd>
 
 ```ruby
-client.get_cities(
+client.get_flags(
   api_key: "apiKey",
-  country: "country"
+  name: "name",
+  shape: "flat",
+  type: "country"
 )
 ```
 </dd>
@@ -10518,7 +11059,7 @@ client.get_cities(
 <dl>
 <dd>
 
-**format:** `Apifreaks::Types::GetCitiesRequestFormat` — Format of the response.
+**name:** `String` — Country code in ISO 3166-1 alpha-2 format.
     
 </dd>
 </dl>
@@ -10526,7 +11067,7 @@ client.get_cities(
 <dl>
 <dd>
 
-**country:** `String` — Country code in ISO 3166-1 alpha-2 format.
+**shape:** `Apifreaks::Types::GetFlagsRequestShape` — Flag shape. One of: `'flat'` or `'round'`.
     
 </dd>
 </dl>
@@ -10534,7 +11075,23 @@ client.get_cities(
 <dl>
 <dd>
 
-**admin_unit:** `String` — Administrative unit code used to filter cities within a specific region.
+**format:** `Apifreaks::Types::GetFlagsRequestFormat` — Flag format. Applicable only for PNG or WEBP formats. Default is png.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**size:** `Apifreaks::Types::GetFlagsRequestSize` — Flag size in pixels. Valid options: `16px`, `24px`, `32px`, `48px`, `64px`. Applicable only for PNG or WEBP formats.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**type:** `Apifreaks::Types::GetFlagsRequestType` — Type of flag. One of: `country` or `organization`.
     
 </dd>
 </dl>
@@ -10554,7 +11111,7 @@ client.get_cities(
 </dl>
 </details>
 
-<details><summary><code>client.<a href="/lib/apifreaks/client.rb">get_supported_flags</a>() -> Internal::Types::Array[Apifreaks::Types::GetSupportedFlagsResponseItem]</code></summary>
+<details><summary><code>client.<a href="/lib/apifreaks/client.rb">timezone_lookup</a>() -> Apifreaks::Types::TimezoneLookupResponse</code></summary>
 <dl>
 <dd>
 
@@ -10566,7 +11123,7 @@ client.get_cities(
 <dl>
 <dd>
 
-Get list of all supported flags with their metadata
+Retrieve current time, date, and timezone-related information by specifying a timezone name, location address, location coordinates, IP address, or use the client IP address if no parameter is passed.
 </dd>
 </dl>
 </dd>
@@ -10581,7 +11138,7 @@ Get list of all supported flags with their metadata
 <dd>
 
 ```ruby
-client.get_supported_flags(api_key: "apiKey")
+client.timezone_lookup(api_key: "apiKey")
 ```
 </dd>
 </dl>
@@ -10604,66 +11161,39 @@ client.get_supported_flags(api_key: "apiKey")
 <dl>
 <dd>
 
-**request_options:** `Apifreaks::RequestOptions` 
+**format:** `Apifreaks::Types::TimezoneLookupRequestFormat` — Format of the response
     
 </dd>
 </dl>
-</dd>
-</dl>
-
-
-</dd>
-</dl>
-</details>
 
-<details><summary><code>client.<a href="/lib/apifreaks/client.rb">get_flags</a>() -> String</code></summary>
 <dl>
 <dd>
 
-#### 📝 Description
-
-<dl>
-<dd>
+**ip:** `String` — IPv4 or IPv6 address to extract timezone information.
+    
+</dd>
+</dl>
 
 <dl>
 <dd>
 
-Retrieve the flag for a specific country
-</dd>
-</dl>
+**tz:** `String` — Timezone name (e.g., "Asia/Kolkata") to retrieve information directly.
+    
 </dd>
 </dl>
 
-#### 🔌 Usage
-
-<dl>
-<dd>
-
 <dl>
 <dd>
 
-```ruby
-client.get_flags(
-  api_key: "apiKey",
-  name: "name",
-  shape: "flat",
-  type: "country"
-)
-```
-</dd>
-</dl>
+**location:** `String` — Location string (preferably city and country) to extract timezone.
+    
 </dd>
 </dl>
 
-#### ⚙️ Parameters
-
-<dl>
-<dd>
-
 <dl>
 <dd>
 
-**api_key:** `String` — Your API key
+**lat:** `Integer` — Latitude for geolocation lookup.
     
 </dd>
 </dl>
@@ -10671,7 +11201,7 @@ client.get_flags(
 <dl>
 <dd>
 
-**name:** `String` — Country code in ISO 3166-1 alpha-2 format.
+**long:** `Integer` — Longitude for geolocation lookup.
     
 </dd>
 </dl>
@@ -10679,7 +11209,7 @@ client.get_flags(
 <dl>
 <dd>
 
-**shape:** `Apifreaks::Types::GetFlagsRequestShape` — Flag shape. One of: `'flat'` or `'round'`.
+**lang:** `Apifreaks::Types::TimezoneLookupRequestLang` — Language code for response localization (default is "en").
     
 </dd>
 </dl>
@@ -10687,7 +11217,7 @@ client.get_flags(
 <dl>
 <dd>
 
-**format:** `Apifreaks::Types::GetFlagsRequestFormat` — Flag format. Applicable only for PNG or WEBP formats. Default is png.
+**iata_code:** `String` — 3-letter IATA airport code (e.g., JFK).
     
 </dd>
 </dl>
@@ -10695,7 +11225,7 @@ client.get_flags(
 <dl>
 <dd>
 
-**size:** `Apifreaks::Types::GetFlagsRequestSize` — Flag size in pixels. Valid options: `16px`, `24px`, `32px`, `48px`, `64px`. Applicable only for PNG or WEBP formats.
+**icao_code:** `String` — 4-letter ICAO airport code (e.g., KJFK).
     
 </dd>
 </dl>
@@ -10703,7 +11233,7 @@ client.get_flags(
 <dl>
 <dd>
 
-**type:** `Apifreaks::Types::GetFlagsRequestType` — Type of flag. One of: `country` or `organization`.
+**lo_code:** `String` — 5-letter UN/LO city code.
     
 </dd>
 </dl>
@@ -10723,7 +11253,7 @@ client.get_flags(
 </dl>
 </details>
 
-<details><summary><code>client.<a href="/lib/apifreaks/client.rb">timezone_lookup</a>() -> Apifreaks::Types::TimezoneLookupResponse</code></summary>
+<details><summary><code>client.<a href="/lib/apifreaks/client.rb">timezone_lookup_v2</a>() -> Apifreaks::Types::TimezoneLookupResponse</code></summary>
 <dl>
 <dd>
 
@@ -10735,7 +11265,7 @@ client.get_flags(
 <dl>
 <dd>
 
-Retrieve current time, date, and timezone-related information by specifying a timezone name, location address, location coordinates, IP address, or use the client IP address if no parameter is passed.
+Retrieve current time, date, and timezone-related information using the `v2.0/geolocation/timezone` endpoint by specifying a timezone name, location address, location coordinates, IP address, or use the client IP address if no parameter is passed.
 </dd>
 </dl>
 </dd>
@@ -10750,7 +11280,7 @@ Retrieve current time, date, and timezone-related information by specifying a ti
 <dd>
 
 ```ruby
-client.timezone_lookup(api_key: "apiKey")
+client.timezone_lookup_v2(api_key: "apiKey")
 ```
 </dd>
 </dl>
@@ -11810,3 +12340,137 @@ client.astronomy_lookup(api_key: "apiKey")
 </dl>
 </details>
 
+<details><summary><code>client.<a href="/lib/apifreaks/client.rb">astronomy_lookup_v2</a>() -> Apifreaks::Types::AstronomyLookupResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Retrieve sunrise and sunset times, current position of the moon, and other related information using the `v2.0/geolocation/astronomy` endpoint by specifying a location address, location coordinates, IP address, or using the client IP address if no parameter is passed.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.astronomy_lookup_v2(api_key: "apiKey")
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**api_key:** `String` — Your API key
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**format:** `Apifreaks::Types::AstronomyLookupRequestFormat` — Format of the response.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**location:** `String` — Location name or address
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**lat:** `Integer` — Latitude for location coordinates
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**long:** `Integer` — Longitude for location coordinates
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**ip:** `String` — IP address for location detection
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**lang:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**date:** `String` — Date for astronomy data (YYYY-MM-DD)
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**elevation:** `Integer` — Timezone of the location for which astronomy data is required
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**time_zone:** `String` — 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `Apifreaks::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+