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.
Prefer a guided walkthrough? Open the Developers quickstart (sign-in → Studio → confirmed key → curl). Trust docs: Privacy, Security.
Quick checklist
- Create / sign in to your Catalitium account.
- In Studio → Developer API, register a free key and confirm the email.
- Issue
GET https://catalitium.com/v1/jobs?per_page=5with headerX-API-Key. - Read
items[]plusmeta; watch401/429/404cases below. - Upgrade quotas via Pricing when you graduate past the free tier.
Base URL
https://catalitium.com
Authentication
- Header:
X-API-Key: cat_… - Query-string keys are not accepted (they leak via logs and Referer).
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"
API usage and examples are documented in README.md (section "API Access").