24 Oct What Is an API? The Answer in 300 Words or Less
When the marketing industry first shifted from outbound to inbound marketing, many marketers dropped their old roles of content interrupters for new ones as content creators.
But that shift is still producing aftershocks, and to keep up with your competitors today, you need to understand what APIs are, how they integrate with your content strategy, and the social insight they bring to your website.
Don’t worry — APIs might seem complicated, but by the end of this post, you’ll know how they work and what using them entails.Here’s a brief definition of an API, followed by some key information on how to make one work for your business.
What is an API?
An API, short for automatic programming interface, is a series of rules. To be even clearer, it is an information middleman. APIs allow for an application to extract information from a piece of software and use that information in their own application, or sometimes for data analysis.
In the plainest terms, an API is a blueprint that enables “your stuff” to talk to and work with “their stuff.” Your stuff, in this case, is known as the “API endpoint.”
What is an API endpoint?
An API endpoint is the destination of the API requested by a website owner. If a content management system (CMS) requests access to an API, the CMS serves as the API’s endpoint. It’s important for websites to function well so they can become secure and supportive endpoints for developers looking to share their data.
Why are APIs important?
One of the first questions many marketers ask is: Why do all of these businesses share their data openly, for free?
Normally, the answer is: scale. As software companies grow, the staff within those companies quickly realize they have more ideas than they have time and resources to develop them.
By creating APIs, companies let third-party developers create applications that can improve usage and adoption of the main platform. In that way, a business can build an ecosystem that becomes dependent on the data from their API — a dynamic that often leads to additional revenue opportunities.
How to Use an API
Understanding the value of a particular API is essentially about understanding what information is available through an API and how it can be accessed. To find out what a particular API can do for you, you can do one of two things.
- Ask a web developer to look at an API and discuss it with you.
- Do the research on your own. If you don’t have access or budget to use a web developer, this is an appealing option. But don’t panic — many online services have good API documentation.
Let’s take a quick look at Twitter’s API reference index as an example:
Much of Twitter’s growth has been because of outside developers, and the first Twitter API started as a basic wiki. Since then, it has evolved into a detailed index of APIs that a savvy marketer can use to determine what information might be available to a developer in the form of an API — and how to include this API on your website.
Looking at the screenshot above, you can see there are multiple categories of information available to outside developers. Once you select an API you’re interested in, you can click on it to see what information is available through this API. Check out Twitter’s Tweet Timeline API, below.
In the API documentation above, Twitter’s Tweet Timeline API explains how you can take a brief collection of recent tweets from a specific user’s timeline and display them, in clickable form, on your own website. The API documentation includes tweet volume limitations, the API’s resource URL, as well as what you can and cannot choose to display through this API.
Applying the API to Your Website
If you add the API’s resource URL to the backend of your website, it’ll return the information you called for to the frontend of your website. Here’s what this looks like on the New York Road Runners website, helping them promote the New York City Marathon (with a few custom design modifications):
You can also check out the HubSpot API documention to see how you can build applications and integrations using data from HubSpot.
One last caveat: In order to officially use a developer’s API, you might also need to be assigned an API key.
What is an automatic programming interface (API) key?
An API key is the unique identifier assigned to an API user, indicating they’re allowed to use the automatic programming interface on their website. Many developers require you to request this key before using the API, while others may assign it to you upon your first API request.
Think of your API key as your authentication token, declaring you a member of a developer’s community. In effect, this token identifies what you’re using the API for, and verifies that you’ve been given permission to carry out this project by the API’s owner.
Rest assured, your API key does not give the developer access to personal information about you.
APIs As a Marketing Platform
Marketing in an inbound world is about companies developing useful applications and services to sustain customer retention. Brands will need to move away from intermittently dropping in advertisements to become conduits of consumer communications.
In that process, APIs facilitate the data needed to provide solutions to customer problems.
Understanding what information is available through an API will help your determine if it is worth working with a developer to pursue the project further. Here are two examples:
If you wanted to show tweets on your website that included mentions on Twitter to articles from your blog, you’d need to understand if you could request tweets with only specific URLs from the Twitter API.
YouTube Video Embedding
When you right-click a YouTube video on youtube.com, and select “Copy Embed Code,” you’re essentially requesting to use YouTube’s API on your website. YouTube makes it easy for the public to embed YouTube videos to play directly on other websites.
API Terms of Service
No matter the project, it’s critical that you actually read and understand the terms of service for an API you’re considering for your website. Most APIs have certain usage restrictions. If you don’t take the time to understand the restrictions of an API you’re interested in, you could invest more time and money in developing a marketing asset that’s rendered useless once the API provider determines you’ve violated the API’s terms of service (and revokes your access).
For this reason, most APIs have “call limits.”
What is an API call?
An API call, also known as an API request, is an instance of a website owner “calling” for the use of a developer’s API. Saving the API, logins to the developer’s website, and queries about the application all count as API calls.
Developing on the APIs of existing web services is only the beginning. We live in a world that now expects open and available content for all — the natural progression of this is for publishers themselves to release their own APIs, so that their customers can develop applications as a result.
API sharing applies to all businesses — not just those that are web-based, but rather anyone who has a web-based tool or component of their organization. Obviously, this concept could cause hurdles for some organizations, especially from the legal department. It’s up to you to find out which APIs are most valuable and how you can lawfully and sustainably use them.