How do I add jobs from SmartRecruiters to my job board?

SmartRecruiters’ public Posting API answers in two steps. Its list of a company’s active postings gives each one’s title, location, department, type of employment and experience level, at most 100 to a request, but not the job ad: the description and the apply link come from a second request for that one posting.

So every run reads the list, then fetches the details of up to 100 postings it holds none for. Fetched details are kept from run to run while the posting stays listed, and fetched afresh when its entry in the list changes or, with calls to spare once new postings have theirs, once they are 15 days old, so an edit to the job ad still arrives.

Take a company with 450 open postings. Its first run puts up to 100 of them on your board and leaves 350 waiting, as its log says. Each later run fetches the next 100, so the whole company is in after 5 runs: about 4 hours after the first on the hourly schedule, 4 days on the daily one or 4 weeks on the weekly one. Run now can start the next run sooner, once every 10 minutes at most.

While any posting waits, the run closes nothing, so the jobs already on your board stay up. A run lists at most 10,000 postings: a company with more is only ever read in part, so the rest never arrive and no run closes its jobs.

A posting arrives as one job, made from its list entry and its details together:

Each SmartRecruiters posting carries an experience level: internship, entry level, associate, mid-senior level, director, executive or not applicable. JobClay marks a job entry level by itself when its posting is at entry level or internship, so it turns up when job seekers filter your board for entry level jobs.

The other levels leave the job unmarked. A rule can still mark one, such as a graduate scheme its company files as associate.

Set your board’s country on the Region page and tick Only jobs in your board’s country on the source, and JobClay asks SmartRecruiters for that country’s postings alone: the list is shorter, and so is the wait for details.

The word filters and the rules act after the read, once details are in, so they do not shorten the first runs.

When you add a SmartRecruiters source by hand, or change its company identifier, JobClay reads the company’s list once before saving. An identifier with no postings is refused on the form, with a note to check it, so a typo never becomes a source that quietly brings in nothing.

The identifier is what follows careers.smartrecruiters.com/ in the address of the company’s default career site, as SmartRecruiters’ documentation puts it. The form takes it alone, or that whole address, or one on jobs.smartrecruiters.com.

The same check means a company with no open jobs today cannot be added by hand; add it once it posts again.

The library’s weekly check reads a SmartRecruiters company’s list alone, never the details, so even a big company is counted in one pass.

Press Add beside one and it becomes a daily source, kept to your board’s country when the board has one; its first run starts shortly. Rules you make for it afterwards decide the postings later runs bring, new or changed. For the jobs already in, press Re-apply to existing jobs on the Rules page: it reaches live jobs only, and leaves a job waiting for room or your approval as the run left it.