Developer API

A minimalist, high-speed REST endpoint for resolving shortlinks and bypassable URLs programmatically.

Protocol

HTTPS

Format

JSON

Auth

None (Public)

Rate Limit

15 req / min

Endpoint

POSTGEThttps://bypass.web.id/api/bypass

1. POST Request (Recommended)

// cURL Example

curl -X POST https://bypass.web.id/api/bypass \
  -H "Content-Type: application/json" \
  -d '{"url": "https://bit.ly/google"}'

2. GET Request (URL Query Parameter)

curl "https://bypass.web.id/api/bypass?url=https://bit.ly/google"

3. Success Response (200 OK)

{
  "success": true,
  "originalUrl": "https://bit.ly/google",
  "destination": "https://get.google.com/albumarchive/pwa/CamenzindEvolution/NewGoogleOfficeZurich",
  "source": "bit.ly",
  "hops": [
    "https://bit.ly/google",
    "http://picasaweb.google.com/CamenzindEvolution/NewGoogleOfficeZurich",
    "https://get.google.com/albumarchive/pwa/CamenzindEvolution/NewGoogleOfficeZurich"
  ],
  "engine": "direct",
  "timeMs": 142
}

Response Schema

Field	Type	Description
success	boolean	Whether the link was resolved successfully.
destination	string	The final unshortened destination URL.
hops	string[]	List of intermediate URLs in redirect chain.
engine	string	Solver used: "direct", "cloud", or "cache".
timeMs	number	Server processing duration in milliseconds.

HTTP Status Codes

200 OK — Link resolved successfully.
400 Bad Request — Missing or malformed URL, or SSRF security restriction triggered.
422 Unprocessable — Target server offline or link expired.
429 Too Many Requests — Rate limit exceeded (more than 15 requests per minute).