REST API
JSON over HTTPS. Every endpoint below takes an API key.
| Base URL | https://jobs-api.arihaan.ai/v1 |
| Format | JSON responses, UTF-8 |
| Auth | Bearer API key |
| Spec | OpenAPI 3.1 |
Endpoints#
| Method | Path | What |
|---|---|---|
| GET | /v1/jobs | Search jobs (query parameters) |
| POST | /v1/jobs/search | Search jobs (JSON body) |
| GET / POST | /v1/jobs/count | Count matching jobs |
| GET | /v1/jobs/{id} | One job with its description |
| POST | /v1/jobs/batch | Up to 100 jobs by id |
| GET | /v1/companies | Find companies |
| GET | /v1/companies/{name} | A company profile and its hiring |
| GET | /v1/meta | Filters and data facts (free) |
| GET | /v1/usage | Your usage (free) |
Conventions#
- List filters take several values: repeat the parameter (
?title=Nurse&title=RN). Fixed-value lists may also be comma-separated (?countries=US,CA). - Unknown parameters are an error, not ignored, so a typo never silently matches everything.
- Results are newest first. Page with cursors.