Jobo for Node.js SDK
Live job data in Node.js and TypeScript.
jobo-enterprise is the official Node.js and TypeScript client for the Jobo API. It has no runtime dependencies and uses the built-in fetch, so it needs Node 18 or later and also runs in Bun and Deno. Search, the bulk feed, expired job IDs, company profiles and geocoding are grouped into sub-clients, and the iterators are async generators that follow pages and cursors for you.
import { JoboClient } from "jobo-enterprise";
const client = new JoboClient({ apiKey: process.env.JOBO_API_KEY! });
const results = await client.search.search({
q: "software engineer",
location: "San Francisco",
sources: "greenhouse,lever",
});What can you do with the Node.js SDK integration?
The official Node.js and TypeScript client: no runtime dependencies, async iterators over search and feed.
No runtime dependencies
The client is built on the platform's own fetch, so installing it adds nothing else to your dependency tree.
Async iterators
client.search.iter and client.feed.iterJobs are async generators: a for await loop walks every page or cursor.
Typed end to end
Options are camelCase and typed; response objects keep the API's snake_case field names so they match the documentation.
Typed errors and retries
429 and 503 are retried with Retry-After. Every other failure throws a JoboError subclass with statusCode, the problem code and the response body.
How do you connect Node.js SDK to Jobo?
One-time setup. After this, the data keeps itself current.
- 1
Install the package
The client is published on npm as jobo-enterprise.
bashnpm install jobo-enterprise - 2
Create a client
Pass your API key from the dashboard. Timeouts are in milliseconds.
typescriptimport { JoboClient } from "jobo-enterprise"; const client = new JoboClient({ apiKey: process.env.JOBO_API_KEY! }); - 3
Search
Dates accept a Date or an ISO 8601 string.
typescriptconst results = await client.search.search({ q: "software engineer", location: "San Francisco", }); - 4
Stream the feed
For volume, iterate the feed. The generator follows the cursor for you.
typescriptfor await (const job of client.feed.iterJobs({ sources: ["greenhouse"], batchSize: 1000 })) { await saveToDatabase(job); }
What goes wrong with Node.js SDK, and how do you fix it?
The things people actually hit when running Jobo in Node.js SDK.
- The API key shows up in the browser bundle
- The client is for server-side code. Call it from a route handler, server action or backend service, and have the browser call that.
- searchJobs is not a function after upgrading
- 4.0.0 moved the flat 1.x methods onto sub-clients, matching Python and .NET: client.search.search(...) and client.feed.getJobs(...).
- A filter the API documents is missing from the client
- The 4.0.0 clients do not cover every parameter. The client library docs list what is not covered; send those requests over plain HTTPS.
How do you get the most out of Node.js SDK?
- Create one client and reuse it rather than constructing one per request.
- Use iterExpiredJobIds on a schedule to drop closed jobs from your copy. It is free.
- Pin the version exactly. 4.0.0 was a breaking release.
Which other Jobo integrations work alongside Node.js SDK?
Start pulling live jobs into Node.js SDK
One API key covers every integration, and the same job index sits behind all of them.













