JobGrid — Normalized Global Jobs API
JobGrid delivers clean, normalized, and production-ready job data through a single global jobs API built for developers, recruiters, analytics platforms, AI agents, and job marketplaces. Behind the API, JobGrid continuously collects jobs from company career pages, ATS platforms, and public job sources, then runs a multi-stage normalization and quality pipeline to ensure the public feed contains…
JobGrid — Normalized Global Jobs API endpoints
| Method | Endpoint | Description |
|---|---|---|
| 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 |
getJob /v1/jobs/{job_id} |
Return one job by its JobGrid `job_id` (UUID). |
| 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 |
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 |
listJobs /v1/jobs |
Cursor-paginated listing of active jobs ordered by recency. Use `/v1/jobs/search` when you need filtering or full-text matching. The response never includes an exact total —… |
| GET |
jobsFacets /v1/jobs/facets |
Aggregated filter options for the active-jobs feed (locations, companies, work styles, employment types, seniorities, posted-range buckets, and a salary range hint). Computed… |
| 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 |
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. |
| 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. The response never includes an exact total — iterate via `next_cursor` / `has_more`. Passing `include_total=true` returns `422… |
| 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 |
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 |
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,… |