# bluework

bluework is a free hosted jobs API for agents, apps, notebooks, and services.

Canonical endpoints:

- Landing page: https://bluework.dev/
- API base URL: https://api.bluework.dev
- API health: https://api.bluework.dev/health
- OpenAPI: https://api.bluework.dev/openapi.json
- API reference: https://docs.bluework.dev/

Current production dataset:

- Current sources include Greenhouse, Ashby, Lever, Rippling, Frontline AppliTrack, BrassRing, Cornerstone CSOD, HealthcareSource symplr, NEOGOV, and USAJOBS public job boards.
- Public counts are available at GET https://api.bluework.dev/v1/stats.
- Last baked-in snapshot: 311,394 job records; 273,988 active jobs; 37,406 inactive jobs retained; 13,531 orgs; 13,740 job boards; 10 ATS providers.
- Job events include job.created, job.updated, job.closed, and job.reopened.

Common routes:

- GET /v1/jobs/search
- GET /v1/stats
- GET /v1/openapi.json
- POST /v1/jobs/search
- GET /v1/jobs/{job_id}
- GET /v1/jobs/{job_id}/events
- GET /v1/jobs/facets
- GET /v1/orgs/search
- GET /v1/orgs/lookup
- POST /v1/orgs/batch_lookup
- GET /v1/orgs/{org_id}
- GET /v1/orgs/{org_id}/sources
- GET /v1/orgs/{org_id}/jobs
- GET /v1/orgs/{org_id}/events
- GET /v1/sources/search
- GET /v1/sources/{source_id}
- GET /v1/sources/{source_id}/jobs
- GET /v1/sources/{source_id}/events
- GET /v1/events/search
- POST /v1/events/search
- POST /v1/query

Identity and rate limits:

- Anonymous: 2 requests/second refill, 10 request burst.
- Contact header: 10 requests/second refill, 50 request burst. Send X-Bluework-Contact: you@example.com.
- API key: 100 requests/second refill, 500 request burst.
- Higher limits: POST /v1/auth/limits/requests with an API key.