Currently viewing the sandbox server.

Posts

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"
      }
    }
  ]
}