# RawJob API
# https://rawjobbed.com
# Crowdsourced startup job board powered by X/Twitter

> Base URL: https://rawjobbed.com/api/v1
> Authentication: API key via X-API-Key header or Authorization Bearer
> API Key Prefix: rj_live_
> Pricing: Developer ($29/mo, 10K calls) | Agent Pro ($99/mo, 100K calls + webhooks)
> Docs: https://rawjobbed.com/docs
> OpenAPI Spec: https://rawjobbed.com/openapi.json

## Endpoints

### GET /jobs
Search and filter active job listings with pagination.
Parameters: domain, seniority, remote_only, company, q, min_confidence, posted_after, page, per_page
Returns: Paginated list of jobs with role_title, company_name, seniority, domain_tags, remote_status, tweet_url, founder_email

### GET /jobs/:id
Get a single job by UUID with full company enrichment data.
Returns: Job object with nested company data (funding_stage, blurb, headcount_range, notable_investors)

### GET /companies
List companies with active job listings.
Parameters: funding_stage, page, per_page
Returns: Paginated list of companies

### GET /companies/:id
Get company detail with all enrichment data and list of active jobs.

### POST /webhooks (Agent Pro+)
Register a webhook to receive new job notifications.
Body: callback_url, domain_filters, seniority_filters, remote_only
Payloads signed with HMAC-SHA256 via X-RawJob-Signature header.

### DELETE /webhooks/:id (Agent Pro+)
Remove a webhook subscription.

### GET /usage
Check current billing period API usage and quota.
Returns: plan, calls_used, calls_remaining, monthly_quota, period_start