API Documentation

Introduction

The ShortURL API allows you to programmatically create short links, manage your links, and retrieve analytics data. Our API is organized around REST and returns JSON responses.

Authentication

All API requests require an API key. Include your API key in the Authorization header or as a query parameter.

Shorten URL

Create a new short link from a long URL.

Request Body

Example Request

curl -X POST https://t.wpsanjeet.com/api/?endpoint=shorten \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/my-long-url", "alias": "mylink"}'

Example Response

{
  "success": true,
  "data": {
    "short_url": "https://t.wpsanjeet.com/mylink",
    "short_code": "mylink",
    "long_url": "https://example.com/my-long-url",
    "qr_code_url": "https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=https%3A%2F%2Ft.wpsanjeet.com/mylink",
    "created_at": "2024-01-15 10:30:00"
  }
}

List Links

Get a list of all your shortened links.

Example Request

curl https://t.wpsanjeet.com/api/?endpoint=links \
  -H "Authorization: Bearer YOUR_API_KEY"

Delete Link

Delete a short link permanently.

Example Request

curl -X DELETE "https://t.wpsanjeet.com/api/?endpoint=links&id=123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Analytics

Retrieve click analytics for your links.

Query Parameters

Bio Pages

List all your bio link pages.

Rate Limits

To ensure fair usage, API requests are rate limited:

• Free plan: Not available
• Pro plan: 1,000 requests per hour
• Agency plan: 10,000 requests per hour

If you exceed your rate limit, the API will return a 429 Too Many Requests response.

Error Codes