The Humble API

Right now APIs are forming the foundation for the most crucial decisions in business development for the foreseeable future.

Throughout the next 20 years or more, humans will experience the quickest period of growth in business, education, clean energy, and–most importantly–poverty eradication all thanks to high-quality software with APIs. Humanity is facing an app-driven future where more jobs for coders and non-coders alike will be available than people to fill them. Such a shortage of workers is already keenly felt in the software industry today.

In his post, “Don’t underestimate the power of the humble API” from July 2015, Sam Macklin of CA Technologies and the API Academy notes, “In the future, every successful company will be a software company and every successful software company will be an API provider,” a refrain heard among the top technology venture capitalists today such as Marc Andreessen. So why are pieces of code unheard of eight years ago by Fortune 500 CEOs transforming the way we do business?

An animated .gif of futuristic, simple hand and wrist subtle UI interactions.
A look at Google’s Project Soli: who will engineer the next app with the WP API and a Project Soli API? See complete video below.

APIs aren’t new, and nor is “code” or software. What’s different today is the runaway success of open source software and the convergence of technology and media into a single, mobile UI with over 50% global human penetration. Abundance author Peter Diamandis and Steven Kotler say that this mobile development is most important among the “rising bottom billion” and it is these individuals who can experience the greatest amount of poverty-reduction with the introduction of new technology and education through software.

The imminent deluge of app development for the next 10-20 years will soon be provided to a scale of billions. This tipping point is attributed to software, especially those pieces of code that are open source or API fueled. This article discusses the multifold business applications that APIs possess and is required understanding for anyone who wishes to succeed in business now or in the future.

With open source APIs, we can create generic APIs (APIs used by developers to build other APIs) so that the abundance of software and application development kits is vast and wide for engineers and entrepreneurs. Throughout this article and at the end I’ll discuss the WP API project and the way it meets each of aforementioned qualities. Ryan McCue, co-lead on the WP API project, announced on September 20, 2015, the plans to merge the WP API into the core of WordPress, bringing to scale 24% of the Internet.

Today we have a flourishing app economy thanks to the rise in popularity of a number of technologies previously only reserved for the wealthy such as cloud computing, wireless networks, micro-services (something startup giant Gilt has embraced wholeheartedly), global smartphone penetration, wearables, open source software, the impending Internet of Things (shortened to ‘the IoT’) and virtual reality or “VR”, including Facebook’s $2 billion acquisition of Oculus Rift in 2014 and the 2015/2016 impending onslaught of VR apps. This economy is continually bolstered by the introduction of new APIs, leading to newer, more innovative apps every day.

What is an API?

An API, short for application program interface, is a set of routines, protocols or tools used to build new user interfaces (UIs) or connect existing ones with unified data, assets, or functionality. They’re the rules of engagement for software, allowing any business that compiles one to instantly become a “platform” company.

Most well-documented code and software today has an API in one form or another, either internal or external. There are APIs for obvious UI components you might see on WordPress websites every day like Google Maps. There are atom and RSS feeds, designed for simple blog or article syndication. There are Instagram and Twitter APIs for 3rd party apps to pull functionality and data found at the originating source to enhance a new app. There are even APIs for your house or home, particularly with the Internet of Things (IoT). “Traditional” sales software giants like Salesforce are joining in on the frenzy of IoT and API-driven development, releasing their “Dreamforce” cloud IoT service in September 2015.

APIs can be built for just a single part or portion of the target software, too. For example, Instagram opened the doors to its ads API in August in 2015, setting off billions of dollars in future revenue. The release of this API by Instagram was, “one of the most anticipated moments in the evolution of advertising.” APIs can even give birth to entire sub-industries, for example with service startups like Hire Large and Slack’s API.

APIs offer great benefits to businesses since costs for developing new components or just plain revenue and growth are drastically reduced when you can plug directly into existing software and assets or data. As Macklin remarks, “APIs make it possible for a few people with a great idea to offer a credible service worldwide with minimal effort and investment.”

Software is eating the world

