SHORT.bid

Quick Start

1. Get Your API Key

After creating an account:

Login to your dashboard
Navigate to the API page
Click "Generate API Key"
Copy and save your key securely

2. Make Your First Request

Create a short link using cURL:

curl -X POST https://short.bid/api.php \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "createLink",
    "url": "https://example.com"
  }'

Response:

{
  "success": true,
  "linkId": 123,
  "shortUrl": "https://short.bid/123"
}

API Features

Link Management

Create short links
Get link details
Update link properties
Delete links
List all links

Analytics

Get click statistics
Monthly traffic data
Total traffic counts
Link performance metrics

Premium Features

Custom short link slugs
No-referer mode
POST method redirects
Custom domains
Bulk operations

Bulk Operations

Update multiple links at once
Bulk delete
Batch set no-referer
Batch change domain
Batch set POST method

Code Examples

JavaScript (Fetch API)

fetch('https://short.bid/api.php', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    action: 'createLink',
    url: 'https://example.com',
    noReferer: 1  // Premium feature
  })
})
.then(response => response.json())
.then(data => console.log(data));

Python

import requests

headers = {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
}

data = {
    'action': 'createLink',
    'url': 'https://example.com'
}

response = requests.post(
    'https://short.bid/api.php',
    headers=headers,
    json=data
)

print(response.json())

PHP

$ch = curl_init('https://short.bid/api.php');

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: YOUR_API_KEY',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'action' => 'createLink',
    'url' => 'https://example.com'
]));

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

Bulk Update (Premium)

curl -X POST https://short.bid/api.php \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "bulkUpdate",
    "linkIds": [1, 2, 3, 4, 5],
    "updates": {
      "linkNoReferer": 1
    }
  }'

Available Endpoints

Action	Description	Access
`createLink`	Create a new short link	All Users
`getLinks`	Get all your links	All Users
`getLink`	Get single link details	All Users
`updateLink`	Update link properties	All Users
`deleteLink`	Delete a link	All Users
`bulkUpdate`	Update multiple links at once	Premium
`bulkDelete`	Delete multiple links at once	Premium
`getStats`	Get account statistics	All Users
`getUser`	Get user information	All Users
`generateApiKey`	Generate/regenerate API key	All Users

Authentication

Include your API key in every request using one of these methods:

Method 1: Custom Header (Recommended)

X-API-Key: your_api_key_here

Method 2: Bearer Token

Authorization: Bearer your_api_key_here

Security Note: Never share your API key or commit it to public repositories. Keep it secure like a password.

Rate Limits

Currently, there are no enforced rate limits. However, please use the API responsibly:

Avoid making excessive requests in short time periods
Implement reasonable caching where possible
If you need high volume access, contact support

Rate limiting may be implemented in the future if abuse is detected.

Developer API