Why WordPress REST API enables headless usage

Introduction

The WordPress REST API lets you use WordPress as a content source without its usual website design. This means you can build your website or app separately and get content from WordPress easily.

You want to build a mobile app that shows your WordPress content.

You want to create a website with a modern design using React or Vue but keep WordPress as the content manager.

You want to share your WordPress content with other websites or services.

You want to separate the content editing from how the content looks on the site.

You want faster and more flexible website updates without changing WordPress themes.

Syntax

Wordpress

GET /wp-json/wp/v2/posts

// Example: Fetch posts from WordPress REST API endpoint

The REST API uses URLs to get data in JSON format.

You can use HTTP methods like GET, POST, PUT, DELETE to interact with WordPress data.

Examples

Fetches a list of posts from the WordPress site.

Wordpress

GET https://example.com/wp-json/wp/v2/posts

Fetches the page with ID 42.

Wordpress

GET https://example.com/wp-json/wp/v2/pages/42

Creates a new post (requires authentication).

Wordpress

POST https://example.com/wp-json/wp/v2/posts
{
  "title": "New Post",
  "content": "This is the post content."
}

Sample Program

This JavaScript code fetches posts from the WordPress REST API and prints each post's title and content in the console.

Wordpress

fetch('https://example.com/wp-json/wp/v2/posts')
  .then(response => response.json())
  .then(posts => {
    posts.forEach(post => {
      console.log(`Title: ${post.title.rendered}`);
      console.log(`Content: ${post.content.rendered}`);
      console.log('---');
    });
  })
  .catch(error => console.error('Error fetching posts:', error));

Important Notes

The REST API returns data in JSON, which is easy to use in many programming languages.

Using the REST API separates content management from how the content is shown, giving more design freedom.

Authentication is needed for creating or editing content via the API.

Summary

The WordPress REST API lets you get and manage content without using WordPress themes.

This enables building websites or apps with any technology while still using WordPress as the content backend.

It makes WordPress flexible and modern for many types of projects.