Blog Posts
Users can post blog posts about any subject they desire. They can be tagged with stories to show up for users who have that story in their bookshelves.
Relevant Scopes
write_blog_posts
Table of Contents
Search all blog posts on the site
Returns
[ blog_post ]
Parameters
| query |
Perform a search inside blog posts. Looks in title, content and tags. Use -relevance to sort results by how well they match. |
Filters
|
ids
id,id,id...
|
Filter out blog posts with ids not in the comma delimited list |
|
author
author_id(int)
|
Filter out blog posts not made by author_id |
|
tags
tag,tag,tag...
|
Filter out blog posts that don't have any of the provided tags |
|
site_post
site_post(bool)
|
Filter out blog posts based on whether they are site posts or not |
|
site_post_tag
site_post_tag(string)
|
Filter out blog posts that are not tagged with site_post_tag |
|
date_posted
minimum(date),maximum(date)
|
Filter out blog posts made before minimum and after maximum Dates should be ISO 8601 |
Sort
Max sort fields: 1
|
date_posted
|
Date the blog post was made |
|
num_views
|
The number of views the blog post has |
|
relevance
|
Relevance (when providing a search query) |
Get a blog post by id
Returns
Parameters
| id required | The numeric ID of the blog post |
Post a new blog entry from the authenticated user
Returns
Body
Scopes
- write_blog_posts - Required
Update a blog post by id. Site posts can not be edited through the API
Returns
Scopes
- write_blog_posts - Required
Parameters
| id required | The numeric ID of the blog post |
Delete a blog post by id. Site posts can not be deleted through the API
Scopes
- write_blog_posts - Required
Parameters
| id required | The numeric ID of the blog post |