Let’s talk
ServicesProjectsAboutResourcesContact Tell Us What You Need

What Is an API? A Plain-English Explanation for Business Owners

An API is how one piece of software asks another for something. What that means in practice, why it matters when you choose tools, and what to ask vendors.

By Astel · Published · 3 min read

You will hear "API" whenever software needs to connect to other software. It stands for application programming interface, which explains nothing. The idea behind it is simple.

An API is a defined way for one program to ask another program to do something or hand over some information.

The restaurant comparison

In a restaurant you do not walk into the kitchen and cook. You read a menu, give your order to a waiter, and the waiter brings back the food.

  • The menu is the list of things you are allowed to ask for.
  • The waiter carries the request and the response.
  • The kitchen does the work, and you never see how.

An API is the menu and the waiter. It lists what another program may request and carries the answers back, without exposing what happens inside.

A real example

When your website shows a map of your location, your site does not contain a map of the world. It asks a mapping service's API for a map of a particular address, and displays what comes back.

Other everyday examples:

  • A booking form checking your calendar for free slots.
  • A checkout sending card details to a payment processor and receiving "approved".
  • A web form creating a contact in your CRM.
  • An accounting package pulling in bank transactions.
  • A weather app fetching the forecast.

Each is one program asking another for something through an API.

The pieces, briefly

You do not need to know the technical detail, but a few terms come up.

TermMeaning
RequestThe question one program asks
ResponseThe answer that comes back
EndpointA specific address for a specific kind of request
API keyA password that identifies who is asking
Rate limitHow many requests you may make in a period
WebhookA message a system sends out when something happens, without being asked
DocumentationThe written menu explaining what the API can do

Webhooks are worth understanding. A normal API call is you asking, "Any new orders?" A webhook is the other system telling you, "A new order just arrived," the moment it happens. Most real-time automation relies on them.

Why it matters to a business owner

It decides what can be connected. If two of your tools both have APIs, they can almost certainly be made to share data. If one has none, you are stuck with manual export and import.

It protects you from lock-in. Software with a good API lets you get your data out and move it elsewhere.

It makes automation possible. Tools like Zapier and Make work by calling APIs on your behalf. Custom automations do the same directly.

It enables custom features. A developer can build something specific to your business on top of the systems you already use.

Questions to ask a software vendor

Before buying any tool that will hold important data:

  1. Do you have an API?
  2. Is it available on the plan I am buying? Some vendors restrict API access to higher tiers.
  3. Is it documented publicly?
  4. What can it do? Read data only, or create and update as well?
  5. Do you support webhooks?
  6. Are there limits or extra charges for API use?

A vendor that answers these readily is usually easier to work with over time.

What an API is not

  • It is not an integration. An API is the capability. An integration is something built using it. "We have an API" means a connection is possible, not that it exists.
  • It is not automatically free. Some APIs charge per request.
  • It is not permanent. Providers change their APIs, and anything built on them may need updating. This is one reason connected systems need maintenance.

Security

API keys are passwords. Treat them that way.

  • Never paste them into emails, chat messages or public documents.
  • Give each integration its own key where possible, with only the access it needs.
  • Revoke keys for tools you no longer use.
  • If a key may have been exposed, replace it right away.

The practical takeaway

You do not need to understand how APIs work internally. You need to know that they are what makes your tools able to talk to each other, and to check for one before committing to any software that will sit at the center of your business. How website integrations work shows what gets built on top.

Need a hand?

Reading is free.
So is asking.

If this guide describes your situation and you would rather not do it alone, tell us what you are dealing with.

WebsitesAutomationAI systemsOngoing support