Micro-Social
# Micro-Social API: Enterprise-Grade Social Infrastructure **Build your own Twitter/X clone or high-scale social features in minutes.** Micro-Social API is a production-ready, ultra-low latency REST API designed for developers who need reliable social networking logic without the overhead of building a backend from scratch. --- ## 🚀 Built for Scale & Performance Powered by the **Bun runtime**,…
Micro-Social endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST |
/auth/login /auth/login |
Authenticate and receive a JWT token. |
| GET |
/posts/{id}/likes /posts/{id}/likes |
|
| DELETE |
/posts/{id}/like /posts/{id}/like |
|
| GET |
/health /health |
|
| GET |
/posts/feed /posts/feed |
|
| GET |
/users/{id}/posts /users/{id}/posts |
|
| POST |
/posts/{id}/like /posts/{id}/like |
|
| GET |
/users/{id}/followers /users/{id}/followers |
|
| POST |
/users/{id}/follow /users/{id}/follow |
|
| GET |
/users/{id}/following /users/{id}/following |
|
| DELETE |
/users/{id}/follow /users/{id}/follow |
|
| GET |
/posts/{id} /posts/{id} |
|
| POST |
/posts/ /posts/ |
|
| GET |
/users/{id} /users/{id} |
|
| DELETE |
/posts/{id} /posts/{id} |
|
| POST |
/auth/signup /auth/signup |
Create a new user account. |
| GET |
healthCheck /health |
Check if the API is running. No authentication required. |
| POST |
signup /auth/signup |
Create a new user account with username, email and password. Username must be unique and between 3-30 characters. Password must be at least 6 characters. |
| DELETE |
deletePost /posts/{id} |
Delete one of your own posts. You can only delete posts you created. |
| GET |
getFollowing /users/{id}/following |
Get a list of users that this user is following. |
| DELETE |
unlikePost /posts/{id}/like |
Remove your like from a post. |
| GET |
getUserProfile /users/{id} |
Get a user's profile including stats (posts count, followers, following) and whether you follow them. |
| GET |
getUserPosts /users/{id}/posts |
Get all posts from a specific user. |
| POST |
followUser /users/{id}/follow |
Start following a user. Their posts will appear in your feed. |
| DELETE |
unfollowUser /users/{id}/follow |
Stop following a user. Their posts will no longer appear in your feed. |
| GET |
getFollowers /users/{id}/followers |
Get a list of users who follow this user. |
| POST |
login /auth/login |
Authenticate with email and password. Returns a JWT token that must be included in the Authorization header for protected endpoints. |
| POST |
likePost /posts/{id}/like |
Add a like to a post. If already liked, does nothing. |
| GET |
getPost /posts/{id} |
Retrieve a specific post by its ID with like count and author info. |
| GET |
getFeed /posts/feed |
Get posts from users you follow and your own posts, sorted by newest first. Use limit and offset for pagination. |
| GET |
getPostLikes /posts/{id}/likes |
Get a list of users who have liked a specific post. |
| POST |
createPost /posts |
Create a new post with up to 280 characters (like Twitter). Requires authentication. |
| GET |
healthCheck /health |
Check if the API is running. No authentication required. |
| POST |
followUser /users/{id}/follow |
Start following a user. Their posts will appear in your feed. |
| GET |
getUserProfile /users/{id} |
Get a user's profile including stats (posts count, followers, following) and whether you follow them. |
| POST |
signup /auth/signup |
Create a new user account with username, email and password. Username must be unique and between 3-30 characters. Password must be at least 6 characters. |
| GET |
getFollowers /users/{id}/followers |
Get a list of users who follow this user. |
| GET |
getUserPosts /users/{id}/posts |
Get all posts from a specific user. |
| POST |
login /auth/login |
Authenticate with email and password. Returns a JWT token that must be included in the Authorization header for protected endpoints. |
| POST |
createPost /posts |
Create a new post with up to 280 characters (like Twitter). Requires authentication. |
| GET |
getPostLikes /posts/{id}/likes |
Get a list of users who have liked a specific post. |
| GET |
getPost /posts/{id} |
Retrieve a specific post by its ID with like count and author info. |
| GET |
getFeed /posts/feed |
Get posts from users you follow and your own posts, sorted by newest first. Use limit and offset for pagination. |
| DELETE |
deletePost /posts/{id} |
Delete one of your own posts. You can only delete posts you created. |
| POST |
likePost /posts/{id}/like |
Add a like to a post. If already liked, does nothing. |
| DELETE |
unlikePost /posts/{id}/like |
Remove your like from a post. |
| GET |
getFollowing /users/{id}/following |
Get a list of users that this user is following. |
| DELETE |
unfollowUser /users/{id}/follow |
Stop following a user. Their posts will no longer appear in your feed. |