JobsEmployersChanges feed

Job postings, with dates a backtest can trust.

Open postings from employers' careers pages and the job boards they post to, and the employers behind them, as an API and a command-line tool. Every job keeps the date its source gave apart from the day we first saw it, and says when a crawl last listed it.

Request a key

The postings jobwolverine.com and rxraven.com list.

What a script can ask

The questions the feed is built to answer, and the call that answers each.

How many roles is it advertising now?

/jobs/count takes the filters /jobs does: an employer, words in the title, a location, remote or not. It is cheap, so ask it every day and the series is yours.

GET /jobs/count?employer=acme&q=engineer

What opened and closed since yesterday?

The changes feed sends every job added, closed or reopened since a time you name, oldest first, and says where to resume. A change may arrive twice. It is never missed.

GET /jobs/changes?since=1790875380

Could a backtest have seen it?

first_seen_at is when we found a job, always. posted_at is the date its source gave, and null when it gave none, so a test uses only what was visible at the time.

"posted_at": null "first_seen_at": 1790250000

What do the postings say?

detail=full gives each posting's whole text, for a model to read: the roles, the places, the seniority, the tools a team works with.

GET /jobs?employer=acme&detail=full

What a record holds

A job, and the employer behind it. The API reference has every parameter and an example of each.

A job

position, company, location, remote
As the posting gives them.
employer
The slug of the employer's record, or null when the company name has no record of its own.
salary_min, salary_max
Whole US dollars, when the posting states a salary. Most do not, and both are null then.
description
An excerpt, or the whole text with detail=full.
application_url, source_url
Where to apply, and where we read it.
brand
jobwolverine, across every industry, or rxraven, in pharma, biotech and life sciences.
posted_at
The date its source gave, or null.
first_seen_at, last_seen_at
When we found it, and the last crawl that still listed it.
open
False once crawls stop listing it. A closed job stays readable by its id.

An employer

name, domain
Its name, and its website's domain.
open_postings
Its open jobs on each site.
hiring
True when it has open jobs, or our check of its hiring pages found some. False when the check found the pages empty. Null when we cannot tell, which is not the same as not hiring.
aliases
The company names that resolve to it.
facts, history
Every fact we hold, each with its source, the version of our check that read it, and when; and every value each fact has had.

Good to know

How the data behaves, in brief. The front page lists every source we read, and the API reference has the rest.

  • History from the first crawlOpenings are recorded as we see them, so an employer's series starts when our crawl of it did, and every date in it is one we observed.
  • Salaries as postedA posting that states a salary carries it. One that does not has null in both fields, never zero.
  • Posting dates as givenA job carries the date its source gives. Where there is none, the day we first saw it stands in for filters only.
  • Employers by name and domainAn employer record is its name and its domain, ready to join to your own list of companies or tickers.

The other feeds

Federal awards

The contracts and grants federal agencies have awarded any company you name, from USAspending.gov: how many, how much, from which agencies, and when the work ends.

GET/api/v1/awards

BDC books

Every loan a business development company reports each quarter, from its SEC filings, and how every other lender we read marks the same loan.

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

Companies

Every private company the BDCs we read hold, under every name their lenders file it as, with one slug. Any name can be looked up; one we do not hold is searched for on EDGAR.

GET/api/v1/companies/resolve

WARN notices

The layoff and closure notices states publish under the WARN Act, read every day and served in one shape: the employer, the place, how many people and when, linked to the companies lenders hold.

GET/api/v1/warn

Franchise filings

Franchisors' registrations and exemption notices with the states, every Texas filing back to 1985, with their brands, dates and status, linked to the companies lenders hold.

GET/api/v1/franchises

Capital raises

Every private capital raise a company has reported to the SEC on Form D since 2008: how much it offered, how much it sold and to how many investors, linked to the companies lenders hold.

GET/api/v1/raises

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.