Ghosted Development API
Welcome to the official Ghosted Development utility API documentation. Our endpoints are simple, fast, and accessible for general developer automation needs.
Base URL
https://api.ghosted-development.spaceUtility Endpoints
Calculates the time difference between a given Unix timestamp and the current time.
Parameters
timestamp={Unix Timestamp in seconds}Example Request
GET /time-diff?timestamp=1700000000Example Response
{
"timestamp": 1700000000,
"days": 2,
"hours": 0,
"minutes": 18,
"seconds": 0,
"success": true
}Returns a Magic 8-Ball style answer based on a given question.
Parameters
question={Text}Example Request
GET /8ball?question=Will%20I%20win?Example Response
{
"question": "Will I win?",
"answer": "Outlook good.",
"type": "positive",
"success": true
}Automatically encodes or decodes a given text string into or from Morse code.
Parameters
text={Text}Headers
Operation=Encode | DecodeExample Request (Encode)
GET /morse-code?text=Hello
Operation: EncodeExample Response (Encode)
{
"input": "Hello",
"output": ".... . .-.. .-.. ---",
"operation": "ENCODE",
"success": true
}Automatically encodes or decodes a given text string into or from Binary.
Parameters
text={Text}Headers
Operation=Encode | DecodeExample Request (Encode)
GET /binary?text=Hello
Operation: EncodeExample Response (Encode)
{
"input": "Hello",
"output": "01101000 01100101 01101100 01101100 01101111",
"operation": "ENCODE",
"success": true
}Converts temperatures between Celsius (C) and Fahrenheit (F).
Parameters
value={Numeric temperature value}Headers
Operation= CELSIUS TO FAHRENHEIT | FAHRENHEIT TO CELSIUSExample Request (Fahrenheit to Celsius)
GET /temperature-convert?value=32
Operation: FAHRENHEIT TO CELSIUSExample Response
{
"value": 0,
"unit": "C",
"unit_type": "Celsius",
"success": true
}Formats large numbers using a custom separator for thousands.
Parameters
number={Large integer}
separator={Character to use as separator, e.g., ., or ,}Example Request
GET /number-formatter?number=4532134521342&separator=.Example Response
{
"formatted": "4.532.134.521.342",
"original": 4532134521342,
"separator": ".",
"success": true
}Deletes a requested number of messages (MAX 1000).
Headers
bot_token: {BOT_TOKEN}
Purge-Channel-ID: {CHANNEL_ID} - The channel you want to delete the messages from
Log-Channel-ID: {CHANNEL_ID} - The channel to send the log to
Limit: {NUMBER} - How many messages you want to deleteExample Response
{
"purgeChannelId": 123456789012345678,
"logChannelId": 123456789098765432,
"requestedLimit": 1000,
"messagesPurged": 472,
"logMessageSent": true
}Rate Limits
As this is a public API, requests are limited based on your IP address to ensure service stability and fair usage for all developers.
Current Limits
- Limit: 100 requests per minute (RPM) per IP address.
- Burst: A burst limit of 10 requests is allowed within the first second.
Rate Limit Response Example
{
"success": false,
"error": "Rate limit exceeded. Try again in 5 seconds."
}Error Response Format
All non-200 responses return a consistent JSON structure to help you debug quickly.
Standard Error Structure
{
"success": false,
"error": "Descriptive message detailing the issue (e.g., Missing parameter, Invalid value)."
}Common Status Codes
- 400 Bad Request: Missing or invalid required query parameters.
- 429 Too Many Requests: Rate limit exceeded.
- 500 Internal Server Error: A problem occurred on the server.