Developers API

Integrate our bypass detection into your applications seamlessly. Fully transparent and easy to implement for your software.

1. Generate Shortened Link

Use this endpoint to create a new shortened link targeting your destination URL automatically via the bot's connected shorteners.

GET https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&url=YOUR_DESTINATION_URL&alias=OPTIONAL_ALIAS

Parameters

Usage Examples

curl -X GET "https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&url=https://example.com"
import requests

url = "https://AntiBypass.csbots.in/api"
params = {
    "api": "YOUR_API_KEY",
    "url": "https://example.com"
}

response = requests.get(url, params=params)
print(response.json())
<?php
$api_url = "https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&url=" . urlencode("https://example.com");
$response = file_get_contents($api_url);
$data = json_decode($response, true);
print_r($data);
?>
const axios = require('axios');

axios.get('https://AntiBypass.csbots.in/api', {
  params: {
    api: 'YOUR_API_KEY',
    url: 'https://example.com'
  }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

JSON Response - Success

{
    "status": "success",
    "shortenedUrl": "https://short.site/alias"
}

JSON Response - Error

{
    "status": "error",
    "error_code": 8,
    "error": "Invalid API key or URL parameter missing"
}

2. Check Verification Status

Use this endpoint to verify if a specific shortened link (identified by its alias) has been successfully completed by a user.

GET https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&alias=ALIAS&user_id=USER_ID

Parameters

Usage Examples

curl -X GET "https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&alias=ALIAS&user_id=USER_ID"
import requests

url = "https://AntiBypass.csbots.in/api"
params = {
    "api": "YOUR_API_KEY",
    "alias": "ALIAS",
    "user_id": "USER_ID"
}

response = requests.get(url, params=params)
print(response.json())
<?php
$api_url = "https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&alias=ALIAS&user_id=USER_ID";
$response = file_get_contents($api_url);
$data = json_decode($response, true);
print_r($data);
?>
const axios = require('axios');

axios.get('https://AntiBypass.csbots.in/api', {
  params: {
    api: 'YOUR_API_KEY',
    alias: 'ALIAS',
    user_id: 'USER_ID'
  }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

JSON Response - Verified (Success)

{
    "status": "success"
}

JSON Response - Pending (View counted but not confirmed for this specific alias yet)

{
    "status": "pending"
}

JSON Response - Failed (No views recorded)

{
    "status": "failed"
}

3. Check 24-Hour Global Status

Use this endpoint to verify if a user has completed any verification for your active shortener within the last 24 hours.

GET https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&user_id=USER_ID

Parameters

Usage Examples

curl -X GET "https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&user_id=USER_ID"
import requests

url = "https://AntiBypass.csbots.in/api"
params = {
    "api": "YOUR_API_KEY",
    "user_id": "USER_ID"
}

response = requests.get(url, params=params)
print(response.json())
<?php
$api_url = "https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&user_id=USER_ID";
$response = file_get_contents($api_url);
$data = json_decode($response, true);
print_r($data);
?>
const axios = require('axios');

axios.get('https://AntiBypass.csbots.in/api', {
  params: {
    api: 'YOUR_API_KEY',
    user_id: 'USER_ID'
  }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

JSON Response - Success

{
    "status": "success",
    "verified": true
}

4. Error Handling

If the API encounters an error during processing, it will return a JSON object containing an error_code and an error key with a descriptive message. Make sure your script handles these gracefully.

Code Failure Type Description Resolution
1 Missing API Parameter The api query parameter was not provided. Ensure you append ?api=YOUR_KEY in the URL. Get it from @None using /get_api.
2 Invalid API Key The provided API key does not exist or is malformed. Verify your API key matches exactly what the bot provided.
3 Missing Credentials Your shortener credentials (username/password/site) are missing in the DB. Contact @None to re-authenticate or update your shortener connection.
4 Missing user_id The `user_id` tracking parameter was not provided in Endpoint 2. Append `&user_id=` to your request URL.
5 API Disabled The API Owner has disabled API access. The API owner must enable API access from their account settings.
6 Site Script Not Found The shortener module associated with your account cannot be loaded. The bot may not support this shortener anymore, or there is an internal misconfiguration. Contact support.
7 Failed to Call Shortener API The underlying shortener API rejected the request or timed out. Check if your connected shortener account is active, or try again later.
8 Internal Error / Invalid Params Unhandled exception, or you requested without alias and without url. Make sure you specify either url (to shorten) or alias (to check). Contact support if it persists.