APIs today control the future of business development because, in the future, every company will be a software company. We’re already much of the way there; software or API-related companies now make up the majority of companies valued at more than $1 billion, known as “unicorns” in the technology industry.

APIs create compartmentalization and modularization for nearly any type of business model in a way software can execute it. In this way, APIs can be seen by business developers as shortcuts to major growth milestones. While an API-first approach such as Twilio is not for every startup, Macklin correctly asserts that, “the principles of openness, agility and software-based innovation that APIs enable will be vital to business success in the coming years.”

Because of this, a common refrain is being heard: “Software is eating the world.” And it’s not just any software that’s eating the world, it’s API-driven and Javascript code in particular.

Javascript (JS) libraries and frameworks like React (Facebook), Node (Google), Angular (Google), and Backbone form the foundation for alternative and new UIs on mobile, wearable, and Internet of Things (IoT) all with many delightful and innate future UI interactions with our bodies, like Google’s Project Soli whose lead engineer (of many) shared that he was “most excited to released [Project Soli] to the developer community.” (Checkout the video above!) 

The next Uber will be constructed with one of these aforementioned frameworks, and their ubiquity among developers today means the costs to create the next Uber are much lower than even two or four years ago. With the help of APIs, a single app can utilize software written with multiple programming languages thanks to a unified architectural style called REST, discussed below.

The fact that code like Javascript is eating the world of business is a hugely optimistic indicator for the global economy among legendary startup investors like Marc Andreessen. APIs reduce barriers to entry for new software innovation since they so drastically diminish friction to create a vast web of connectivity or functionality instantly. APIs truly allow engineers to never reinvent the wheel. The social and cultural disruption that this kind of compounding development creates is therefore huge.

Today, we truly do live in the cult of the API, and entirely new job sets and ecosystems (including many non-technical roles!) will continue to open up, and, in my opinion, will force unemployment and poverty to plummet to previously inconceivable levels globally.


An explanation of APIs and their central role to the future of entrepreneurship of any kind (not just tech companies) would not be complete if it did not include a discussion of the RESTful methodology.

REST (I didn’t think you had enough acronyms to remember yet) is a software architectural style first launched by Roy Fielding and Salesforce back in 2000. Apps that are RESTful are those whose APIs follow a universal set of architectural requirements so that multiple programming languages can easily plugin to an API in a unified approach. REST addresses:

  1. Performance
  2. Scalability
  3. Simplicity of interfaces
  4. Modifiability
  5. Visibility
  6. Portability
  7. Reliability

If you’re a developer of one computing language and a new piece of software comes along with an API, REST will be there to save the day so that you can build any UI regardless of the originating language of that software.

The beauty of today’s modern Javascript libraries and frameworks combined with the universality of REST and JSON APIs provide the basis for future exponential growth, ultimately giving birth to the next, never-far-off unicorn. Will you be the one to build it?

How APIs generate revenue

APIs can be external services requiring a “key” for use or they can be 100% free and publicly available, not requiring registration with the originating entity. They can also be internal, used for an infinite number of backend, operational possibilities for a software-driven firm.

In some cases, charging developers for access to an API can be a standalone revenue stream for software companies. In some freemium APIs, a threshold model is used where data usage above a certain point requires payment for an app’s continued use of the API, such as Google Maps. Another freemium API technique is to provide a free service that is likely to generate paying customers for a different service from the same provider such as the Facebook Like button API and Facebook’s paid ads services and API.

A more popular monetization model for APIs exists where an enterprise pays a developer (or an enterprise pays another enterprise) for sales via a 3rd party app to an API. An obvious example of this model is Expedia’s $2 billion worth of business thanks to travel bookings in 3rd party apps with their API. Expedia executives have disclosed in the past that 90% of their business is now done through APIs.

Instead of providing “simple” one-off solutions for internal projects such as backend efficiency or cost-cutting, APIs today are constantly charting new revenue territory for businesses. Today’s software is much different, much more collaborative and more intelligent than our wildest dreams from even just 5 years ago.

Foundational software & OSS

