WPLift is supported by its audience. When you purchase through links on our site, we may earn an affiliate commission.

What Is The WordPress REST API? REST API For Dummies

Last Updated on December 14th, 2018

Published on May 16th, 2017


Share This Article

If you pay any attention to the WordPress ecosystem, you’ve probably heard about the WordPress REST API. The REST API featured heavily at Matt Mullenweg’s State of the Word 2016 address, and it’s just generally a hot topic in the WordPress community.

And guess what? As of WordPress 4.7, the REST API is officially included in the WordPress core software. It’s here. But unless you’re a developer, the WordPress REST API probably remains a mystery to you.

So what is the WordPress REST API? And how does it apply to you, a regular WordPress user?

Just like my post on WP-CLI – this discussion of the REST API is not targeted towards developers. That ain’t me, and I couldn’t do it justice. Instead, this is the REST API for dummies guide.

If you’ve ever wondered what it is and what functionality it can add to WordPress and/or your site, then keep on reading.

What Is The WordPress REST API? In Language Humans Can Understand

If you ask the official REST API site, you’d get an answer that sounds something like this:
“The WordPress REST API provides an easy-to-use set of HTTP endpoints that let you access your site’s data in simple JSON format”.

Well, that’s not very helpful, is it?

what is the wordpress rest api?So let’s try to break it down in language that a human can understand. To do that, we’ll need to define a few terms.

What is an API?

API stands for application programming interface. Again, not very helpful. But here’s all that really means for our uses…

It allows two pieces of software to interact with each other in an organized fashion. Nowadays, APIs power a huge chunk of the web.

Article Continues Below

For example, if you have a MailChimp email opt-in form on your site, your newsletter plugin probably uses MailChimp’s API to transfer the information from your email opt-in plugin to the actual newsletter list in your MailChimp account.

So that’s all it is – a way for two pieces of software to interact with one another.

What is REST?

REST, short for representational state transfer, is one way to build an API. The actual specifics of how REST works are important for developers but don’t really matter that much as far as us regular users are concerned.

So What is the WordPress REST API?

Alright, let’s put it all together now…

The WordPress REST API is an API built on REST technology that allows your WordPress site to interact with other pieces of software in cool and interesting ways.

For example, you could build a separate web app that’s able to pull posts or user information from your WordPress site over the REST API. Or you could completely replace what you know as the WordPress dashboard.

Basically, your WordPress data and content is no longer constrained. The API lets your WordPress site interact with websites or software written in any programming language.

Think about that for a second…

It’s pretty dang powerful! While you won’t ever work directly with the REST API yourself, you will benefit from it in all types of ways.

Developers will be able to create awesome web apps that are based on WordPress. WordPress will be able to truly go mobile with native apps. All kinds of improvements will be possible!

Article Continues Below

I sound like an evangelist, don’t I?

Ok, I’ll stop with the proselytizing and get into a few concrete examples of how this benefits you, the non-developer.

You Can Get WordPress Themes Written in AngularJS, ReactJS + More

Because the WordPress REST API opens up WordPress to non-PHP languages, developers can start making themes in JavaScript, Ruby on Rails, and more. And that opens up a ton of functionality for you as the end user.

For example, take WordPress REST API-based WordPress themes like Wallace or Scribe. Play around with the demos. Try clicking on some blog posts…

Did you notice? Instant transitions! The theme uses JavaScript to render the interface on the client side, which really isn’t possible with regular WordPress themes.

Nowadays, JavaScript libraries like React JS are one of the most popular ways to build web apps. And now you can benefit from that on WordPress.

Currently, though, the transition is not seamless. For example, Wallace doesn’t support all WordPress functionality yet. As of December 2016, all it supported was regular WordPress posts.

You Can Build Truly Native Mobile Apps

Another thing that the WordPress REST API opens up is the ability for developers to build more feature-rich native mobile apps. Again, you won’t ever be doing this directly, but you will be able to benefit from it.

As far as I know, no one has yet turned this into an easy-to-use package for average WordPress users. But I look forward to seeing where this goes as the REST API gains momentum.

Article Continues Below

Developers Can Completely Redesign the WordPress Backend

Finally, the REST API opens up the door for developers to create 100% custom backends to manage your WordPress site. You can already see this with the Calypso interface at WordPress.com.

Calypso is a “single JavaScript application that relies on the WordPress.com REST API”. You can view some of what that means in the graphic from WordPress.com below:

But this ability is not limited to Automattic. Any developer could do something similar and create a completely new way of interacting with WordPress.

Again, this is still in its infancy, so there aren’t any really cool examples yet beyond Calypso. But the important thing is this:

The door is now open.

Wrapping Things Up

I know developers are still debating about how creating a WordPress app with JavaScript takes significantly more development time than PHP. I don’t want to make it out like everyone loves the REST API and is switching all development to JavaScript.

But like I said, the important thing is that the door is open. Matt Mullenweg and the rest of the team committed to the REST API.

So as WordPress and the REST API continue to advance and mature, we will start seeing these new and interesting uses more and more.

If you want to see how the REST API is shaping WordPress right now, you can check out the aforementioned REST API examples like:

  • Calypso
  • Wallace Theme
  • Scribe Theme

And if you want an even bigger list (though it’s a bit out of date), you can check out this post at WordPress.org.

Now over to you – if you’re a WordPress developer, I’d love if you shared your thoughts on the REST API in the comments. As a non-dev, there’s only so far I can take this before I’m out of my element.

Stay informed on WordPress

Every Friday you’ll receive news, tutorials, reviews, and great deals from the WordPress space.

Invalid email address
Colin Newcomer is a freelance writer and long-time Internet marketer. He specializes in digital marketing, WordPress and B2B writing. He lives a life of danger, riding a scooter through the chaos of Hanoi. You can also follow his travel blog.