Full DropInBlog JSON API documentation
The DropInBlog API provides a method of retrieving blog data from your DropInBlog account, allowing you to build a completely custom front-end using modern development tools.
Authentication can be done using your blog authentication key, which can be found within the Code & Layout section of your account.
DropInBlog provides a series of endpoints to retrieve data from its set of object types. Those types are posts, categories, and authors.
The posts endpoint is the primary resource for blog content. Example usage:
POSTS EXAMPLE DATA
Posts data can be modified on request with the following query parameters:
includecontent
1 or 0 (true or false respectively)
Include post content on posts
category
category slug*
Filter posts by a category
categories
category slugs*
Filter posts by a comma separated list of categories
author
author slug*
Filter posts by a particular author using their slug
page
number*
Get a specific page from paginated posts
limit
number* or all
Get a specific number of new posts, or all posts
featureimage
main or thumb
Include post feature images as the main image or thumbnail image
post
post slug(s)* (comma separated)
Get a specific post, or posts, using the post slug
excludepinned
1 or 0 (true or false respectively)
Exclude pinned posts
FILTERED POSTS EXAMPLE DATA
A common use case is using the API to retrieve all posts in full as part of a build process, and using that data to construct a blog containing all content. This would require setting the post limit to all and including the post content as part of each post. Here’s an example:
curl "https://api.dropinblog.com/v1/json/?b=XXXXXXXXXXXXXXXXXXXXXX&limit=all&includecontent=1"
FULL POSTS EXAMPLE DATA
The search endpoint is for searching your posts, and has one required parameter of q=write. It will search the title, content, keyword, slug, SEO title, and SEO description fields of your posts.
Search endpoint example
POST EXAMPLE DATA
The post endpoint is for requesting a specific post from DropInBlog, and has one required parameter of post=post-slug.
Post endpoint example
POST EXAMPLE DATA
All blog categories can be retrieved using the categories endpoint, returning the title and slug for each category.
Categories endpoint example
CATEGORIES EXAMPLE DATA
All blog authors can be retrieved using the categories endpoint, returning the title, photo, and slug for each author.
Authors endpoint example
AUTHORS EXAMPLE DATA
Below are some additional examples of how posts are returned when interacting with the DropInBlog API. Seeing these in isolation can help with using data points in your application.
An example single post when retrieving all posts from the posts API:
DEFAULT POST EXAMPLE DATA
Post object with attributes
An example post when retrieving a single post from the post API:
POST WITH ATTRIBUTES EXAMPLE DATA
Authentication
Authentication can be done using your blog authentication key, which can be found within the Code & Layout section of your account.
Endpoints
DropInBlog provides a series of endpoints to retrieve data from its set of object types. Those types are posts, categories, and authors.
Endpoints & Example JSON URLs
Posts endpoint
https://api.dropinblog.com/v1/json/?b=XXXXXXXXXXXXXXXXXXXXXSearch endpoint
https://api.dropinblog.com/v1/json/search/?b=XXXXXXXXXXXXXXXXXXXXXSingle post endpoint
https://api.dropinblog.com/v1/json/post/?b=XXXXXXXXXXXXXXXXXXXXXCategories endpoint
https://api.dropinblog.com/v1/json/categories/?b=XXXXXXXXXXXXXXXXXXXXXAuthors endpoint
https://api.dropinblog.com/v1/json/authors/?b=XXXXXXXXXXXXXXXXXXXXXPosts endpoint
The posts endpoint is the primary resource for blog content. Example usage:
curl "https://api.dropinblog.com/v1/json/?b=XXXXXXXXXXXXXXXXXXXXXX"POSTS EXAMPLE DATA
{
"status": "success",
"data": {
"moreText": "More \u00bb",
"nextText": "Next \u21e2",
"previousText": "\u21e0 Previous",
"headTitle": "Blog",
"homepageTitle": "",
"headDescription": "",
"posts": [
{
"title": "Pour over tips & tricks",
"summary": "Aliquam interdum libero nibh, quis gravida orci tincidunt ut. Phasellus placerat leo lorem, eu congue arcu volutpat ut. In at laoreet est, nec facilisis lacus. Cras fermentum vel neque at vestibulum.\r\nAliquam interdum libero nibh, quis gravida orci",
"content": "",
"slug": "pour-over-tips-and-tricks",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/anastasia-zhenina-Ivji5bb1Vh4-unsplash.jpg",
"publishedAt": "August 22nd, 2020",
"updatedAt": "October 20th, 2020",
"categories": [{ "title": "General", "slug": "general" }],
"author": {
"name": "Dave",
"slug": "dave",
"photo": "https://io.dropinblog.com/img/blogs/34238346/files/authors/0787ea652b3163a86ec59aa5d9c7b2a65c4607aa.jpg"
},
"readtime": "2 minute read",
"pinned": false
},
{
"title": "New dark roasts just in!",
"summary": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.\r\nLorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vel ipsum sit amet enim mollis malesuada. Nulla tincidunt sem ac eros consequat pulvinar at quis risus. Aenean ultricies",
"content": "",
"slug": "new-dark-roasts",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/gregory-hayes-MjvOQ__XFgI-unsplash.jpg",
"publishedAt": "August 10th, 2020",
"updatedAt": "October 20th, 2020",
"categories": [{ "title": "Stock updates", "slug": "stock" }],
"author": {
"name": "Dave",
"slug": "dave",
"photo": "https://io.dropinblog.com/img/blogs/34238346/files/authors/0787ea652b3163a86ec59aa5d9c7b2a65c4607aa.jpg"
},
"readtime": "2 minute read",
"pinned": false
},
{
"title": "Our espresso technique",
"summary": "Etiam et nunc tortor. Nunc a eleifend libero. Morbi placerat semper sagittis. Curabitur vitae risus pharetra, rutrum nisi et, pellentesque metus. Morbi mollis luctus pellentesque. Quisque mollis ullamcorper felis, at tincidunt libero tincidunt sed.",
"content": "",
"slug": "our-espresso-technique",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/louis-hansel-shotsoflouis-Unz1DfQUUuQ-unsplash.jpg",
"publishedAt": "July 5th, 2020",
"updatedAt": "April 6th, 2021",
"categories": [{ "title": "General", "slug": "general" }],
"author": {
"name": "Dave",
"slug": "dave",
"photo": "https://io.dropinblog.com/img/blogs/34238346/files/authors/0787ea652b3163a86ec59aa5d9c7b2a65c4607aa.jpg"
},
"readtime": "2 minute read",
"pinned": false
},
{
"title": "Discounts this spring",
"summary": "Sed sem mi, finibus nec faucibus quis, luctus at massa. Etiam tincidunt ipsum eget lobortis egestas. Sed interdum ac purus vel finibus. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Etiam tempus, nibh",
"content": "",
"slug": "discounts-this-spring",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/fly-d-N7XAzGyeICY-unsplash.jpg",
"publishedAt": "February 25th, 2020",
"updatedAt": "October 20th, 2020",
"categories": [{ "title": "Discounts", "slug": "discounts" }],
"author": {
"name": "Dave",
"slug": "dave",
"photo": "https://io.dropinblog.com/img/blogs/34238346/files/authors/0787ea652b3163a86ec59aa5d9c7b2a65c4607aa.jpg"
},
"readtime": "1 minute read",
"pinned": false
}
],
"totalPosts": 4
}
}Parameters
Posts data can be modified on request with the following query parameters:
Parameter Keys, Values, and Descriptions
includecontent
1 or 0 (true or false respectively)
Include post content on posts
category
category slug*
Filter posts by a category
categories
category slugs*
Filter posts by a comma separated list of categories
author
author slug*
Filter posts by a particular author using their slug
page
number*
Get a specific page from paginated posts
limit
number* or all
Get a specific number of new posts, or all posts
featureimage
main or thumb
Include post feature images as the main image or thumbnail image
post
post slug(s)* (comma separated)
Get a specific post, or posts, using the post slug
excludepinned
1 or 0 (true or false respectively)
Exclude pinned posts
Posts endpoint example
curl "https://api.dropinblog.com/v1/json/?b=XXXXXXXXXXXXXXXXXXXXXX&author=dave&category=discounts"FILTERED POSTS EXAMPLE DATA
{
"status": "success",
"data": {
"moreText": "More \u00bb",
"nextText": "Next \u21e2",
"previousText": "\u21e0 Previous",
"category": { "title": "Discounts" },
"headTitle": "Discounts",
"headDescription": "Offers and discounts on our beans",
"posts": [
{
"title": "Discounts this spring",
"summary": "Sed sem mi, finibus nec faucibus quis, luctus at massa. Etiam tincidunt ipsum eget lobortis egestas. Sed interdum ac purus vel finibus. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Etiam tempus, nibh",
"content": "",
"slug": "discounts-this-spring",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/fly-d-N7XAzGyeICY-unsplash.jpg",
"publishedAt": "February 25th, 2020",
"updatedAt": "October 20th, 2020",
"categories": [{ "title": "Discounts", "slug": "discounts" }],
"author": {
"name": "Dave",
"slug": "dave",
"photo": "https://io.dropinblog.com/img/blogs/34238346/files/authors/0787ea652b3163a86ec59aa5d9c7b2a65c4607aa.jpg"
},
"readtime": "1 minute read",
"pinned": false
}
],
"pinnedPosts": [],
"totalPosts": 1
}
}Full posts example
A common use case is using the API to retrieve all posts in full as part of a build process, and using that data to construct a blog containing all content. This would require setting the post limit to all and including the post content as part of each post. Here’s an example:
curl "https://api.dropinblog.com/v1/json/?b=XXXXXXXXXXXXXXXXXXXXXX&limit=all&includecontent=1"
FULL POSTS EXAMPLE DATA
{
"status": "success",
"data": {
"moreText": "More \u00bb",
"nextText": "Next \u21e2",
"previousText": "\u21e0 Previous",
"headTitle": "Blog",
"homepageTitle": "",
"headDescription": "",
"posts": [
{
"title": "Pour over tips & tricks",
"summary": "Aliquam interdum libero nibh, quis gravida orci tincidunt ut. Phasellus placerat leo lorem, eu congue arcu volutpat ut. In at laoreet est, nec facilisis lacus. Cras fermentum vel neque at vestibulum.\r\nAliquam interdum libero nibh, quis gravida orci",
"content": "<p><strong>Aliquam interdum libero nibh, quis gravida orci tincidunt ut. Phasellus placerat leo lorem, eu congue arcu volutpat ut. In at laoreet est, nec facilisis lacus. Cras fermentum vel neque at vestibulum.</strong></p>\r\n<p>Aliquam interdum libero nibh, quis gravida orci tincidunt ut. Phasellus placerat leo lorem, eu congue arcu volutpat ut. In at laoreet est, nec facilisis lacus. Cras fermentum vel neque at vestibulum. Pellentesque interdum, felis sit amet mattis tincidunt, erat massa rhoncus lacus, quis fermentum lectus tortor at risus. Nullam finibus odio sodales, scelerisque magna vel, dapibus libero. Aenean in urna sed quam convallis lacinia.</p>\r\n<p>Curabitur felis nulla, mattis ac placerat ac, tempus ac quam. Vivamus ultricies ligula massa, ac mattis lacus sodales vel. Donec semper elit ac dui ultrices ullamcorper. Suspendisse eget felis eu augue efficitur malesuada at cursus diam.</p>\r\n<p>Sed sem mi, finibus nec faucibus quis, luctus at massa. Etiam tincidunt ipsum eget lobortis egestas. Sed interdum ac purus vel finibus. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Etiam tempus, nibh vehicula pretium ornare, nisl dui porta nulla, non maximus mi libero sed quam. Curabitur ullamcorper fermentum eleifend. Curabitur varius enim eu quam tincidunt, nec faucibus tellus commodo. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Proin fermentum, augue nec convallis molestie, nibh odio hendrerit ipsum, ac iaculis magna ligula nec magna. Nunc velit felis, pretium quis purus dapibus, rutrum aliquet urna. Integer nec scelerisque turpis, quis viverra nisi. Fusce varius ligula a purus varius, eu tincidunt massa viverra. Donec ac tincidunt lorem, eu placerat ante. Integer eu nisl nisl.</p>",
"slug": "pour-over-tips-and-tricks",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/anastasia-zhenina-Ivji5bb1Vh4-unsplash.jpg",
"publishedAt": "August 22nd, 2020",
"updatedAt": "October 20th, 2020",
"categories": [{ "title": "General", "slug": "general" }],
"author": {
"name": "Dave",
"slug": "dave",
"photo": "https://io.dropinblog.com/img/blogs/34238346/files/authors/0787ea652b3163a86ec59aa5d9c7b2a65c4607aa.jpg"
},
"readtime": "2 minute read",
"pinned": false
},
{
"title": "New dark roasts just in!",
"summary": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.\r\nLorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vel ipsum sit amet enim mollis malesuada. Nulla tincidunt sem ac eros consequat pulvinar at quis risus. Aenean ultricies",
"content": "<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>\r\n<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vel ipsum sit amet enim mollis malesuada. Nulla tincidunt sem ac eros consequat pulvinar at quis risus. Aenean ultricies imperdiet hendrerit. Nam dignissim commodo tempor. Cras hendrerit dolor sit amet nisi mollis, id eleifend odio ultrices. Pellentesque et justo malesuada, dignissim dolor sed, lobortis mauris. Pellentesque nec tortor quam. Vestibulum volutpat quis lorem vel ornare. Aenean nec porttitor orci. Sed varius arcu quis metus consequat eleifend. Aliquam erat volutpat. Pellentesque semper imperdiet eros, at convallis nibh scelerisque at. Vestibulum non leo a ante aliquet rutrum. Nunc dui arcu, blandit at mauris sit amet, porttitor consequat risus.</p>\r\n<p>Etiam et nunc tortor. Nunc a eleifend libero. Morbi placerat semper sagittis. Curabitur vitae risus pharetra, rutrum nisi et, pellentesque metus. Morbi mollis luctus pellentesque. Quisque mollis ullamcorper felis, at tincidunt libero tincidunt sed. Proin pellentesque eget felis id pharetra. In quis ex elit. Nam sit amet lorem eu ipsum suscipit porttitor accumsan ac nisl. Ut vel nunc in nunc fermentum aliquet. Cras id lacinia erat. Etiam suscipit sapien nec elit venenatis convallis. Mauris nec turpis felis. Duis lacinia gravida dui, sed finibus neque luctus malesuada. Donec finibus euismod arcu, ac pretium enim consectetur vitae. Fusce aliquet mauris venenatis ipsum malesuada, eget pharetra nunc congue.</p>",
"slug": "new-dark-roasts",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/gregory-hayes-MjvOQ__XFgI-unsplash.jpg",
"publishedAt": "August 10th, 2020",
"updatedAt": "October 20th, 2020",
"categories": [{ "title": "Stock updates", "slug": "stock" }],
"author": {
"name": "Dave",
"slug": "dave",
"photo": "https://io.dropinblog.com/img/blogs/34238346/files/authors/0787ea652b3163a86ec59aa5d9c7b2a65c4607aa.jpg"
},
"readtime": "2 minute read",
"pinned": false
},
{
"title": "Our espresso technique",
"summary": "Etiam et nunc tortor. Nunc a eleifend libero. Morbi placerat semper sagittis. Curabitur vitae risus pharetra, rutrum nisi et, pellentesque metus. Morbi mollis luctus pellentesque. Quisque mollis ullamcorper felis, at tincidunt libero tincidunt sed.",
"content": "<p>Etiam et nunc tortor. Nunc a eleifend libero. Morbi placerat semper sagittis. Curabitur vitae risus pharetra, rutrum nisi et, pellentesque metus. Morbi mollis luctus pellentesque. Quisque mollis ullamcorper felis, at tincidunt libero tincidunt sed. Proin pellentesque eget felis id pharetra. In quis ex elit. Nam sit amet lorem eu ipsum suscipit porttitor accumsan ac nisl. Ut vel nunc in nunc fermentum aliquet. Cras id lacinia erat. Etiam suscipit sapien nec elit venenatis convallis. Mauris nec turpis felis. Duis lacinia gravida dui, sed finibus neque luctus malesuada. Donec finibus euismod arcu, ac pretium enim consectetur vitae. Fusce aliquet mauris venenatis ipsum malesuada, eget pharetra nunc congue.</p>\r\n<p>Aliquam interdum libero nibh, quis gravida orci tincidunt ut. Phasellus placerat leo lorem, eu congue arcu volutpat ut. In at laoreet est, nec facilisis lacus. Cras fermentum vel neque at vestibulum. Pellentesque interdum, felis sit amet mattis tincidunt, erat massa rhoncus lacus, quis fermentum lectus tortor at risus. Nullam finibus odio sodales, scelerisque magna vel, dapibus libero. Aenean in urna sed quam convallis lacinia. Curabitur felis nulla, mattis ac placerat ac, tempus ac quam. Vivamus ultricies ligula massa, ac mattis lacus sodales vel. Donec semper elit ac dui ultrices ullamcorper. Suspendisse eget felis eu augue efficitur malesuada at cursus diam.</p>",
"slug": "our-espresso-technique",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/louis-hansel-shotsoflouis-Unz1DfQUUuQ-unsplash.jpg",
"publishedAt": "July 5th, 2020",
"updatedAt": "April 6th, 2021",
"categories": [{ "title": "General", "slug": "general" }],
"author": {
"name": "Dave",
"slug": "dave",
"photo": "https://io.dropinblog.com/img/blogs/34238346/files/authors/0787ea652b3163a86ec59aa5d9c7b2a65c4607aa.jpg"
},
"readtime": "2 minute read",
"pinned": false
},
{
"title": "Discounts this spring",
"summary": "Sed sem mi, finibus nec faucibus quis, luctus at massa. Etiam tincidunt ipsum eget lobortis egestas. Sed interdum ac purus vel finibus. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Etiam tempus, nibh",
"content": "<p>Sed sem mi, finibus nec faucibus quis, luctus at massa. Etiam tincidunt ipsum eget lobortis egestas. Sed interdum ac purus vel finibus. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Etiam tempus, nibh vehicula pretium ornare, nisl dui porta nulla, non maximus mi libero sed quam. Curabitur ullamcorper fermentum eleifend. Curabitur varius enim eu quam tincidunt, nec faucibus tellus commodo. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Proin fermentum, augue nec convallis molestie, nibh odio hendrerit ipsum, ac iaculis magna ligula nec magna. Nunc velit felis, pretium quis purus dapibus, rutrum aliquet urna. Integer nec scelerisque turpis, quis viverra nisi. Fusce varius ligula a purus varius, eu tincidunt massa viverra. Donec ac tincidunt lorem, eu placerat ante. Integer eu nisl nisl.</p>\r\n<p>Proin orci tortor, consequat eu nibh at, ultrices efficitur arcu. Donec quis tempus lorem. Donec sed eleifend neque. Aenean luctus, turpis in euismod sagittis, ex nisl faucibus velit, non faucibus dolor magna non lacus. Etiam a leo at justo bibendum pretium vitae non ipsum. Aliquam maximus turpis fringilla, egestas augue a, dignissim sapien. Aenean malesuada turpis sed fermentum vehicula. Nulla mollis convallis bibendum.</p>",
"slug": "discounts-this-spring",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/fly-d-N7XAzGyeICY-unsplash.jpg",
"publishedAt": "February 25th, 2020",
"updatedAt": "October 20th, 2020",
"categories": [{ "title": "Discounts", "slug": "discounts" }],
"author": {
"name": "Dave",
"slug": "dave",
"photo": "https://io.dropinblog.com/img/blogs/34238346/files/authors/0787ea652b3163a86ec59aa5d9c7b2a65c4607aa.jpg"
},
"readtime": "1 minute read",
"pinned": false
}
],
"totalPosts": 4
}
}Search endpoint
The search endpoint is for searching your posts, and has one required parameter of q=write. It will search the title, content, keyword, slug, SEO title, and SEO description fields of your posts.
Search endpoint example
curl "https://api.dropinblog.com/v1/json/search/?b=XXXXXXXXXXXXXXXXXXXXXX&q=write"POST EXAMPLE DATA
{
"status": "success",
"data": {
"post": {
"id": "1",
"title": "How to write your first blog post with DropInBlog",
"summary": "Congratulations! You're ready to write your first blog post with DropInBlog! If you've come this far, you've already done a few things: You already know about the benefits of blogging. You already know why DropInBlog is the best blogging platform out there.",
"slug": "how-to-write-your-first-blog-post-with-dropinblog",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34234356/files/featured/write-your-first-blog-post.png",
"publishedAt": "February 25th, 2020",
"updatedAt": "October 20th, 2020",
"keyword": "write your first blog post",
"seoTitle": "How to write your first blog post with DropInBlog",
"seoDescription": "DropInBlog is the WordPress alternative that makes it easy to get your blog up and running. Learn how to write your first blog post using our powerful platform.",
"categories": [{ "title": "Tips", "slug": "tips" }],
"author": {
"name": "Dave",
"slug": "dave",
"photo": "https://io.dropinblog.com/img/blogs/34238346/files/authors/0787ea652b3163a86ec59aa5d9c7b2a65c4607aa.jpg"
},
"readtime": "1 minute read",
"pinned": 0
}
}
}Single post endpoint
The post endpoint is for requesting a specific post from DropInBlog, and has one required parameter of post=post-slug.
Post endpoint example
curl "https://api.dropinblog.com/v1/json/post/?b=XXXXXXXXXXXXXXXXXXXXXX&post=discounts-this-spring"POST EXAMPLE DATA
{
"status": "success",
"data": {
"headTitle": "Discounts this spring",
"headDescription": "Sed sem mi, finibus nec faucibus quis, luctus at massa. Etiam tincidunt ipsum eget lobortis egestas. Sed interdum ac purus vel finibus. Class aptent",
"nextText": "Next \u21e2",
"previousText": "\u21e0 Previous",
"post": {
"title": "Discounts this spring",
"summary":"Sed sem mi, finibus nec faucibus quis, luctus at massa. Etiam tincidunt ipsum eget lobortis egestas. Sed interdum ac purus vel finibus. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.",
"content": "<p>Sed sem mi, finibus nec faucibus quis, luctus at massa. Etiam tincidunt ipsum eget lobortis egestas. Sed interdum ac purus vel finibus. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Etiam tempus, nibh vehicula pretium ornare, nisl dui porta nulla, non maximus mi libero sed quam. Curabitur ullamcorper fermentum eleifend. Curabitur varius enim eu quam tincidunt, nec faucibus tellus commodo. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Proin fermentum, augue nec convallis molestie, nibh odio hendrerit ipsum, ac iaculis magna ligula nec magna. Nunc velit felis, pretium quis purus dapibus, rutrum aliquet urna. Integer nec scelerisque turpis, quis viverra nisi. Fusce varius ligula a purus varius, eu tincidunt massa viverra. Donec ac tincidunt lorem, eu placerat ante. Integer eu nisl nisl.</p>\r\n<p>Proin orci tortor, consequat eu nibh at, ultrices efficitur arcu. Donec quis tempus lorem. Donec sed eleifend neque. Aenean luctus, turpis in euismod sagittis, ex nisl faucibus velit, non faucibus dolor magna non lacus. Etiam a leo at justo bibendum pretium vitae non ipsum. Aliquam maximus turpis fringilla, egestas augue a, dignissim sapien. Aenean malesuada turpis sed fermentum vehicula. Nulla mollis convallis bibendum.</p>",
"slug": "discounts-this-spring",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/fly-d-N7XAzGyeICY-unsplash.jpg",
"publishedAt": "February 25th, 2020",
"updatedAt": "October 20th, 2020",
"categories": [{ "title": "Discounts", "slug": "discounts" }],
"author": {
"name": "Dave",
"slug": "dave",
"photo": "https://io.dropinblog.com/img/blogs/34238346/files/authors/0787ea652b3163a86ec59aa5d9c7b2a65c4607aa.jpg"
},
"related_posts": [
{
"title": "Our espresso technique",
"summary": "Etiam et nunc tortor. Nunc a eleifend libero. Morbi placerat semper sagittis. Curabitur vitae risus pharetra, rutrum nisi et, pellentesque metus. Morbi mollis luctus pellentesque. Quisque mollis ullamcorper felis, at tincidunt libero tincidunt sed.",
"slug": "our-espresso-technique",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/louis-hansel-shotsoflouis-Unz1DfQUUuQ-unsplash.jpg",
"publishedAt": "July 5th, 2020",
"updatedAt": "April 6th, 2021"
},
{
"title": "New dark roasts just in!",
"summary": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.\r\nLorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vel ipsum sit amet enim mollis malesuada. Nulla tincidunt sem ac eros consequat pulvinar at quis risus. Aenean ultricies",
"slug": "new-dark-roasts",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/gregory-hayes-MjvOQ__XFgI-unsplash.jpg",
"publishedAt": "August 10th, 2020",
"updatedAt": "October 20th, 2020"
},
{
"title": "Pour over tips & tricks",
"summary": "Aliquam interdum libero nibh, quis gravida orci tincidunt ut. Phasellus placerat leo lorem, eu congue arcu volutpat ut. In at laoreet est, nec facilisis lacus. Cras fermentum vel neque at vestibulum.\r\nAliquam interdum libero nibh, quis gravida orci",
"slug": "pour-over-tips-and-tricks",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/anastasia-zhenina-Ivji5bb1Vh4-unsplash.jpg",
"publishedAt": "August 22nd, 2020",
"updatedAt": "October 20th, 2020"
}
],
"readtime": "1 minute read"
}
}
}Categories endpoint
All blog categories can be retrieved using the categories endpoint, returning the title and slug for each category.
Categories endpoint example
curl "https://api.dropinblog.com/v1/json/categories/?b=XXXXXXXXXXXXXXXXXXXXXX"CATEGORIES EXAMPLE DATA
{
"status": "success",
"data": [
{ "title": "Discounts", "slug": "discounts" },
{ "title": "General", "slug": "general" },
{ "title": "Stock updates", "slug": "stock" }
]
}Authors endpoint
All blog authors can be retrieved using the categories endpoint, returning the title, photo, and slug for each author.
Authors endpoint example
curl "https://api.dropinblog.com/v1/json/authors/?b=XXXXXXXXXXXXXXXXXXXXXX"AUTHORS EXAMPLE DATA
{
"status": "success",
"data": [
{
"name": "Dave",
"slug": "dave",
"photo": "https://io.dropinblog.com/img/blogs/34238346/files/authors/0787ea652b3163a86ec59aa5d9c7b2a65c4607aa.jpg"
}
]
}Post object examples
Below are some additional examples of how posts are returned when interacting with the DropInBlog API. Seeing these in isolation can help with using data points in your application.
Default post object
An example single post when retrieving all posts from the posts API:
DEFAULT POST EXAMPLE DATA
{
"title": "Pour over tips & tricks",
"summary": "Aliquam interdum libero nibh, quis gravida orci tincidunt ut. Phasellus placerat leo lorem, eu congue arcu volutpat ut. In at laoreet est, nec facilisis lacus. Cras fermentum vel neque at vestibulum.\r\nAliquam interdum libero nibh, quis gravida orci",
"content": "",
"slug": "pour-over-tips-and-tricks",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/anastasia-zhenina-Ivji5bb1Vh4-unsplash.jpg",
"publishedAt": "August 22nd, 2020",
"updatedAt": "October 20th, 2020",
"categories": [{ "title": "General", "slug": "general" }],
"author": {
"name": "Dave",
"slug": "dave",
"photo": "https://io.dropinblog.com/img/blogs/34238346/files/authors/0787ea652b3163a86ec59aa5d9c7b2a65c4607aa.jpg"
},
"readtime": "2 minute read",
"pinned": false
}Post object with attributes
An example post when retrieving a single post from the post API:
POST WITH ATTRIBUTES EXAMPLE DATA
{
"headTitle": "Discounts this spring",
"headDescription": "Sed sem mi, finibus nec faucibus quis, luctus at massa. Etiam tincidunt ipsum eget lobortis egestas. Sed interdum ac purus vel finibus. Class aptent",
"nextText": "Next \u21e2",
"previousText": "\u21e0 Previous",
"post": {
"title": "Discounts this spring",
"content": "<p>Sed sem mi, finibus nec faucibus quis, luctus at massa. Etiam tincidunt ipsum eget lobortis egestas. Sed interdum ac purus vel finibus. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Etiam tempus, nibh vehicula pretium ornare, nisl dui porta nulla, non maximus mi libero sed quam. Curabitur ullamcorper fermentum eleifend. Curabitur varius enim eu quam tincidunt, nec faucibus tellus commodo. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Proin fermentum, augue nec convallis molestie, nibh odio hendrerit ipsum, ac iaculis magna ligula nec magna. Nunc velit felis, pretium quis purus dapibus, rutrum aliquet urna. Integer nec scelerisque turpis, quis viverra nisi. Fusce varius ligula a purus varius, eu tincidunt massa viverra. Donec ac tincidunt lorem, eu placerat ante. Integer eu nisl nisl.</p>\r\n<p>Proin orci tortor, consequat eu nibh at, ultrices efficitur arcu. Donec quis tempus lorem. Donec sed eleifend neque. Aenean luctus, turpis in euismod sagittis, ex nisl faucibus velit, non faucibus dolor magna non lacus. Etiam a leo at justo bibendum pretium vitae non ipsum. Aliquam maximus turpis fringilla, egestas augue a, dignissim sapien. Aenean malesuada turpis sed fermentum vehicula. Nulla mollis convallis bibendum.</p>",
"slug": "discounts-this-spring",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/fly-d-N7XAzGyeICY-unsplash.jpg",
"publishedAt": "February 25th, 2020",
"updatedAt": "October 20th, 2020",
"categories": [{ "title": "Discounts", "slug": "discounts" }],
"author": {
"name": "Dave",
"slug": "dave",
"photo": "https://io.dropinblog.com/img/blogs/34238346/files/authors/0787ea652b3163a86ec59aa5d9c7b2a65c4607aa.jpg"
},
"related_posts": [
{
"title": "Our espresso technique",
"summary": "Etiam et nunc tortor. Nunc a eleifend libero. Morbi placerat semper sagittis. Curabitur vitae risus pharetra, rutrum nisi et, pellentesque metus. Morbi mollis luctus pellentesque. Quisque mollis ullamcorper felis, at tincidunt libero tincidunt sed.",
"slug": "our-espresso-technique",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/louis-hansel-shotsoflouis-Unz1DfQUUuQ-unsplash.jpg",
"publishedAt": "July 5th, 2020",
"updatedAt": "April 6th, 2021"
},
{
"title": "New dark roasts just in!",
"summary": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.\r\nLorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vel ipsum sit amet enim mollis malesuada. Nulla tincidunt sem ac eros consequat pulvinar at quis risus. Aenean ultricies",
"slug": "new-dark-roasts",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/gregory-hayes-MjvOQ__XFgI-unsplash.jpg",
"publishedAt": "August 10th, 2020",
"updatedAt": "October 20th, 2020"
},
{
"title": "Pour over tips & tricks",
"summary": "Aliquam interdum libero nibh, quis gravida orci tincidunt ut. Phasellus placerat leo lorem, eu congue arcu volutpat ut. In at laoreet est, nec facilisis lacus. Cras fermentum vel neque at vestibulum.\r\nAliquam interdum libero nibh, quis gravida orci",
"slug": "pour-over-tips-and-tricks",
"featuredImage": "https://io.dropinblog.com/uploaded/blogs/34238346/files/featured/anastasia-zhenina-Ivji5bb1Vh4-unsplash.jpg",
"publishedAt": "August 22nd, 2020",
"updatedAt": "October 20th, 2020"
}
],
"readtime": "1 minute read"
}
}Updated on: 19/12/2024
Thank you!