Blog Posts

Manage blog posts on your Ning Network

Properties

id (id) [Read only]
The unique ID for a blog post
author (screenname) [Read only]
The screen name of the member who created the blog post
createdDate (date) [Read only]
The time stamp from the creation date
publishTime (date) [Read/Write]
The time stamp for when to publish the blog post, can be a time in the future or the past. If you want to use the current time, use the value now.
publishStatus (string) [Read/Write]
The status of the blog post, can be either draft, queued, or publish
updatedDate (date) [Read only]
The time stamp from the last modification
featuredDate (date) [Read only]
When the blog post was featured
title (string) [Read/Write]
The title of the blog post
description (string) [Read/Write]
The content of the blog post
visibility (visibility) [Read/Write]
Can friends see or all members see the blog post
approved (boolean) [Read/Write]
True if the administrator has approved the blog post
commentCount (int) [Read only]
The number of comments on the blog post
url (url) [Read only]
URL of the blog post
topTags (string) [Read only]
A array of the most popular tags: [ "food", "apple" ]
tag (string) [Write only]
Used during create and update requests to set tags on the blog post. Reading from this field is depreciated, instead use the topTags attribute.

Sub-Properties

author.fullName (string) [Read only]
The full name of the author
author.iconUrl (url) [Read only]
The author’s profile photo
author.url (url) [Read only]
The author’s profile page on the Ning Network

HTTP GET

/xn/rest/apiexample/1.0/BlogPost

Retrieve a specific blog post or a specific set of blog posts, up to 100.

Required Query Parameters:

id (id)
The ID of the blog post, multiple id parameters are allowed, up to 100

Optional Query Parameters:

fields (field)
Comma-separated list of desired properties, this is only a hint to the server

/xn/rest/apiexample/1.0/BlogPost/recent

Retrieve blog posts sorted by createdDate

Optional Query Parameters:

author (screenname)
Retrieve blog posts for a specific user
private (boolean)
If true, only retrieve private blog posts. If you are not the Network Creator, using this parameter will result in a 403 Forbidden error.
approved (boolean)
If true, only retrieve approved blog posts
tag (string)
Only include blog posts with the specified tag
fields (field)
Comma-separated list of desired properties, this is only a hint to the server
anchor (string)
An opaque token encodes the page of results returned, used in conjunction with count to page through a result set
count (int)
Returns one blog post by default and supports a maximum of 100. Also supports negative values down to -100 for retrieving blog posts before the anchor.

/xn/rest/apiexample/1.0/BlogPost/count

Retrieve the number of blog posts created after the given date

Required Query Parameters:

createdAfter (date)
The ISO-8601 date to start counting after. If the date is more than a week old, a 400 response will be returned

Optional Query Parameters:

author (screenname)
Retrieve the number of blog posts for a specific user
private (boolean)
If true, only retrieve the number of private blog posts. If you are not the Network Creator, using this parameter will result in a 403 Forbidden error.
approved (boolean)
If true, only retrieve the number of approved blog posts
tag (string)
Only count blog posts with the specified tag

HTTP POST

/xn/rest/apiexample/1.0/BlogPost

Create a new blog post

HTTP PUT

/xn/rest/apiexample/1.0/BlogPost

Update the blog post with the given ID

Required Query Parameters:

id (id)
The ID of the blog post

HTTP DELETE

/xn/rest/apiexample/1.0/BlogPost

Delete the blog post with the given ID

Required Query Parameters:

id (id)
The ID of the blog