API Endpoint Reference

Base URL: https://rawjobbed.com/api/v1


GET /jobs

Search and filter active job listings with pagination.

Query Parameters:

ParamTypeDescription
domainstringComma-separated domain tags (engineering, ai, design, etc.)
senioritystringComma-separated levels (senior, staff, lead, etc.)
remote_onlybooleanFilter to remote jobs only
companystringText search on company name
qstringSearch across role, company, and post text
min_confidencefloatMinimum classification confidence (0-1)
posted_afterISO datetimeOnly jobs posted after this time
pageintPage number (default: 1)
per_pageintResults per page (max: 50, default: 20)

Example:

curl -H "X-API-Key: rj_live_YOUR_KEY" \
  "https://rawjobbed.com/api/v1/jobs?domain=engineering,ai&seniority=senior&remote_only=true&per_page=10"

GET /jobs/:id

Get a single job by UUID with full company enrichment data.

curl -H "X-API-Key: rj_live_YOUR_KEY" \
  "https://rawjobbed.com/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000"

GET /companies

List companies with active jobs. Includes funding stage, domain, blurb.

ParamTypeDescription
funding_stagestringFilter by stage (e.g., "Series A")
page, per_pageintPagination

GET /companies/:id

Company detail with all enrichment data and list of active jobs.

POST /webhooks(Agent Pro+)

Register a webhook to receive new job notifications via HTTP POST.

curl -X POST -H "X-API-Key: rj_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"callback_url": "https://your-app.com/webhook", "domain_filters": ["ai"], "remote_only": true}' \
  "https://rawjobbed.com/api/v1/webhooks"

DELETE /webhooks/:id

Remove a webhook subscription.

GET /usage

Check current billing period usage.

{
  "plan": "developer",
  "calls_used": 4231,
  "calls_remaining": 5769,
  "monthly_quota": 10000,
  "period_start": "2026-03-01T00:00:00Z"
}