API Documentation

POST /api/add

Use this endpoint to add a new tweet. Ratelimit is applied

Request Example:

POST /api/add HTTP/1.1
Host: keepmytweets.com
Content-Type: application/json

{
    "url": "https://x.com/.../status/..."
}

Successful Response Example:

HTTP/1.1 200 Ok
Content-Type: application/json

{
    "123asd45cvb"
}

GET /api/find/{key}

Use this endpoint to retrieve a specific tweet by its Key.

Request Example:

GET /api/find/123asd45cvb HTTP/1.1
Host: keepmytweets.com

Successful Response Example:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "url": "https://x.com/.../status/...",
    "img": "https://keepmytweets.com/img/mkalskdl.png"
}

Error Responses

The API may return the following error codes:

  • 400 Bad Request: Invalid or missing request
  • 500 Internal Server Error: Server error
An error has occurred. This application may no longer respond until reloaded. Reload 🗙