baba/apiOpenAPI schema

Developer platform

The Israeli press, as an API.

Every story baba News clusters, with the side of the press each newsroom sits on, the outlets that ran it and the ones that did not. JSON over HTTPS, in English or Hebrew.

The baba News API covers 58 Israeli newsrooms publishing in Hebrew, Arabic, Russian, French and English. It differs from a general news API in three ways. It translates the Hebrew rather than returning it, so an English-only consumer can read the Israeli press directly. It clusters the outlets covering one event and returns the left, center and right split of that cluster, so a story arrives with the shape of its coverage attached. And it names the outlets that did not file, which is what makes a one-sided story visible instead of invisible. Plans start at $99 a month for 10,000 requests, with a 14-day trial that needs no card.

curl
curl -s https://news.itsbaba.com/api/v1/stories?lang=en&state=blindspot \
  -H "Authorization: Bearer nk_live_…"

What you can read

ResourceWhat it gives youScope
/v1/storiesClustered events with the outlets that filed, the lean split, and the state: breaking, developing, blindspot.stories
/v1/sourcesThe 58 newsrooms: lean, ownership, funding, type, and measured behaviour like median filing lag.sources
/v1/searchLexical and vector search across the translated archive.search
/v1/briefThe editions of the daily brief, synthesized from the day's coverage.brief
/v1/peoplePeople and organizations named in coverage, with mention counts and aliases.people
/v1/exportBulk history as CSV or JSONL, paginated by date range.export

Plans

Three plans. The differences are how much you may call, how many keys you may hold, and which of the seven scopes your key carries. Every figure is read from the 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.

Talk to us

On any plan. Tell us what you are building and we will write back: whether Starter covers it, what Enterprise would look like for your volume, or whether the data you need exists at all. Enterprise adds webhooks, bulk export and a million requests a month, and is priced per agreement.