Glossary·Concepts

Unified API

Definition

A unified API is a single API that abstracts many similar third-party services behind one schema and one authentication flow, so a developer integrates once instead of once per provider.

Also called: normalized API, aggregated API, single API.

Key points

  • A unified API abstracts many interchangeable providers behind one schema and one auth flow.
  • It is most valuable in fragmented categories like applicant tracking systems, CRMs, or accounting software.
  • The unified layer normalizes data, absorbs per-provider authentication, and maintains connectors as provider APIs drift.
  • It trades provider-specific depth for breadth - ideal when you need many providers, less so for one provider's full depth.

The problem a unified API solves

Some categories of software are fragmented across dozens of interchangeable providers. Applicant tracking systems are a textbook case: a product that needs to integrate with its customers' ATS faces Greenhouse, Lever, Ashby, Workday, iCIMS, and a long tail beyond. Each has its own API, schema, auth, and quirks. Building and maintaining a connector for every one is a permanent tax on the engineering team.

A unified API removes that tax. It sits between the consumer and all those providers, exposes one schema and one auth flow, and translates to each underlying provider behind the scenes. The consumer integrates with the unified API once and gets every provider it covers.

What the unified layer actually does

It has three jobs. It normalizes - mapping each provider's data model onto one common schema, so a candidate or a job looks the same whatever system it came from. It absorbs authentication - running the per-provider OAuth flows so the consumer deals with one set of credentials. And it maintains the connectors - when a provider changes its API, the unified API absorbs the change instead of the consumer's codebase.

That maintenance role is the underrated part. Provider APIs drift constantly. With direct integrations, every drift is your incident. With a unified API, it is the unified API vendor's incident, and that absorbed maintenance is most of what you are paying for.

The trade-off and where JobsPipe sits

A unified API trades depth for breadth. The common schema is, by design, the intersection of what providers share - so provider-specific or unusual fields can be flattened away or harder to reach. If an integration needs the full idiosyncratic depth of one specific provider, a direct integration can fit better. If it needs reasonable coverage across many providers, the unified API wins clearly.

JobsPipe applies the unified-API model to one domain: public job postings. Rather than a connector per ATS and per board, it returns every posting from 30+ sources in one schema, through one endpoint. It is a unified API scoped to jobs data - broad coverage of job sources, one integration.

FAQ

What is the difference between a unified API and an aggregator?+

They overlap. A unified API emphasizes one schema and one auth flow over many providers, and often supports reads and writes. An aggregator emphasizes collecting and combining data from many sources into one index, and is usually read-focused. A jobs-data API like JobsPipe is both - it aggregates postings and exposes them through a unified, normalized API.

What is the downside of a unified API?+

The common schema is the intersection of what providers share, so provider-specific fields can be flattened or omitted, and you depend on the unified API vendor's coverage and uptime. For an integration that needs the full depth of one particular provider, a direct integration can be a better fit. The unified API wins when breadth across providers matters more than maximum depth in one.

Is JobsPipe a unified API?+

Yes, scoped to job-posting data. Instead of integrating an ATS connector and a job board connector each, you integrate JobsPipe once and read postings from 30+ sources - Workday, Greenhouse, Lever, Indeed, and more - in a single normalized schema, through one endpoint and one API key.

JobsPipe is the jobs-data API behind this glossary - 30+ sources, one schema, 5,000 requests/month free.

Get a free API key

Related