Live Demo Plans & Quotas Developer API Dashboard System & Legal

IP Geolocation & Edge Data API

Built for developers and enterprise teams. Sub-50ms IP geolocation, real-time WebSocket streaming, and quota analytics — deployed across global edge nodes.

$ curl https://servicenode.ziplink.xyz/geo
→ {"ip":"104.18.22.46","country":"US","city":"San Jose","asn":"AS13335"}

Live Connection Demo

This panel shows the exact HTML table format rendered by our server-side engine for web requests.

IP AddressFetching edge data...
Country...
Region...
City...
Data Center (Colo)...
ASN...

Service Tiers & Rate Limits

Our infrastructure strictly enforces rate limiting based on your assigned tier to prevent node abuse.

Community / Public API

$0 / forever
  • REST HTTP API Endpoints
  • Max 80 requests per minute
  • HTTP 429 "Too Many Requests" fallback
  • No API Token required
View Documentation
Enterprise

Real-time WSS Streaming

Custom / Contact Us
  • WebSocket Multiplexing
  • Private sub-domain node routing
  • UUID Token Bearer Authentication
  • Unlimited concurrent connections
Contact Sales

Client Dashboard Access

Security Notice: ZipLink does not use traditional username/password logins. All configurations are managed via secure Token-URLs.

To access your personalized Developer Dashboard and Node Configuration, you must append your unique Private UUID to the edge node domain. Do not share this link.

GET https://node.ziplink.xyz/{YOUR-PRIVATE-UUID}

Accessing this URL will render your HTML dashboard, showing Sub configuration (CSV Remark, DLS, TLS variables) and your active V2-compatible node links.

Your Private UUID is provisioned when your Enterprise account is activated. Contact sales@ziplink.xyz to get started.

Edge Endpoints Documentation

Always route requests to your assigned edge node (e.g., servicenode.ziplink.xyz). The main homepage domain does not process API requests.

1. Standard Geo Lookup

Returns standard geographic data in JSON. Subject to 80 RPM rate limit.

GET /geo HTTP/1.1
Host: servicenode.ziplink.xyz

Example response:

{
  "ip": "104.18.22.46",
  "country": "US",
  "country_name": "United States",
  "region": "California",
  "city": "San Jose",
  "asn": "AS13335",
  "org": "Cloudflare, Inc."
}

2. Account Usage API

Returns live worker invocation counts for your account. Gracefully degrades to cached values if quota endpoints are temporarily unavailable.

GET /getusage HTTP/1.1
Host: servicenode.ziplink.xyz

Example response:

{
  "plan": "enterprise",
  "requests_today": 148234,
  "requests_this_month": 3821045,
  "quota_limit": -1,
  "quota_reset": "2025-02-01T00:00:00Z"
}

quota_limit: -1 indicates unlimited (Enterprise plan). Community plan returns the enforced 80 RPM cap.

3. Configuration Sync API

Allows automated clients to fetch node parameters directly via JSON.

GET /{YOUR-UUID}/config.json HTTP/1.1
Host: servicenode.ziplink.xyz

Example response:

{
  "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "node": "servicenode.ziplink.xyz",
  "remark": "ZipLink-Edge-Node",
  "tls": true,
  "ws_path": "/api/data"
}

4. WebSocket Streaming Channels

Authorization Required: WebSocket Upgrades must include a valid authentication token. Missing or invalid tokens will trigger a rejection: HTTP 401: invalid_token.

Initiate persistent connections on any of our authorized gateway paths for high-frequency data transmission.

WSS /api/data HTTP/1.1
Host: servicenode.ziplink.xyz
Connection: Upgrade
Upgrade: websocket
Authorization: Bearer {YOUR-UUID-TOKEN}

Valid Alternative WebSocket Paths:

/api/data          (Primary)
/api/v1/stream
/api/v1/analytics
/api/v1/metrics
/api/v2/events
/ws/realtime
/stream/live