Custom Connector
GeoJS Connector
Global
The GeoJS Connector provides access to open, production-ready IP geolocation services through the GeoJS public API. It enables users to retrieve their own IP address, access geolocation details, and look up any IP address globally — all without authentication.
Overview
Integration Overview
This document provides a detailed guide for each integration point, its purpose, configuration, and workflow support using the GeoJS Connector. The connector exposes three core endpoints for IP and geolocation lookups.
- Get Current IP. Retrieve the public IP address of the requester.
- Get Geolocation (Self). Fetch detailed location data for the requester’s IP.
- Get Geolocation (By IP). Get location information for any specific IP address.
Documentation
Detailed Integration Documentation
Get Current IP
| Operation ID | getCurrentIP |
|---|---|
| Endpoint | GET /v1/ip |
| Parameters | Required: None. |
| Purpose | Returns the requester’s public IP address in plain-text format. |
| Output | A single string containing the IP address (e.g. 8.8.8.8). |
| Workflow example | Execute GET /v1/ip, then pass the IP to /geo/{ip}.json for detailed geolocation data. |
Get Geolocation (Self)
| Operation ID | getGeoSelf |
|---|---|
| Endpoint | GET /v1/ip/geo.json |
| Parameters | Required: None. |
| Purpose | Provides geolocation information for the requester’s IP — country, region, city, latitude, longitude, and timezone. |
| Output | JSON object with ip, country, region, city, latitude/longitude, organization (ISP), and timezone. |
| Workflow example | Execute GET /v1/ip/geo.json to detect a user’s approximate location for analytics, personalization, or geofencing. |
Get Geolocation (By IP)
| Operation ID | getGeoByIP |
|---|---|
| Endpoint | GET /v1/ip/geo/{ip}.json |
| Parameters | Required: ip (path, string) — the IP address to look up. |
| Purpose | Returns geolocation data for any specific IP address provided in the path parameter. |
| Output | JSON object with IP details, including geographic location and timezone. |
| Workflow example | Execute GET /v1/ip/geo/{ip}.json to locate a specific user or server — useful for admin dashboards, security logs, or analytics. |
Example Workflow: IP Geolocation Discovery
| Get current IP | Call /v1/ip to retrieve your public IP address. |
|---|---|
| Get geolocation (self) | Call /v1/ip/geo.json for detailed data about your IP’s location. |
| Get geolocation (by IP) | Use /v1/ip/geo/{ip}.json to look up any IP address worldwide, then process the data for reporting or visualization. |
Support
For technical support, contact custom-connectors-support@isolutions.sa.