Sell In PublicPosts
There are six endpoints for post information. Four public endpoints and two private endpoints that require a Pro account.
GET /latest
Public endpoint. Provides the latest posts. The meta information will provide pagination info.
Endpoint Example
Below is a live example that can be copy and pasted.
curl https://sandbox.sellinpublic.com/api/v0/latest -u "demo:sip_api_sand_01234demo56789_key"
Below is the expected result from that cURL call:
{
"status": "success",
"messages": [],
"meta": {
"pagination": {
"total_results": 4,
"total_pages": 1,
"page_previous": 1,
"page_next": 1,
"page_current": 1,
"current_page": 1,
"current_result": 1,
"current_result_first": 1,
"current_result_last": 4,
"url_next": "/api/v0/latest?page=1",
"url_previous": "/api/v0/latest?page=1"
}
},
"data": [
{
"id": 2,
"user_id": 1,
"conversation_id": 2,
"parent_id": 0,
"original_id": 0,
"post": "Welcome to the Sandbox server where you can test the interface and API interactions!",
"status": "published",
"type": "post",
"depth": 0,
"sort_order": null,
"attachment_count": 0,
"replies": 3,
"reposts": 0,
"quotes": 0,
"stars": 1,
"flags": 0,
"reactions": 0,
"bumps": 0,
"created_at": "2024-03-23T04:42:04+00:00",
"updated_at": "2024-03-23T08:42:04+00:00",
"published_at": "2024-03-23T04:42:04+00:00",
"sorted_at": "2024-03-23T08:41:04+00:00",
"username": "demo",
"replied": false,
"flagged": false,
"starred": true,
"attachments": [],
"user": {
"user_id": 1,
"username": "demo",
"display_name": "Demo",
"bio": "",
"profile_image_url": "https://sandbox.sellinpublic.com/media/alphabet/d.png"
}
},
{
"id": 7,
"user_id": 2,
"conversation_id": 7,
"parent_id": 0,
"original_id": 0,
"post": "The Sandbox server is regenerated every 24 hours.",
"status": "published",
"type": "post",
"depth": 0,
"sort_order": null,
"attachment_count": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"stars": 1,
"flags": 0,
"reactions": 0,
"bumps": 0,
"created_at": "2024-03-23T08:12:04+00:00",
"updated_at": "2024-03-23T08:42:04+00:00",
"published_at": "2024-03-23T08:12:04+00:00",
"sorted_at": "2024-03-23T08:40:04+00:00",
"username": "sandbox",
"replied": false,
"flagged": false,
"starred": true,
"attachments": [],
"user": {
"user_id": 2,
"username": "sandbox",
"display_name": "Sandbox",
"bio": "",
"profile_image_url": "https://sandbox.sellinpublic.com/media/alphabet/s.png"
}
},
{
"id": 6,
"user_id": 4,
"conversation_id": 6,
"parent_id": 0,
"original_id": 0,
"post": "Sometimes bad posts make it through moderation. If that happens they can be flagged. This post was flagged by the demo user.",
"status": "published",
"type": "post",
"depth": 0,
"sort_order": null,
"attachment_count": 0,
"replies": 1,
"reposts": 0,
"quotes": 0,
"stars": 0,
"flags": 1,
"reactions": 0,
"bumps": 0,
"created_at": "2024-03-23T07:12:04+00:00",
"updated_at": "2024-03-23T08:42:04+00:00",
"published_at": "2024-03-23T07:12:04+00:00",
"sorted_at": "2024-03-23T08:39:04+00:00",
"username": "bad",
"replied": false,
"flagged": true,
"starred": false,
"attachments": [],
"user": {
"user_id": 4,
"username": "bad",
"display_name": "Bad",
"bio": "",
"profile_image_url": "https://sandbox.sellinpublic.com/media/alphabet/b.png"
}
},
{
"id": 8,
"user_id": 3,
"conversation_id": 8,
"parent_id": 0,
"original_id": 0,
"post": "The Sandbox was regenerated five minutes after the time of this post.",
"status": "published",
"type": "post",
"depth": 0,
"sort_order": null,
"attachment_count": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"stars": 0,
"flags": 0,
"reactions": 0,
"bumps": 0,
"created_at": "2024-03-23T08:37:04+00:00",
"updated_at": "2024-03-23T08:37:04+00:00",
"published_at": "2024-03-23T08:37:04+00:00",
"sorted_at": "2024-03-23T08:37:04+00:00",
"username": "good",
"replied": false,
"flagged": false,
"starred": false,
"attachments": [],
"user": {
"user_id": 3,
"username": "good",
"display_name": "Good",
"bio": "",
"profile_image_url": "https://sandbox.sellinpublic.com/media/100/profile_1.png"
}
}
]
}
GET /pending
Private endpoint. Provides the user's pending posts. The meta information will provide pagination info.
Endpoint Example
Below is a live example that can be copy and pasted.
curl https://sandbox.sellinpublic.com/api/v0/pending -u "demo:sip_api_sand_01234demo56789_key"
Below is the expected result from that cURL call:
{
"status": "success",
"messages": [],
"meta": {
"pagination": {
"total_results": 1,
"total_pages": 1,
"page_previous": 1,
"page_next": 1,
"page_current": 1,
"current_page": 1,
"current_result": 1,
"current_result_first": 1,
"current_result_last": 1,
"url_next": "/api/v0/pending?page=1",
"url_previous": "/api/v0/pending?page=1"
}
},
"data": [
{
"id": 1,
"user_id": 1,
"conversation_id": 1,
"parent_id": 0,
"original_id": 0,
"post": "This is a delayed post. When new accounts are created or when an account has been penalized, there is a delay until their posts are pu
blished publicly. Until then, the posts are listed under pending.",
"status": "pending",
"type": "post",
"depth": 0,
"sort_order": null,
"attachment_count": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"stars": 0,
"flags": 0,
"reactions": 0,
"bumps": 0,
"created_at": "2024-03-23T03:42:04+00:00",
"updated_at": "2024-03-23T03:42:04+00:00",
"published_at": "2024-03-25T08:42:04+00:00",
"sorted_at": "2024-03-25T08:42:04+00:00",
"username": "demo",
"replied": false,
"flagged": false,
"starred": false,
"attachments": [],
"user": {
"user_id": 1,
"username": "demo",
"display_name": "Demo",
"bio": "",
"profile_image_url": "https://sandbox.sellinpublic.com/media/alphabet/d.png"
}
}
]
}
POST /post
Private endpoint. Create a new post for the user.
Request body
post: string
The contents of the post.
parent_id: integer (optional)
When replying to a post, this is the id of the original post.
Endpoint Post Example
Below is a live example that can be copy and pasted.
curl https://sandbox.sellinpublic.com/api/v0/post -u "demo:sip_api_sand_01234demo56789_key" -d "post=This is an example post created by the API."
Below is the expected result from that cURL call:
{
"status": "success",
"messages": [
"Thank you for submitting your post. It will be publicly displayed in 2 minutes. New accounts have a delay in publishing to help protect against
spam."
],
"meta": {},
"data": {
"id": 10,
"user_id": 1,
"conversation_id": 0,
"parent_id": 0,
"original_id": 0,
"post": "This is an example post created by the API.",
"status": "pending",
"type": "post",
"depth": 0,
"sort_order": null,
"attachment_count": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"stars": 0,
"flags": 0,
"reactions": 0,
"bumps": 0,
"created_at": "2024-03-23T08:46:54+00:00",
"updated_at": "2024-03-23T08:46:54+00:00",
"published_at": "2024-03-23T08:48:54+00:00",
"sorted_at": "2024-03-23T08:48:54+00:00",
"username": "demo",
"replied": false,
"flagged": false,
"starred": false,
"attachments": [],
"user": {
"user_id": 1,
"username": "demo",
"display_name": "Demo",
"bio": "",
"profile_image_url": "https://sandbox.sellinpublic.com/media/alphabet/d.png"
}
}
}
Endpoint Reply Example
Below is a live example that can be copy and pasted.
curl https://sandbox.sellinpublic.com/api/v0/post -u "demo:sip_api_sand_01234demo56789_key" -d "post=This is a reply created by the API." -d "parent_id=7"
Below is the expected result from that cURL call:
{
"status": "success",
"messages": [
"Thank you for submitting your post. It will be publicly displayed in 2 minutes. New accounts have a delay in publishing to help protect against
spam."
],
"meta": {},
"data": {
"id": 11,
"user_id": 1,
"conversation_id": 7,
"parent_id": 7,
"original_id": 0,
"post": "This is a reply created by the API.",
"status": "pending",
"type": "reply",
"depth": 0,
"sort_order": null,
"attachment_count": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"stars": 0,
"flags": 0,
"reactions": 0,
"bumps": 0,
"created_at": "2024-03-23T08:48:32+00:00",
"updated_at": "2024-03-23T08:48:32+00:00",
"published_at": "2024-03-23T08:50:32+00:00",
"sorted_at": "2024-03-23T08:50:32+00:00",
"username": "demo",
"replied": false,
"flagged": false,
"starred": false,
"attachments": [],
"user": {
"user_id": 1,
"username": "demo",
"display_name": "Demo",
"bio": "",
"profile_image_url": "https://sandbox.sellinpublic.com/media/alphabet/d.png"
}
}
}
Endpoint Text Attachment Example
Below is a live example that can be copy and pasted that has multiline text and two additional text attachments. The $'...' text allows for newline characters to be sent by curl.
curl https://sandbox.sellinpublic.com/api/v0/post -u "demo:sip_api_sand_01234demo56789_key" -d "post=This is a post with two text attachments created by the API." -d "attachment_count=2" -d "attachment_type_0=text" -d $'attachment_text_0=This is some text.\n\nThis is some additional text.' -d "attachment_type_1=text" -d "attachment_text_1=This is another text attachment."
Below is the expected result from that cURL call:
{
"status": "success",
"messages": [
"Thank you for submitting your post. It will be publicly displayed in 2 minutes. New accounts have a delay in publishing to help protect against
spam."
],
"meta": {},
"data": {
"id": 10,
"user_id": 1,
"conversation_id": 0,
"parent_id": 0,
"original_id": 0,
"post": "This is a post with two text attachments created by the API.",
"status": "pending",
"type": "post",
"depth": 0,
"sort_order": null,
"attachment_count": 2,
"replies": 0,
"reposts": 0,
"quotes": 0,
"stars": 0,
"flags": 0,
"reactions": 0,
"bumps": 0,
"created_at": "2024-03-23T09:08:46+00:00",
"updated_at": "2024-03-23T09:08:46+00:00",
"published_at": "2024-03-23T09:10:46+00:00",
"sorted_at": "2024-03-23T09:10:46+00:00",
"username": "demo",
"replied": false,
"flagged": false,
"starred": false,
"attachments": [
{
"id": 1,
"user_id": 1,
"post_id": 10,
"type": "text",
"content": "This is some text.\n\nThis is some additional text.",
"sort_order": 0,
"created_at": "2024-03-23T09:08:46+00:00",
"updated_at": "2024-03-23T09:08:46+00:00"
},
{
"id": 2,
"user_id": 1,
"post_id": 10,
"type": "text",
"content": "This is another text attachment.",
"sort_order": 1,
"created_at": "2024-03-23T09:08:46+00:00",
"updated_at": "2024-03-23T09:08:46+00:00"
}
],
"user": {
"user_id": 1,
"username": "demo",
"display_name": "Demo",
"bio": "",
"profile_image_url": "https://sandbox.sellinpublic.com/media/alphabet/d.png"
}
}
}
GET /post/children/{post_id}
Public endpoint. Provides a post and its children. The meta information will provide pagination info.
URL params
post_id: integer
The id of the post.
Endpoint Example
Below is a live example that can be copy and pasted.
curl https://sandbox.sellinpublic.com/api/v0/post/children/2 -u "demo:sip_api_sand_01234demo56789_key"
Below is the expected result from that cURL call:
{
"status": "success",
"messages": [],
"meta": {
"pagination": {
"total_results": 4,
"total_pages": 1,
"page_previous": 1,
"page_next": 1,
"page_current": 1,
"current_page": 1,
"current_result": 1,
"current_result_first": 1,
"current_result_last": 4,
"url_next": "/api/v0/post/children/2?page=1",
"url_previous": "/api/v0/post/children/2?page=1"
}
},
"data": [
{
"id": 2,
"user_id": 1,
"conversation_id": 2,
"parent_id": 0,
"original_id": 0,
"post": "Welcome to the Sandbox server where you can test the interface and API interactions!",
"status": "published",
"type": "post",
"depth": 0,
"sort_order": null,
"attachment_count": 0,
"replies": 3,
"reposts": 0,
"quotes": 0,
"stars": 1,
"flags": 0,
"reactions": 0,
"bumps": 0,
"created_at": "2024-03-23T04:42:04+00:00",
"updated_at": "2024-03-23T08:42:04+00:00",
"published_at": "2024-03-23T04:42:04+00:00",
"sorted_at": "2024-03-23T08:41:04+00:00",
"username": "demo",
"replied": false,
"flagged": false,
"starred": true,
"attachments": [],
"user": {
"user_id": 1,
"username": "demo",
"display_name": "Demo",
"bio": "",
"profile_image_url": "https://sandbox.sellinpublic.com/media/alphabet/d.png"
}
},
{
"id": 3,
"user_id": 2,
"conversation_id": 2,
"parent_id": 2,
"original_id": 0,
"post": "You can post replies.",
"status": "published",
"type": "reply",
"depth": 1,
"sort_order": "0000000001/0000000000/0000000000/00000000000/0000000000/0000000000/0000000000/0000000000/0000000000/0000000000",
"attachment_count": 0,
"replies": 1,
"reposts": 0,
"quotes": 0,
"stars": 0,
"flags": 0,
"reactions": 0,
"bumps": 0,
"created_at": "2024-03-23T05:42:04+00:00",
"updated_at": "2024-03-23T05:42:04+00:00",
"published_at": "2024-03-23T05:42:04+00:00",
"sorted_at": "2024-03-23T05:42:04+00:00",
"username": "sandbox",
"replied": false,
"flagged": false,
"starred": false,
"attachments": [],
"user": {
"user_id": 2,
"username": "sandbox",
"display_name": "Sandbox",
"bio": "",
"profile_image_url": "https://sandbox.sellinpublic.com/media/alphabet/s.png"
}
},
{
"id": 5,
"user_id": 1,
"conversation_id": 2,
"parent_id": 3,
"original_id": 0,
"post": "And you can thread replies.",
"status": "published",
"type": "reply",
"depth": 2,
"sort_order": "0000000001/0000000001/0000000000/00000000000/0000000000/0000000000/0000000000/0000000000/0000000000/0000000000",
"attachment_count": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"stars": 0,
"flags": 0,
"reactions": 0,
"bumps": 0,
"created_at": "2024-03-23T06:12:04+00:00",
"updated_at": "2024-03-23T06:12:04+00:00",
"published_at": "2024-03-23T06:12:04+00:00",
"sorted_at": "2024-03-23T06:12:04+00:00",
"username": "demo",
"replied": false,
"flagged": false,
"starred": false,
"attachments": [],
"user": {
"user_id": 1,
"username": "demo",
"display_name": "Demo",
"bio": "",
"profile_image_url": "https://sandbox.sellinpublic.com/media/alphabet/d.png"
}
},
{
"id": 4,
"user_id": 3,
"conversation_id": 2,
"parent_id": 2,
"original_id": 0,
"post": "Feel free to start testing today! Checkout the API documentation if you need help:\nhttps://sellinpublic.com/documentation",
"status": "published",
"type": "reply",
"depth": 1,
"sort_order": "0000000002/0000000000/0000000000/00000000000/0000000000/0000000000/0000000000/0000000000/0000000000/0000000000",
"attachment_count": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"stars": 0,
"flags": 0,
"reactions": 0,
"bumps": 0,
"created_at": "2024-03-23T05:57:04+00:00",
"updated_at": "2024-03-23T05:57:04+00:00",
"published_at": "2024-03-23T05:57:04+00:00",
"sorted_at": "2024-03-23T05:57:04+00:00",
"username": "good",
"replied": false,
"flagged": false,
"starred": false,
"attachments": [],
"user": {
"user_id": 3,
"username": "good",
"display_name": "Good",
"bio": "",
"profile_image_url": "https://sandbox.sellinpublic.com/media/100/profile_1.png"
}
}
]
}
GET /post/single/{post_id}
Public endpoint. Provides the contents of a post.
URL params
post_id: integer
The id of the post.
Endpoint Example
Below is a live example that can be copy and pasted.
curl https://sandbox.sellinpublic.com/api/v0/post/single/2 -u "demo:sip_api_sand_01234demo56789_key"
Below is the expected result from that cURL call:
{
"status": "success",
"messages": [],
"meta": {
"pagination": {
"total_results": 1,
"total_pages": 1,
"page_previous": 1,
"page_next": 1,
"page_current": 1,
"current_page": 1,
"current_result": 1,
"current_result_first": 1,
"current_result_last": 1,
"url_next": "/api/v0/post/single/2?page=1",
"url_previous": "/api/v0/post/single/2?page=1"
}
},
"data": [
{
"id": 2,
"user_id": 1,
"conversation_id": 2,
"parent_id": 0,
"original_id": 0,
"post": "Welcome to the Sandbox server where you can test the interface and API interactions!",
"status": "published",
"type": "post",
"depth": 0,
"sort_order": null,
"attachment_count": 0,
"replies": 3,
"reposts": 0,
"quotes": 0,
"stars": 1,
"flags": 0,
"reactions": 0,
"bumps": 0,
"created_at": "2024-03-23T04:42:04+00:00",
"updated_at": "2024-03-23T08:42:04+00:00",
"published_at": "2024-03-23T04:42:04+00:00",
"sorted_at": "2024-03-23T08:41:04+00:00",
"username": "demo",
"replied": false,
"flagged": false,
"starred": true,
"attachments": [],
"user": {
"user_id": 1,
"username": "demo",
"display_name": "Demo",
"bio": "",
"profile_image_url": "https://sandbox.sellinpublic.com/media/alphabet/d.png"
}
}
]
}
GET /timeline/user/{username}
Public endpoint. Provides the user posts. The meta information will provide pagination info.
URL params
username: string
The username for the account.
Endpoint Example
Below is a live example that can be copy and pasted.
curl https://sandbox.sellinpublic.com/api/v0/timeline/user/sandbox -u "demo:sip_api_sand_01234demo56789_key"
Below is the expected result from that cURL call:
{
"status": "success",
"messages": [],
"meta": {
"pagination": {
"total_results": 1,
"total_pages": 1,
"page_previous": 1,
"page_next": 1,
"page_current": 1,
"current_page": 1,
"current_result": 1,
"current_result_first": 1,
"current_result_last": 1,
"url_next": "/api/v0/timeline/user/sandbox?page=1",
"url_previous": "/api/v0/timeline/user/sandbox?page=1"
}
},
"data": [
{
"id": 7,
"user_id": 2,
"conversation_id": 7,
"parent_id": 0,
"original_id": 0,
"post": "The Sandbox server is regenerated every 24 hours.",
"status": "published",
"type": "post",
"depth": 0,
"sort_order": null,
"attachment_count": 0,
"replies": 1,
"reposts": 0,
"quotes": 0,
"stars": 1,
"flags": 0,
"reactions": 0,
"bumps": 1,
"created_at": "2024-03-23T08:12:04+00:00",
"updated_at": "2024-03-23T08:51:01+00:00",
"published_at": "2024-03-23T08:12:04+00:00",
"sorted_at": "2024-03-23T08:51:01+00:00",
"username": "sandbox",
"replied": true,
"flagged": false,
"starred": true,
"attachments": [],
"user": {
"user_id": 2,
"username": "sandbox",
"display_name": "Sandbox",
"bio": "",
"profile_image_url": "https://sandbox.sellinpublic.com/media/alphabet/s.png"
}
}
]
}