SDK

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.

Node.js SDK logoNode.js SDKSearch from TypeScript
typescript
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.

01

No runtime dependencies

The client is built on the platform's own fetch, so installing it adds nothing else to your dependency tree.

02

Async iterators

client.search.iter and client.feed.iterJobs are async generators: a for await loop walks every page or cursor.

03

Typed end to end

Options are camelCase and typed; response objects keep the API's snake_case field names so they match the documentation.

04

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. 1

    Install the package

    The client is published on npm as jobo-enterprise.

    bash
    npm install jobo-enterprise
  2. 2

    Create a client

    Pass your API key from the dashboard. Timeouts are in milliseconds.

    typescript
    import { JoboClient } from "jobo-enterprise";
    
    const client = new JoboClient({ apiKey: process.env.JOBO_API_KEY! });
  3. 3

    Search

    Dates accept a Date or an ISO 8601 string.

    typescript
    const results = await client.search.search({
      q: "software engineer",
      location: "San Francisco",
    });
  4. 4

    Stream the feed

    For volume, iterate the feed. The generator follows the cursor for you.

    typescript
    for 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.

Start pulling live jobs into Node.js SDK

One API key covers every integration, and the same job index sits behind all of them.