1. Three-Endpoint Job Board Sync Architecture (Seed + Incremental + Closure)
A high-ranking job board requires fresh direct-employer listings and zero dead links. You can automate the entire lifecycle with three endpoints:
| Step | Endpoint | Schedule | Purpose |
|---|---|---|---|
| 1. Initial Category Backfill | GET /v1/jobs/search?q=...&limit=100 | One-time on launch | Populate initial niche/industry inventory |
| 2. Hourly New & Updated Sync | GET /v1/feeds/new?since=1h & /v1/feeds/updated?since=1h | Every 1 hour | Ingest newly opened roles & salary updates |
| 3. Expired Job Cleanup | GET /v1/feeds/closed?since=1h | Every 1 hour | Unpublish filled/closed jobs so candidates never hit 404s |
2. Hourly New & Closed Job Synchronization Script
Poll /v1/feeds/new and /v1/feeds/closed from a cron job or serverless worker:
Hourly Job Board Feed Sync
Ingest new remote engineering roles and purge closed job IDs:
curl "https://api.jobpostingsapi.com/v1/feeds/new?since=1h&country=US&limit=50" \
-H "x-api-key: jp_live_your_api_key"Interactive Engineering Workbench · GET /v1/feeds/new
Verify real-time latency, pagination math & JSON schema
Frequently Asked Questions
- Can I add Google JobPosting JSON-LD structured data to jobs from /v1/jobs/search?
- Yes, for all default search results (redistribution_allowed=true). Each record provides the exact title, description_html, posted_at, employment_type, company.name, company.domain, location, and salary fields required by Google Jobs schema.org markup.