Developers
HTTP API reference
Job search and salary data as JSON. Requires an API key — included with API Access or a confirmed free-tier key from Studio.
Base URL
https://catalitium.com
Authentication
- Header (recommended):
X-API-Key: cat_… - Query:
?api_key=cat_…
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /v1/jobs | Search jobs: title, country, page, per_page |
| GET | /v1/jobs/<id> | Single job by ID |
| GET | /v1/salary | Salary snapshot: title, country |
| GET | /api/keys/usage | Usage for the authenticated key |
| DELETE | /api/keys/me | Revoke key (same X-API-Key) |
Quotas
- Free (confirmed): 50 requests/day, 500/month (calendar month).
- API Access: 10,000/month.
Successful responses include X-RateLimit-* headers.
Errors
401invalid_key429quota_exceeded— body may include"window": "daily"or"monthly"404for missing job or no salary data
Example
curl -sS "https://catalitium.com/v1/jobs?per_page=5" \
-H "X-API-Key: cat_your_key_here"
Markdown copy of this document lives in the repo at docs/API.md.