REST and JSON APIs enable software engineers to never reinvent the wheel when building new apps, a lesson first taught to me by my good friend and leading computer scientist, Reuben Doetsch. As Reuben first explained to me when we were undergraduates, REST APIs are the purest form from which a developer can build and grow a UI or app’s structure.

Open source software (OSS) projects especially benefit from the power of well-documented APIs, and these same APIs allow for OSS to be created more easily and freely. OSS also forms the basis for a lot of the most successful and widely used foundational software today.

The increased prevalence of APIs today can also be thanked in large part to the increased popularity of open source software (OSS) projects like WordPress. The groundbreaking “generic” nature of the all new WP API is only possible thanks to the previous extensive evolution of it and other OSS projects. Open source principals are even more important as new markets flourish and friction to enter the market by any developer who knows how to code is reduced and made as equitable as possible. Thanks to such incentives, foundational software structures will continue to grow on emerging platforms for the IoT, VR, wearables, and many more.

APIs are one of the major reasons open source software like WordPress succeeds in the long term. When code can be copied and iterated upon freely, conduits for the exchange of functions and assets of software can be more easily created than if it were proprietary.

Apps and APIs are now being developed for cars, kitchens, and even your bedroom and bathroom. The first apps and APIs to show up in these spaces will mark out the foundational software from which future developers will build upon. When software ventures into a completely new area of business development where a specific app ecosystem is not already established, we consider it foundational software. The upcoming Internet of Things (IoT) will be filled with all kinds of foundational software that we cannot even yet imagine, especially in the kitchen, restaurants and other environments where food data and other technology matters.

When we build foundational software that’s open source, we build frameworks and APIs from which other entrepreneurs and engineers in the future can more easily and frictionlessly enter the market. This kind of environment leads to the fast-paced iterating needed for any app to survive in the market today. While it may sound counterintuitive, the more apps that are created and iterated in a single competing space, the better off all software companies become.

The open source growth of popular API-based movements today contrasts strongly with previous SaaS trends which have tended to be much more proprietary, requiring monthly access to a platform to dispense a service (a la Salesforce’s original CRM). By making foundational software for new entrepreneurs open source and not proprietary, we greatly reduce the barriers to entry for new apps and entirely new areas of business development, meaning higher quality products and wider access to all. 

Generic APIs

One of the most exciting aspects about the future of APIs, is that in addition to being the building blocks for many future permutations of apps on emerging technology platforms, some APIs are so efficiently structured that they’re the perfect building blocks for making new APIs. APIs that are used to make other APIs are called generic APIs.

Much of the future Internet of Things (IoT) will be made up of foundational software that we can’t yet picture, and the only way it will succeed in the long term is through mutual growth via open source iteration. The fact that the WP API provides a 100% open source generic API building platform is astronomical.

In my opinion, the WP API happens to be the best generic API ever created in software thanks to the following reasons:

  1. It’s 100% open source with a vibrant maker and tinkerer community.
  2. It’s a generic API with a slew of out-of-the-box options thanks to the WordPress core and plugins.
  3. WordPress can be used for actual API management, too.

As Ryan McCue shared with Josh Pollock earlier this year,

“The infrastructure of the API itself, supports basically anything you can throw at it. If you take away the core endpoints, it is essentially a framework for building APIs, and you can build those however you like.”

If you could build anything with software, what would you build? Will your team of engineers construct the next Uber? Will you use the WP API to accomplish it all?

Merging the WP API into WordPress core in 2015

The WP API is easily the best example of an open source, generic API ready for foundational software creation. The WP API is already proving to be extremely effective in scaling quickly and efficiently for enterprise solutions not possible with WordPress just a few years ago. Agencies with standout work in this area include Human Made, where WP API co-founder Ryan McCue is a Senior WordPress Engineer.

Up until this point, WordPress was the world’s most popular content management system, or CMS, powering over 24% of all websites on the Internet. With the new WP API merging into WordPress Core at the end of 2015, WordPress will become a fully fledged application development framework, able to extend its reach to a much larger market of total apps and websites. This instant scaling of 24% of the web is only possible by merging the WP API into the core of WordPress.

