baba/apiOpenAPI schema

Plans and limits

What each plan gives you.

Three plans, and the only differences are how much you may call, how many keys you may hold, and which of the seven scopes your key carries. Every figure here is read from the same constant the API enforces.

starter
$99 /month

One product or research project reading stories, sources and search.

  • 10,000 requests a month
  • 60 requests a minute
  • 1 API key
  • Stories and clusters
  • Newsroom profiles
  • Search
  • Daily brief
  • People and entities
  • Webhooks
  • Bulk export
  • No brief recipients
team
$299 /month

A newsroom or analytics team that also needs the brief and people data.

  • 100,000 requests a month
  • 300 requests a minute
  • 5 API keys
  • Stories and clusters
  • Newsroom profiles
  • Search
  • Daily brief
  • People and entities
  • Webhooks
  • Bulk export
  • 10 daily brief recipients
enterprise
Contact us

Push delivery, bulk history and volume, under an agreement.

  • 1,000,000 requests a month
  • 1,000 requests a minute
  • Unlimited API keys
  • Stories and clusters
  • Newsroom profiles
  • Search
  • Daily brief
  • People and entities
  • Webhooks
  • Bulk export
  • 100 daily brief recipients

The 14-day trial gives one key, 10,000 requests and 60 requests a minute, with Team read scopes so you can evaluate the brief and people endpoints. No card. Access stops when the trial ends unless you choose a plan.

The difference, in one sentence each

Starter reads the press: stories, the newsroom register and search, at 10,000 requests a month. Team adds the two derived resources, the daily brief and people, and raises the ceilings to 100,000 a month and 300 a minute with 5 keys instead of 1. Enterprise is the only plan that can be pushed to rather than polled, and the only one that can pull history in bulk.

Choosing between Starter and Team? Ask one question: do you need the brief or people endpoints? If not, the only thing Team buys you is headroom. 10,000 requests a month is about 333 a day, so Starter fits a product polling a few times an hour and not a crawler.

What each scope unlocks

ScopeWhat it lets you doPathsFrom
storiesRead clustered events: which newsrooms filed, the left/centre/right split, the state, and the members of each cluster./v1/stories, /v1/stories/{ckey}starter
sourcesRead the newsroom register: lean, type, ownership, funding, and measured behaviour such as median filing lag./v1/sources, /v1/sources/{key}starter
searchQuery the translated archive, lexical and vector, with the same filters the story list takes./v1/searchstarter
briefRead the editions of the daily brief, the synthesized recap of the day’s coverage./v1/briefteam
peopleRead people and organizations named in coverage, with aliases and mention counts./v1/peopleteam
webhooksReceive signed breaking and Not Everywhere events on your own HTTPS endpoint, instead of polling.push delivery, configured in the consoleenterprise
exportPull bulk history as CSV or JSONL over a date range, paginated against a fixed snapshot./v1/exportenterprise

Every dimension, side by side

DimensionStarterTeamEnterprise
Price$99/month$299/monthContact us
Requests a month10,000100,0001,000,000
Requests a minute603001,000
API keys15Unlimited
Stories and clustersYesYesYes
Newsroom profilesYesYesYes
SearchYesYesYes
Daily briefNoYesYes
People and entitiesNoYesYes
WebhooksNoNoYes
Bulk exportNoNoYes
Daily brief recipientsNo10100
BillingCard, monthlyCard, monthlyAgreement and invoice

How the limits are counted

The monthly quota is a UTC calendar month and resets at the turn of the month, not on your billing date. The rate ceiling is a rolling minute. Both are held by the organization, not by the key, so five Team keys share one allowance rather than getting five of them.

  • Authorized requests count, including ones refused for being over the ceiling.
  • Failed authentication does not count. A wrong key costs you nothing.
  • Every response carries X-RateLimit-Limit and X-RateLimit-Remaining for the current minute. There is no quota header; read your month-to-date total in the console.
  • Over the minute ceiling returns 429 with code rate_limited and a Retry-After. Out of monthly quota returns 429 with code quota_exceeded, which retrying will not clear.

Changing plan

Start in the console. Moving up takes effect immediately and keeps any trial days you have left; the new ceilings apply from that moment. Subscriptions renew monthly until canceled and tax is settled at checkout. Enterprise is an agreement rather than a card, so it starts with a conversation: tell us what you are building.