Content Lexicon.

API

In one line

Application programming interface: the agreed way one piece of software asks another for something, like a waiter between the diner and the kitchen.

An API is an agreed format that lets one piece of software request something from another and get a predictable answer back. It sets out what can be asked for, how to phrase the request and what the reply will look like, so the systems on either side don’t need to know how the other works inside.

Web APIs became common in the 2000s, when publishers and platforms began opening their content and data to outside developers.

An endpoint is the address a request goes to, such as one for articles and another for authors. Authentication, usually a key or token, controls who can ask and what they can see. Rate limits cap how many requests a system can make in a given time. In a headless CMS, the content API is how content leaves the system: the website, the app and every other channel request it from there.

Why it matters for content

APIs turn content from something fixed to one page into something other systems can use. A website can pull the current product description, an app can show the same help article and a support tool can check a draft against the one maintained version of the guidance. Every channel draws on the same source, so a correction made once reaches all of them.

That only works if the content behind the API is structured. An API passes on whatever it’s given: if a “summary” field sometimes holds a summary and sometimes holds the opening paragraph, every system that requests it inherits the confusion. Field names, required fields and content types become an agreement with other teams, and changing them can break things those teams have built. Content model changes start to need the same care as code changes, with versioning and notice.

Publishing through an API also changes who controls the content. Once it leaves, the publisher no longer controls every place it appears. When the Guardian opened its content API in 2009, developers could store articles for 24 hours at most, and were warned that keeping them longer risked republishing a story withdrawn for legal reasons.

How AI changes the picture

Assistants and agents reach content through APIs. A chatbot that answers from approved guidance, a writing tool that checks drafts against current rules and an agent that updates product records all depend on a controlled way to request and change content. MCP, the Model Context Protocol, now supported by many AI tools, gives models a standard way to discover those connections and decide when to use them.

That raises the stakes on what an API exposes. Draft, expired and approved content need to be distinguishable in the response, or a model will treat them as equally usable. Permissions matter more when the caller is software acting for a person, because an agent with write access can make a lot of changes very quickly. For content teams, “can AI use this?” usually means “is there a structured, governed way for a system to reach it?”

Questions people ask

Do content people need to understand APIs?

They don’t need to build them, but it helps to know what APIs make possible and what they ask of content. Being able to read API documentation well enough to see which fields exist and what they’re called is useful when planning a content model or a migration.

Is an API the same as a website?

No. A website is for people to use directly; an API is for software. Many organisations have both, and in a headless setup the website is one of the API’s clients.

Does having an API make content reusable?

Only if the content behind it is structured, consistent and maintained. An API can deliver a page-sized block of formatted text as easily as clean fields, and the systems receiving it will struggle to do much else with it.

What’s the difference between an API and an integration?

An API is the interface one system offers. An integration is a connection built with it, such as a CMS sending new articles to a newsletter tool. One API can support many integrations.

Learn more

  • Introduction to web APIs – MDN’s beginner’s guide to what APIs are and how they work, including the third-party APIs that let websites bring in maps, video and comments.
  • A few notes on the Guardian Open Platform – Simon Willison’s 2009 notes on the launch of the Guardian’s content API, covering API keys, rate limits, filtering by tag and a 24-hour limit on storing articles.
  • From guidance to infrastructure – Voice, Tone & Style on turning a style guide into something tools can query through an API.

Type a term, or a word from its definition.⌘K opens this from any page.