I covered the implications for bringing such a vast quantity of the Internet to scale with robust generic infrastructure like the WP API in June. In that article, I discussed the implications for mobile app development, the difference between JSON and REST, enterprise web and mobile apps, and the WP API’s relationship with future IoT as a foundational applicational development framework.

Per Ryan McCue’s official proposal announcement on Make WordPress Core on September 20, 2015, incorporation of the WP API into core will happen in two stages, the first in 2015 with the release of WordPress 4.4, and the second when WordPress 4.5 is released, likely in 2016. Ryan McCue further shares,

WordPress already has external APIs: XML-RPC, designed for desktop clients; Atom and RSS feeds, designed for post syndication; and the venerable admin-ajax, designed for Ajax requests in the admin and frontend. These APIs all serve different purposes, but often have a great deal of overlap. […]

The REST API builds upon the heritage of these APIs to provide better support today for using these, as well as laying the groundwork for expanded use in the future. […]

Our aim is to eventually replace the XML-RPC API completely, to act as a secondary import/export format, and to replace most (but not all) uses of admin-ajax. The REST API offers an easier to use interface than the existing solutions.

API security

One of the most critical challenges facing those who engineer and develop APIs in the future will be security. Internal API security from outside intruders is one major challenge, in addition to some complex privacy and data sensitivity concerns.

The Kardashian and Jenner app hack from September 2015 exposed the data of millions of people, opening up the door to legal and privacy ramifications of all kinds. Security is one major tenet that the WP API team has followed steadfastly, announcing that they will dedicate special attention to the complexity of the intended endpoints and security of deep APIs in WordPress in a separate stage two, which will be solely focused on endpoint merging per Ryan McCue’s latest update.

Thanks for reading; I’d love to hear your thoughts on the future of APIs and business development in the comments below or via Twitter @laralfield. 💖

At Simmer, we’re building the future of food data, generic food APIs, and the future Internet of Things for food-related businesses in mobile, local, and e-commerce. Check our careers page regularly for open positions and join our growing team of engineers, makers, and tinkerers today.

Picture at top by Annie Spratt 📷

Bringing 25% of the web to scale

The advent of the WP REST API is the most explosive update to happen to agile software development for the web and mobile this decade. It is a project that will instantly scale over 24% 25% of the entire Internet this 2015 and 2016.

EDIT: Check out this fantastic tutorial on how to build your own app with the new WP API and Facebook’s React.js. And, of course, here’s a tutorial for creating a WordPress fueled app with Google’s Angular.js, too!

rachel baker

The WP REST & JSON API founded by Rachel Baker and Ryan McCue transforms WordPress into a fully fledged application development framework. The WP API plugin page reads, “This plugin provides an easy to use REST API, available via HTTP. Grab your site’s data in simple JSON format, including users, posts, taxonomies and more. Retrieving or updating data is as simple as sending a HTTP request.”

With the official release of the WP API in the core version 4.3 this August, web and mobile app creators around the globe can use WordPress (already 24% of the Internet open web) to instantly scale new products. The backward compatibility and inherently agile approach that the WP API affords software engineers will guarantee lower costs and faster iteration paces for all kinds of future projects. In fact recently Founder Ryan McCue even asked readers in a partly satirical post to imagine the year 2020: when “an estimated 15% of all native apps use WordPress purely as a backend.”

ryan mccueJSON is a data format that’s meant to be inherently human-friendly. It provides encoders and decoders for 100s of major programming languages, including some forms of code that couldn’t be used with WordPress in a “native” format previously. The choice of JSON by the WP API team makes it easy for WordPress and any third-party application to send information back and forth to each other in a mutually understandable format, opening the doors wide for alternate front and back end implementations of WordPress.

As a result, WordPress will now be able to scale at rates never previously seen in its over 12 years of existence. Scaling WordPress to meet complex software and technology needs–from enterprise all the way to the SMB level–has never been faster or easier. The modulization that the WordPress ecosystem already provides for plugins, themes, widgets, and the customizer will carry over into the future of the WP API, too. These modules will continue to grow in a variety of ways to fit a wide net of commercial needs.

