Developer API
Building on Cerulean
Cerulean’s API provides programmatic access to the platform’s job data, enabling engineering teams to build custom integrations, automate posting workflows, subscribe to real-time event streams via webhooks, and consume structured luxury job data in their own applications.
Authentication
All API requests require authentication via Bearer Token. Tokens are issued upon completion of a partner agreement and are scoped to the specific capabilities authorised for your integration.
Authorization: Bearer {YOUR_API_TOKEN}
Tokens are environment-scoped (sandbox/production). Do not use production tokens in development environments.
Base URL
https://api.ceruleanjobs.com/v1/
All endpoints are HTTPS-only. HTTP requests are rejected.
Core Endpoints
Jobs
GET /jobs Returns a paginated list of active job listings. Supports filtering by brand, location, employment type, seniority level, and date range.
GET /jobs/{id} Returns a single job listing by its Cerulean identifier.
POST /jobs
Creates a new job listing. Requires employer scope. Accepts JSON body matching the job schema.
PUT /jobs/{id}
Updates a job listing. Replaces specified fields. Requires employer scope.
DELETE /jobs/{id}
Closes a job listing and removes it from the active directory. Requires employer scope.
Employers
GET /employers/{slug} Returns public information for a specific employer brand on the platform.
Applications
GET /jobs/{id}/applications
Returns applications received for a specific listing. Requires employer scope and ownership of the listing.
Webhooks
Cerulean supports webhook delivery for the following event types:
| Event | Trigger |
|---|---|
job.created | New listing published |
job.closed | Listing closed or expired |
application.received | New application submitted |
application.status_changed | Application status updated |
Webhook payloads are signed with an X-Cerulean-Signature header using HMAC-SHA256. Cerulean retries failed deliveries up to five times with exponential backoff.
Rate Limits
| Plan | Requests / Minute |
|---|---|
| Standard Partner | 60 |
| Integration Partner | 300 |
| Enterprise | Custom |
Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
Sandbox Environment
A full sandbox environment is available at https://sandbox-api.ceruleanjobs.com/v1/ for development and testing. Sandbox data is refreshed weekly and does not affect production.
Access
API access is available to approved partners. To request access, write to luxury@ceruleanjobs.com with the subject line “Developer API.”