JobGrid — Normalized Global Jobs API
JobGrid is a single REST API over normalized job postings from public ATS feeds, company career pages, and selected aggregators. WHY DEVELOPERS USE IT - One schema across sources: title, company, location, work style, salary, apply URL, timestamps, and source health metadata where available. - Cursor pagination on /v1/jobs/search for stable pulls while the corpus changes underneath you. -…
JobGrid — Normalized Global Jobs API endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET |
readiness /v1/health |
Aggregated readiness across runtime dependencies (Redis, database, Kafka). `status` is `ok` only when every subsystem reports `ok`; any subsystem in `error` downgrades the… |
| GET |
listCompanies /v1/companies |
Cursor-paginated listing of companies in the JobGrid catalogue. Set `include_total=true` to also receive a total count (slow on a large table; off by default). |
| GET |
listCompanyJobs /v1/companies/{company_id}/jobs |
Cursor-paginated jobs for one company. |
| GET |
health /health |
Public, unauthenticated liveness probe. Returns `{"status": "ok"}` while the process is up. Safe for RapidAPI's review pinger and any external uptime monitor. |
| GET |
getCompany /v1/companies/{company_id} |
Return one company by its JobGrid `company_id` (UUID). Use `/v1/companies/search?q=…` to discover IDs by name. |
| GET |
searchJobs /v1/jobs/search |
Search the live corpus for active jobs. Cursor-paginated; pass `next_cursor` back via the `cursor` query parameter to fetch the next page. The response includes a `degraded` flag… |
| GET |
getJob /v1/jobs/{job_id} |
Return one job by its JobGrid `job_id` (UUID). |
| GET |
previewJobs /v1/jobs/preview |
Public, unauthenticated preview of the `/v1/jobs/search` response shape. Returns three curated, static sample jobs in the same envelope as the paid endpoint so a developer can… |
| GET |
validateJobSearch /v1/jobs/search/dry-run |
Public, unauthenticated query validator. Reuses the `/v1/jobs/search` parameter schema and returns the parsed/sanitized values, or a `422` envelope when any parameter is missing,… |
| GET |
listJobs /v1/jobs |
Cursor-paginated listing of active jobs ordered by recency. Use `/v1/jobs/search` when you need filtering or full-text matching. |
| GET |
getMe /v1/me |
Identity probe for the calling key. Returns the account's id/email, key prefix (never the full key), plan, and the monthly-quota / rate-limit state your key is subject to. Use… |
| GET |
searchCompanies /v1/companies/search |
Search companies by substring `q` against `name` and `domain`. Always returns 200 with `items: []` for an empty result set; never 404. |