Thanks to this quickened pace, a wide breadth of new technologists and entrepreneurs will be driven to more affordable and immediate business models, meaning greater strength for the existing B2B WordPress economy as a whole. My estimate is that we will see the biggest points of innovation and hyper growth happen with mobile, local, and alternative e-commerce.

While initially scheduled for release in the core version of WordPress 4.1, the WP API is now optimistically penciled in for version 4.3 around mid-August 2015. Advanced engineers and developers at places like the New York Times have already begun using the new WP API in its plugin format for most of 2014 and 2015 already–be sure to check out Scott Taylor’s 2015 keynote at WordCamp Maine to see how the Times has been using it at the bottom of this post in the resources section.

The WP API’s growing and maturing scope and milestone delays are easily par for the course for a project of this magnitude, and doesn’t affect developers already implementing the API in advanced WordPress cases.

banner-1544x500 (1)

Building an API for 24% of the web

Web developers love acronyms. API is short for Application Program Interface. An API is an agreed upon set of standardized methodologies that explain in developer’s terms how a particular piece of software can be used. These API parameters often define how an application can interact with the wider world online and how other pieces of software can “talk” to the application too.

When we talk about creating developer APIs for a system that already runs 24% of the Internet open web–including sites and apps like Bloomberg, Google Ventures, and the New York Times–and pairs automatically with millions of different permutations of independent commercial plugins, themes, and other future software solutions already, the massive scale of the new API becomes abundantly clear.

WordPress is also home to the #1 e-commerce tool, WooCommerce, just acquired by Automattic earlier this year, on its way to likely monetize any store that wants to set up shop. Considering this trend and the advent of the WP API, it isn’t unlikely that someday we’ll see WordPress running the base for 24% of all mobile apps in the iOS store (for example), too.

So what does this mean for technology startups and small businesses building things with WordPress?

Universality & simplicity

A REST API is a particular architectural approach to putting together the parameters for an application. REST stands for Representational State Transfer. It’s a methodology designed to let programs talk to each other in as simple a way as possible. While JSON provides the actual encoders and decoders, REST is the core methodology and philosophy behind it all. Remember, developers love acronyms.

REST APIs are meant to be inherently flexible, but follow a set of core practices which a recent WPMUdev article covers in more detail. Using JSON and the REST methodology, the WP API transforms WordPress into an application development framework or “base” for an application.
To gain a better understanding of what this vast increase in simplicity and universality means for small businesses and enterprise, Baker reflected recently,

“A good example is Wired Magazine. Wired recently replaced multiple WordPress installs with one install, linked to multiple front-ends via the REST API. His favorite part about this project is that the REST API will allow developers to choose their own way of working with WordPress. No longer will developers have to use a theme in the traditional way. They can use the JSON data any way they want.”

This is great news for developers building apps with Javascript and libraries such as React or Node, developed by Facebook and Google respectively. In fact, as of 2015 many leaders in the web and mobile industries have remarked that Javascript is eating the world of software. Now, to build an application with WordPress, an understanding of its complex PHP and related original code structure isn’t even necessary with the new WP API. You can use JavaScript instead.

“That’s one of the use cases I really like,” Ryan said. “The fact that someone who doesn’t know WordPress that well can go and start creating frontend websites with this… It expands how many people can use and develop for WordPress.”

WordPress at scale: enterprise & B2B

WordPress is inherently wonderful for entrepreneurs. Its open source philosophies and community allow anyone to dive straight in and execute a business plan online almost immediately. This opens up the floodgates where WordPress previously may not have played as major a role especially in e-commerce, mobile, open source, and the greater commercial modulization of WordPress as a whole beyond just plugins & themes.

One of the most obvious impacts of the new flexibility and universality of the WP API will be to enterprise software solutions. For example, if an engineer was deciding on coding languages, libraries, and frameworks for a new large scale or highly secure web or mobile application for millions of users, WordPress would have previously been immediately crossed off the list due to the original core’s rigidity with very specific PHP.

