introduction

What is Freshbatch?

Freshbatch is a CS job alert service that delivers new job postings directly to a webhook endpoint you control. Instead of checking job boards manually, your bot, automation, or application receives a POST request every time a new listing is found.

How delivery works

A publisher worker continuously monitors public job repositories. When new postings are detected, it collects them into a batch and POSTs a JSON payload to every registered endpoint. Each delivery is signed with HMAC-SHA256 so you can verify it came from Freshbatch.

When events fire

Deliveries are triggered by the crawler discovering new jobs — not on a fixed schedule. Volume depends on how active hiring is. During peak recruiting season you may receive multiple batches per day; during slow periods fewer.

What your endpoint needs

  • — A publicly reachable HTTP or HTTPS URL
  • — Returns a 2xx status code within a few seconds of receiving the request
  • — Accepts Content-Type: application/json

During local development, use a tunneling tool like ngrok to expose your local server.

Job types

Freshbatch delivers two job types. You choose which ones to receive in your dashboard settings:

  • Full-time / New Grad (FTE) — entry-level and new grad roles. Payload has is_fte: true.
  • Internships — internship and co-op positions. Payload has is_intern: true.

Ready to set up your endpoint? Start with the Quickstart