V1 API Documentation
V1 of the Bubblez API has now been discontinued, this page will be left for archival reasons.
This documentation contains everything you need to know about the official bubblez api.
Getting Started
You must apply for a token at https://bubblez.app/applications/api-token
For live: Discontinued 7th of January 2023
For canary: Discontinued
Blogs
Blog Latest
POST https://bubblez.app/api/v1blog/latest
{
"200": "latest Blog Post",
"blogid": "integer",
"blogposter_username": "string",
"blogposter_displayname": "string",
"blogposter_pfp": "string",
"blogcontent": "string",
"blogimage": "string",
"blogtag": "string",
"blogdate": "string"
}Posts
Post Send
POST https://bubblez.app/api/v1/post/send
Request Body
token*
String
api token from settings
post*
String
the message you want the post to contain
from
String
the little message next to the post date
locked
String
accepts value true defaults to false
nsfw
String
accepts value true defaults to false
{
"200": "message sent",
"post": "string",
"from": "string",
"locked": "string",
"pnsfw": "string",
"postid": "integer"
}Post Lock
POST https://bubblez.app/api/v1/post/lock
Request Body
token*
String
api token from settings
postid*
Integer
the id of the post you want to lock or unlock
togglelock*
String
accepted values true or false
{
"200": "Post 522 has been locked"
}Post Delete
POST https://bubblez.app/api/v1/post/delete
Request Body
token*
String
api token from settings
postid*
Integer
the id of the post you wish to delete
confirm*
String
accepted value true anything else will cancel the request
{
"200": "Post 522 has been deleted"
}Post Get
POST https://bubblez.app/api/v1/post/get
Request Body
token*
String
api token from settings
postid*
Integer
the id of the post you wish to collect info on
{
"200": "Found post",
"postid": "integer",
"username": "string",
"pfp": "string",
"content": "string",
"from": "string",
"locked": "string",
"pnsfw": "string",
"edited": "string",
"post_date": "string",
"replies": [
{
"replyid": "integer",
"username": "string",
"pfp": "string",
"content": "string",
"from": "string",
"rnsfw": "string",
"deleted": "string",
"edit_date": "string",
"reply_date": "string"
}
]
}Post latest
POST https://bubblez.app/api/v1/post/latest
Request Body
token*
String
api token from settings
{
"200": "latest Post",
"postid": "integer"
}Post Edit
POST https://bubblez.app/api/v1/post/edit
Request Body
token*
String
api token from settings
postid*
integer
the id of the post you want to edit
post*
String
the message you want to change your post to
{
"200": "Post 522 has been updated"
}Replies
Reply Send
POST https://bubblez.app/api/v1/reply/send
Request Body
token*
String
api token from settings
postid*
Integer
the id of the post you want to reply to
reply*
String
the message you want the reply to contain
from
String
the little message next to the reply date
nsfw
String
accepts value true defaults to false
{
"200": "reply sent",
"reply": "string",
"postid": "integer",
"from": "string",
"rnsfw": "string",
"replyid": "integer"
}Reply Delete
POST https://bubblez.app/api/v1/reply/delete
Request Body
token*
String
api token from settings
replyid*
Integer
the id of the reply you wish to delete
confirm*
String
accepted value true anything else will cancel the request
{
"200": "reply 1473 has been deleted"
}Reply Edit
POST https://bubblez.app/api/v1/reply/edit
Request Body
token*
String
api token from settings
replyid*
Integer
the id of the reply you want to edit
reply*
String
the message you want to change your reply to
{
"200": "Reply 1473 has been updated"
}Users
User Check
POST https://bubblez.app/api/v1/user/check
Request Body
token*
String
api token from settings
{
"200": "Found user",
"uuid": "string",
"username": "string",
"displayname": "string",
"email": null,
"pfp": "string",
"banner": "string",
"coins": "integer",
"rank": "json",
"badges": "json",
"bio": "string",
"nsfw": "string",
"dob": null,
"pronoun": "string",
"ban": null,
"created_at": "string",
"last_posted": "string",
"posts": [
{
"postid": "integer",
"username": "string",
"content": "string",
"from": "string",
"locked": "string",
"pnsfw": "string",
"edited": "string",
"post_date": "string"
}
],
"replies": [
{
"replyid": "integer",
"postid": "integer",
"username": "string",
"content": "string",
"from": "string",
"rnsfw": "string",
"edited": "string",
"reply_date": "string"
}
]
}User Get
POST https://bubblez.app/api/v1/user/get
Request Body
token*
String
api token from settings
username*
String
the bubblez username of the user you want to grab info from
{
"200": "Found user",
"uuid": "string",
"username": "string",
"displayname": "string",
"followers": "integer",
"pfp": "string",
"banner": "string",
"coins": "integer",
"rank": "json",
"badges": "json",
"bio": "string",
"nsfw": "string",
"pronoun": "string",
"ban": null,
"created_at": "string",
"last_posted": null,
"posts": [
{
"postid": "integer",
"username": "string",
"content": "string",
"from": "string",
"locked": "string",
"pnsfw": "string",
"edited": "string",
"post_date": "string"
}
]
}User Ping
POST https://bubblez.app/api/v1/user/ping
Request Body
token
String
api token from settings
{
"200": "Pong",
"username": "string",
"online_status": "string"
}Last updated