By opening up the doors to exponentially more coding languages, major corporations, hospitals, banks, and other types of very large enterprise projects can be fully executed at a secure scale with WordPress as its application framework. Small business SaaS or related software can also be brought to scale to serve business customers (especially SMBs) with the ability for scale and size that the WP API provides as well.

Businesses like (Automattic, Inc) and Reactor (AppPresser, Inc) who are already empowering small business creators will continue to rise in popularity among SMBs as SaaS. Automattic’s own VIP currently dominates in managed enterprise hosting for these types of very large solutions.

I expect that with the WordPress ecosystem growing to include so many more potential permutations for enterprise apps, that new services and companies like VIP will certainly continue to flourish. Successful enterprise software begets successful software for small businesses.

[bctt tweet="Successful enterprise software begets successful software for small businesses."]

I am extremely confident that this increased rate of sale for B2B products and modules for WordPress will supercharge the flow of dollars towards creators that specifically build tools to empower small business online, providing unprecedented small business growth online as a result. Importantly, this growth is also thanks to the open source qualities and philosophies that WordPress engenders at every level as well.

Contributing to the WP API is easy through Github.
Contributing to the open source WP API project is easy through Github.

A new mobile app framework

The most obvious startup growth to consider with the advent of the WP API are mobile apps.

Mobile applications provide both individual and in-app purchase opportunities to entrepreneurs building e-commerce revenue. For example, a single cookbook app can be created with the WordPress framework and sold for $4.99 each on the iOS App Store. Or a new app structured with the dynamically updated databases can create new in-app purchase opportunities anytime for training videos, individual products, and more.

Reactor/AppPresser is one WordPress company already excitedly at work building automated software for the construction of mobile apps with WordPress, making the process even easier for entrepreneurs new to the area. In a recent article they detailed three excellent reasons why WordPress is your best choice as an entrepreneur to build a mobile app:

  1. Ownership: WordPress and the WP API are open source, meaning you maintain total ownership over everything you add to build your app while building on an ever improving and completely open core
  2. Ease of use: WordPress already has one of the best backend admin panels, easily used to build and edit an app
  3. Control: With the total flexibility of the new WP API and ease of use inherent to WordPress, you can control every detail of your app’s user experience (UX)

“Most apps require some sort of database, and possibly creating a UI for a client. WordPress already does this, so why not modify WordPress instead of re-inventing the wheel?”

With Reactor and similar mobile app software companies for WordPress beginning to take off in the second half of 2015, the WP REST API has already manifested success at a place still very early in its lifecycle.

Psst: Consider building your app with Reactor: they have super affordable monthly pricing for businesses of all types. Want to build recipes into your app as well? Simmer is open source and is the first WordPress recipe plugin with multiple developer APIs for your food data for maximum extensibility and universality.

A “generic” API for building other APIs

WordPress as a framework can even build other APIs, by taking away the core endpoints. That’s exactly what we did at Simmer with our developer APIs for recipe data released recently. Josh Pollock also elaborated on the enormity of the potential APIs that can be built through this system:

This project isn’t just about creating a perfect API that works for tens of millions of sites. It’s really about adding a standard set of tools for anyone to make their own API, as well as a totally functional, but generic API.

The Internet of Things 💗 WordPress

One final, truly exciting potential for the new WP API is its future place in the IoT.

Imagine a kitchen where your favorite recipes are ported to a flexible, futuristic augmented reality (AR) UI near your countertop via Simmer. Your handy artificial intelligence assistant (robot?) lets you know when something’s going to burn or even go stale in your fridge, all through the power that WordPress provides at the root of your kitchen’s applications with its APIs.

How cool is that?

Let me know what you think of this article by sharing how your organization or startup plans to use the WP API. Drop your answers in the comment section below or with me on Twitter @laralfield. 👋

Learning Resources

The learning process for the WP REST API never stops. To get started, check out these resources and keep an eye as many new projects develop.

Photo at dawn by Jasper Boer 📷