baba/apiOpenAPI schema

Documentation

View .md

Scopes and plans

A key carries scopes. A scope is a group of endpoints, and your plan decides which scopes a key may carry. Asking for an endpoint outside your scopes is a 403 forbidden, never an empty result.

The scopes

ScopeUnlocks
storiesClustered coverage, story detail, members, threads, trending, blindspots, topics and the change feed.
sourcesThe newsroom register, one newsroom's profile, and its measured filing behaviour.
searchHeadline and entity search across the window.
briefToday in Brief, in English and Hebrew.
peoplePeople named in the last 24 hours, and one person's coverage.
webhooksPush delivery of breaking and blindspot events.
exportBulk historical export as JSONL or CSV.

What each plan carries

StarterTeamEnterprise
Price$99 per month$299 per monthContact us
Requests10,000 per month100,000 per month1,000,000 per month
Rate60 per minute300 per minute1,000 per minute
Keys15As many as you need
Scopesstories, sources, search+ brief, people+ webhooks, export

Every organization starts on a 14 day trial with Starter's limits. Enterprise is an agreement rather than a card: tell us what you are building and we will price it.

A scope you do not have

403 Forbidden
{"error":{"code":"forbidden","message":"This key cannot access this endpoint."}}

Two different situations produce a 403. forbidden means the plan or the key lacks the scope. suspended means the account itself is stopped: a trial that ended, a lapsed subscription, or a suspension. The first is fixed by changing plan, the second in the console.