API Documentation

Authentication

All API requests require a Bearer token in the Authorization header.

Generate your token in Dashboard → General Settings → API.

                    Authorization: Bearer your-api-token
                

Base URL: https://linkshor.com/api

POST

Create Short Link

Create a new shortened link.

Endpoint

                    POST /api/create
                

Request Body (JSON)

Parameter	Type	Required	Description
`organization_key`	string	Yes	Your organization secret key
`url_group_id`	string	Yes	URL group API ID
`url`	string	Yes	Long URL to shorten (must start with http/https)
`alias`	string	No	Custom alias (auto-generated if empty)
`redirect_type`	integer	No	301, 302, 303, 307, or 308 (default: 301)

cURL Example

curl -X POST https://linkshor.com/api/create \

  -H "Authorization: Bearer YOUR_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{
    "organization_key": "YOUR_ORG_KEY",
    "url_group_id": "1",
    "url": "https://example.com/long-page",
    "alias": "my-link"
  }'
                

JavaScript Example

const response = await fetch('https://linkshor.com/api/create', {

  method: 'POST',

  headers: {

    'Authorization': `Bearer ${token}`,

    'Content-Type': 'application/json'

  },

  body: JSON.stringify({

    organization_key: 'YOUR_ORG_KEY',

    url_group_id: '1',

    url: 'https://example.com/long-page'

  })

});

const data = await response.json();

● 200 — Success

{

  "data": {

    "id": 42,

    "short_url": "https://yourdomain.com/my-link",

    "url": "https://example.com/long-page",

    "domain": "yourdomain.com",

    "alias": "my-link",

    "redirect_type": 301

  },

  "code": 0,

  "errors": []

}

● Error Responses

Status	Code	Meaning
401	3, 10, 11	Invalid or missing API token
401	12, 13, 17	Invalid organization key or inactive org
405	2	Method not allowed (use POST)
422	4	Organization key missing
422	5	URL group ID missing
422	6, 7	URL missing or invalid
422	8, 9	Alias format invalid or too long
422	14	URL group not found
422	15	Alias already taken
422	18	URL blocked by anti-phishing check
429	—	Rate limit exceeded (60 requests/minute)

Rate Limits

The API is rate-limited to 60 requests per minute per token. If you exceed this limit, you'll receive a 429 Too Many Requests response.

Getting Started

Sign up or log in to your LinkShor account
Go to General Settings → API in your dashboard
Generate a Personal Access Token
Create an Organization Secret Key
Note your URL Group API ID (found in URL Groups settings)
Make your first API call using the examples above