Blog Posts API | Weebly Developer Documentation

Site owners create blog posts for their blogs. Weebly blog posts can accept comments from readers. When comments are allowed, they can be anonymous and they can optionally require approval. The approval process is handled by the moderation app (such as Disqus) set on the blog.

​Use the Blog Post API to return details about a post to a blog, or to update a post. A message can be configured to be used when blog posts are shared on social media. Tags are used to group blog posts together.

The following table shows all fields that exist for this API, those that are returned when you retrieve a list, those that are required for PUT and those that are changeable using PATCH and PUT. All fields are returned when you retrieve a single item.

Name
Description
Type
List
Required
Changeable

​user_id
The unique ID of the authenticated user
string
X

site_id
ID of a Weebly site, unique to the currently authenticated user​
string
X
X

post_id
Unique ID for this blog post.
string
X

post_title
Title of the blog post.
string
X

X

post_body
Content of the post, including the markup.
string
X
X
X

post_author
The unique user_id of the user who created the post.
string
X

post_created_date
​Date the post draft was first created.
string
X

post_lastrevision_date
​Date the post was last updated.
string

allow_comments
Whether or not comments are allowed for this post, and if allowed, if non-anonymous comments are allowed.
Valid values are:

• yes: Comments are allowed.
• no: Comments are allowed.
• noanon: Comments are allowed, but they can’t be anonymous.

string

X

post_link
URL for this post, for example, mynewblogpost.html
string

require_approval
Whether or not comments require approval on this post.
​Valid values are:

• true
• false

boolean

post_url
​The full URL, including protocol, to the post. For example:
http://mysite.weebly.com/blog/mynewblogpost.html
string

share_message
​​Deprecated as of 10/18/18
The configured message to be used when sharing the post.
string

seo_title
​​​The SEO title for the post. Site owners can create a different title for the browser title bar.

string

seo_description
​​​The SEO page description for the post.

string

tags
​​​​An array of strings that represent tags for the post. These are shown as Categories in the UI.

array of strings

X

commenting_system
The system used to allow commenting on the blog. The value default means that the native Weebly system is used.
Valid values are:

• ​default
• disqus
• facebook

string

date_format
Format used for dates on this site.
Valid values are:

• n/j/Y: month/day/year
• j/n/Y: day/month/year

string

created_date
Date the post was first created.
Unix GMT Timestamp
X

updated_date
Date the post was last updated.
Unix GMT Timestamp