API Documentation

Request

{"url": "https://example.com"}

Response

{"shortUrl": "SHORT_URL", "cid": 304}

Examples

curl -X POST https://urlfy.org/api/v1/shorten \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

fetch('https://urlfy.org/api/v1/shorten', {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({url: 'https://example.com'})
})
.then(res => res.json())
.then(result => console.log(result.shortUrl));

import requests

response = requests.post('https://urlfy.org/api/v1/shorten',
    json={'url': 'https://example.com'})
result = response.json()
print(result['shortUrl'])

Request

GET https://urlfy.org/api/v1/stats/zosdJjx

Response

{
  "shortCode": "zosdJjx",
  "originalURL": "https://example.com/...",
  "clickCount": 114747,
  "createdAt": "2025-11-02T15:00:00Z"
}

Examples

curl https://urlfy.org/api/v1/stats/zosdJjx

const r = await fetch('https://urlfy.org/api/v1/stats/zosdJjx');
const stats = await r.json();
console.log(stats.clickCount);

import requests
r = requests.get('https://urlfy.org/api/v1/stats/zosdJjx')
print(r.json()['clickCount'])

Request

POST https://urlfy.org/api/v1/delete?apikey=YOUR_API_KEY&shortcode=zosdJjx

Response

{"success": true, "message": "Short URL 'zosdJjx' deleted successfully"}

Examples

curl -X POST "https://urlfy.org/api/v1/delete?apikey=YOUR_API_KEY&shortcode=zosdJjx"

Request

GET https://urlfy.org/api/v1/stats?apikey=YOUR_API_KEY

Response

{
  "总短链数": 1939491,
  "近7日创建数": 23984,
  "每日统计": [...],
  "点击量Top10": [...]
}

Request

{
  "shortUrl": "https://urlfy.org/abc1234",
  "reason": "Phishing or fraud",
  "details": "Optional details",
  "reporterEmail": "[email protected]"
}

Response

{"success": true}

Request

{
  "name": "Your Name",
  "email": "[email protected]",
  "subject": "Question",
  "message": "Hello..."
}

Response

{"success": true, "message": "感谢您的消息！我们会在24小时内回复您。"}