JobGrid API
JobGrid API provides real-time, structured job listings aggregated from employer career sites and ATS providers worldwide. Designed for developers, SaaS platforms, and AI systems, JobGrid eliminates the need for scraping by delivering clean, deduplicated, and ready-to-use job data through a simple API. Whether you're building a job board, powering an AI agent, or analyzing hiring trends, JobGrid…
JobGrid API endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET |
list_companies_v1_companies_get /v1/companies |
|
| POST |
register_collector_v1_etl_collectors_post /v1/etl/collectors |
|
| GET |
get_source_economics_v1_etl_source_economics_get /v1/etl/source-economics |
|
| GET |
get_collector_v1_etl_collectors__collector_id__get /v1/etl/collectors/{collector_id} |
|
| POST |
create_blocklist_entry_v1_discovery_prefilter_blocklist_post /v1/discovery/prefilter-blocklist |
|
| GET |
get_me_v1_users_me_get /v1/users/me |
|
| GET |
search_companies_v1_companies_search_get /v1/companies/search |
|
| POST |
batch_import_discovery_v1_discovery_batch_import_post /v1/discovery/batch-import |
|
| GET |
list_collectors_ranked_v1_etl_collectors_ranked_get /v1/etl/collectors/ranked |
List active collectors ranked by health score (healthy first). |
| GET |
list_collectors_v1_etl_collectors_get /v1/etl/collectors |
|
| GET |
list_runs_for_collector_v1_etl_collectors__collector_id__runs_get /v1/etl/collectors/{collector_id}/runs |
|
| GET |
health_v1_health_get /v1/health |
|
| POST |
run_collector_v1_etl_collectors__collector_id__run_post /v1/etl/collectors/{collector_id}/run |
|
| GET |
list_runs_v1_etl_runs_get /v1/etl/runs |
|
| GET |
get_discovery_pipeline_stats_v1_discovery_stats_get /v1/discovery/stats |
|
| POST |
receive_webhook_v1_webhooks__provider__post /v1/webhooks/{provider} |
Accept a raw webhook POST and dispatch a fetch task. The provider signature is verified against the secret stored in ``WEBHOOK_SECRET_{PROVIDER}`` (env var). If no secret is… |
| POST |
receive_webhook_v1_webhooks__provider__post /v1/webhooks/{provider} |
Accept a raw webhook POST and dispatch a fetch task. The provider signature is verified against the secret stored in ``WEBHOOK_SECRET_{PROVIDER}`` (env var). If no secret is… |
| POST |
register_v1_auth_register_post /v1/auth/register |
|
| POST |
login_v1_auth_login_post /v1/auth/login |
|
| POST |
refresh_v1_auth_refresh_post /v1/auth/refresh |
|
| GET |
get_discovery_pipeline_stats_v1_discovery_stats_get /v1/discovery/stats |
|
| GET |
search_jobs_fulltext_v1_jobs_search_fulltext_get /v1/jobs/search/fulltext |
Full-text search with faceted filtering via Typesense (MS-3). When Typesense is slow or unreachable, falls back to the SQL search path. Filters are dropped on the fallback path… |
| GET |
admin_get_user_v1_users__user_id__get /v1/users/{user_id} |
|
| GET |
list_jobs_by_company_v1_companies__company_id__jobs_get /v1/companies/{company_id}/jobs |
|
| GET |
list_blocklist_entries_v1_discovery_prefilter_blocklist_get /v1/discovery/prefilter-blocklist |
|
| PATCH |
admin_update_user_v1_users__user_id__patch /v1/users/{user_id} |
|
| GET |
admin_list_users_v1_users_get /v1/users |
|
| GET |
list_dedup_reviews_v1_etl_dedup_reviews_get /v1/etl/dedup-reviews |
|
| POST |
admin_create_user_v1_users_post /v1/users |
|
| GET |
runs_summary_v1_etl_runs_summary_get /v1/etl/runs/summary |
|
| GET |
list_jobs_v1_jobs_get /v1/jobs |
|
| POST |
batch_import_discovery_v1_discovery_batch_import_post /v1/discovery/batch-import |
|
| PATCH |
update_blocklist_entry_v1_discovery_prefilter_blocklist__entry_id__patch /v1/discovery/prefilter-blocklist/{entry_id} |
|
| PATCH |
patch_me_v1_users_me_patch /v1/users/me |
|
| GET |
search_jobs_v1_jobs_search_get /v1/jobs/search |
|
| POST |
create_blocklist_entry_v1_discovery_prefilter_blocklist_post /v1/discovery/prefilter-blocklist |
|
| GET |
get_job_v1_jobs__job_id__get /v1/jobs/{job_id} |
|
| GET |
list_source_quality_daily_v1_etl_source_quality_get /v1/etl/source-quality |
|
| GET |
get_run_v1_etl_runs__etl_run_id__get /v1/etl/runs/{etl_run_id} |
|
| DELETE |
delete_me_v1_users_me_delete /v1/users/me |
|
| POST |
logout_v1_auth_logout_post /v1/auth/logout |
|
| DELETE |
delete_blocklist_entry_v1_discovery_prefilter_blocklist__entry_id__delete /v1/discovery/prefilter-blocklist/{entry_id} |
|
| POST |
register_collector_v1_etl_collectors_post /v1/etl/collectors |
|
| GET |
list_runs_v1_etl_runs_get /v1/etl/runs |
|
| GET |
list_collectors_v1_etl_collectors_get /v1/etl/collectors |
|
| POST |
submit_dedup_review_decision_v1_etl_dedup_reviews__case_id__decision_post /v1/etl/dedup-reviews/{case_id}/decision |
|
| GET |
get_source_economics_v1_etl_source_economics_get /v1/etl/source-economics |
|
| GET |
list_runs_for_collector_v1_etl_collectors__collector_id__runs_get /v1/etl/collectors/{collector_id}/runs |
|
| GET |
get_me_v1_users_me_get /v1/users/me |
|
| GET |
list_collectors_ranked_v1_etl_collectors_ranked_get /v1/etl/collectors/ranked |
List active collectors ranked by health score (healthy first). |