Core concepts
Requests and responses
JSON over HTTPS, one record per company, a source on every field.
All endpoints live under https://worthpitching.com/api/v1, accept query parameters or JSON bodies, and return JSON.
Fields we can't fill are null
We never guess. If a company has no public job board, hiring is null. If a source isn't connected, its field is null.
Sources and dates
sources says where each field group came from, and as_of is when the data was fetched. Show them to your users if you display the data.
Why-now tags
why_now lists rule-based signals that actually fired: hiring_sales, hiring_marketing, hiring_eng, hiring_fast, scaling_ads, investing_marketing, tech_change and self_serve. An empty list means nothing fired.