APICLIPublic sources only

Hiring data that says where it came from.

Job postings and the employers behind them, as an API and a command-line tool. Every fact about an employer names its source and when we saw it, so a script can tell a company changing from our check improving. Built for scripts, trading bots and AI agents.

Request a key

The same data jobwolverine.com and rxraven.com are built on.

What's in it

Two collections of public job postings: jobwolverine's, across every industry, and rxraven's, in pharma, biotech and life sciences. Ask for one by brand, or take both. The federal awards behind any company you name. What business development companies report lending, read from their SEC filings. The private companies they lend to, under every name their lenders file them as. The layoff and closure notices states publish under the WARN Act. The franchisors' filings with the states. And every private capital raise companies report to the SEC. The last three link to those companies.

Jobs and employers

Open postings with their full text and apply links, and when each was posted, first seen, and last seen by a crawl. A record per employer, every fact with its source. A changes feed keeps a copy in sync without pulling everything again.

GET/api/v1/jobs
GET/api/v1/jobs/changes
GET/api/v1/employers

The jobs feed

Federal awards

The contracts and grants federal agencies have awarded a company, from USAspending.gov: how many, how much, from which agencies, and when the work ends. Ask about any company by name, not only ones we list. Loans, PPP among them, are left out.

GET/api/v1/awards

The federal awards feed

BDC books

Every loan a business development company reports each quarter, from its 10-Qs and 10-Ks: cost, par, fair value, spread, maturity. Then how every other lender we read marks the same loan.

GET/api/v1/bdc/books/{ticker}

The BDC books feed

Companies

Every private company those lenders hold, under every name they file it as, joined into one record with one slug. Look up any name: one we do not hold is searched for on EDGAR and its lenders read.

GET/api/v1/companies
POST/api/v1/companies/resolve

The companies feed

WARN notices

The layoff and closure notices states publish under the WARN Act, from 30 states and DC, each read every day: the employer, the place, how many people and when. Linked to the companies above where the names agree.

GET/api/v1/warn
GET/api/v1/warn/changes
GET/api/v1/warn/states

The WARN notices feed

Franchise filings

The registrations and exemption notices franchisors file with the states, every Texas filing back to 1985 and every franchisor Florida lists: the franchisor, its brands, its dates and status. Linked to the companies above where a name agrees, or where we reviewed the link.

GET/api/v1/franchises
GET/api/v1/franchises/states

The franchise filings feed

Capital raises

Every private capital raise an operating company has reported to the SEC on Form D since 2008, read every business day: how much it offered, how much it sold, to how many investors and when. Linked to the companies above where the names agree.

GET/api/v1/raises
GET/api/v1/raises/changes

The capital raises feed

Rules the data keeps

The ones a script depends on without knowing it.

Every datum names its source

A fact carries where it came from, the version of our own check that read it, and when. A better check finding a hiring page is not the employer starting to hire, and the record keeps the two apart.

{"source": "probe", "method": "3", "observed_at": 1790250000}

Two dates, never one

A job keeps the date its source gave apart from the moment we first saw it. When the source gave none, the posting date is null rather than a guess, so a backtest can use only what was visible at the time.

"posted_at": null "first_seen_at": 1790250000

Absent is not zero

null means we could not tell. false or [] means we looked and found nothing. An employer whose hiring is null is not an employer that is not hiring.

"hiring": null // unknown, not "no"

A typo is an error

Unknown parameters are refused, not ignored, so a misspelt filter fails loudly instead of quietly returning everything.

400 invalid_parameter // "postd_since"

For scripts, bots and agents

The customers are programs as often as people. pdatum is a CLI that behaves in a pipe and an HTTP API with a contract short enough to read in one sitting.

  • Every command takes --json. Streams are JSON lines on stdout; progress and errors go to stderr, with a non-zero exit code.
  • The whole contract is one Markdown page, readable at /api/v1/docs without a key, so an agent can learn the API before it has one.
  • Sync instead of re-pulling. The changes feed sends a change twice rather than miss it, and tells you where to resume.
  • Limits are stated. Five requests a second per key, in bursts of up to 60, with Retry-After when you exceed them.

Sources, and how to read them

Where it comes from

  • Job postingsFrom employers' own careers pages and the public job boards they post to. Each job says when a crawl last listed it. In Jobs and employers
  • Employers' websitesChecked to confirm an employer's domain and find the job boards it hires through. The check is versioned, and each fact says which version read it. In Jobs and employers
  • USAspending.govThe federal government's public record of what it awards. Looked up when you ask, kept for a month, and each answer says when it was fetched. In Federal awards
  • SEC EDGARBusiness development companies' 10-Q and 10-K filings and their XBRL. Each book says which filings it was read from, and checks what it read against the totals each lender reports. In BDC books and Companies
  • SEC Form DThe notices companies file when they raise money privately, every one since 2008, from the SEC's quarterly data sets and EDGAR's daily filings. Read every business day. In Capital raises
  • State WARN Act noticesThe layoff and closure notices 30 states and DC publish. Each state is read every day by a reader of our own, and each notice names the state's page it came from. In WARN notices and BDC books
  • Texas Secretary of StateThe exemption notices and registrations franchisors file before selling in Texas, every one back to 1985. Read once a week. In Franchise filings
  • Florida Department of Agriculture and Consumer ServicesThe franchise exemptions franchisors file and renew each year before selling in Florida, with the state's own status for each and when it expires. Read once a week. In Franchise filings

Good to know

  • Null means not givenA salary, posting date or notice date a source leaves out is null, never zero or a guess.
  • History from the day we startOpenings are recorded as we see them, and a notice or a filing, once read, is kept even after its source takes it down.
  • Links are leadsRecords link when their names match whole. A one-word name is flagged for you to confirm.
  • Marks are the lender'sA mark below 80 is the usual sign of a loan in trouble.
  • Coverage you can check/warn/states and /franchises/states list every state and when each was last read.

We read public postings, public pages and public records. We do not partner with the employers we list, and we do not claim to.

Ask for a key

Keys are issued by hand while the API is young. Write to pdatum@pearachute.com and say what you are building and which data you need. A registry of company names and their aliases is being built now; if you want it, say so, because requests decide what is served first.