Recipes
Job Listing Tracker
Track new job listings on a schedule and notify when they appear
Watch a set of careers pages and notify (Slack / email / Discord) when a new role matching your filter goes live. Same pattern works for real-estate, marketplace listings, or any "new item appeared" signal.
Schema
{
"type": "object",
"properties": {
"title": { "type": "string", "description": "Job title" },
"department": { "type": "string" },
"location": { "type": "string", "description": "City or 'Remote'" },
"url": { "type": "string", "description": "Canonical job posting URL" },
"postedAt": { "type": "string", "description": "ISO-8601 timestamp if shown" }
},
"required": ["title", "url"]
}Flow
- On a schedule (cron / GitHub Actions), submit careers-page URLs to
/batch/extract - Receive webhook on completion
- Diff against the last run — emit notifications for new
(url)entries - Filter by title / location keywords before notifying
Implementation sketch
import httpx, json, pathlib
API = "https://openapi.thunderbit.com/openapi/v1"
H = {"Authorization": "Bearer YOUR_API_KEY"}
STATE = pathlib.Path("seen.json")
careers = [
"https://example.com/careers",
"https://example.org/jobs",
]
job = httpx.post(f"{API}/batch/extract",
headers=H,
json={"urls": careers, "schema": SCHEMA}).json()
# Poll or webhook (see Batch Job Lifecycle guide)
seen = set(json.loads(STATE.read_text())) if STATE.exists() else set()
new = []
for r in job["data"]["results"]:
if r["status"] != "SUCCEEDED": continue
for item in r.get("data", []):
if item["url"] not in seen:
new.append(item)
seen.add(item["url"])
STATE.write_text(json.dumps(list(seen)))
notify(new) # your Slack / email / Discord hookTips
- Persist
seenURLs across runs — without it, every run notifies the entire list - Filter aggressively:
if "Engineer" in item["title"] and "Remote" in item["location"] - Run on a 4-6 hour cadence — careers pages don't change minute-to-minute
Related
This recipe is being expanded with a GitHub Actions workflow template — check back soon.