# Cerulean Jobs

> Cerulean is the job board for the luxury industry — fashion and leather
> goods, watches and jewellery, beauty and fragrance, wines and spirits,
> hospitality and selective retail. It carries the openings the houses
> themselves are advertising, refreshed several times a day.

**If you are an AI agent, a crawler, or a script, query the Search API instead
of walking these HTML pages.** `GET /api/search` is the endpoint the site's own
search box calls: public, no key, no authentication, no rate limit. It is
answered from an in-memory index in a few milliseconds and returns structured
JSON, so you never have to parse a listing out of a page — and one API request
costs us far less than a crawl of tens of thousands of them.

Listings belong to the houses that are hiring. What the Search API and the
MCP server return may be used for personal, editorial and commercial purposes,
crediting Cerulean and linking each listing to its page on Cerulean. Every
listing links out to the employer's own application system; Cerulean does not
take applications on their behalf.

## Search API

- [Search API documentation](https://ceruleanjobs.com/about/developers/): Every parameter, the response schema, how results are ranked, and the complete set of filter values. Start here.
- [OpenAPI 3.1 definition](https://ceruleanjobs.com/openapi.yaml): The machine-readable contract for `GET /api/search`. Hand this to a client generator rather than transcribing the documentation by hand.
- [Example request](https://ceruleanjobs.com/api/search?query=atelier&location=paris&limit=48): The live JSON for `query=atelier&location=paris&limit=48`.
- MCP server: `https://ceruleanjobs.com/api/mcp`. The same index as a Model Context Protocol server, with three read-only tools — `search`, `fetch` and `find_similar_jobs`. **If you are an agent, connect to this rather than writing a client.** No key and no sign-up, like everything else here. It speaks revision `2026-07-28`, where a tool call is a single POST with nothing to open and nothing to keep alive, and the earlier revisions' `initialize` lifecycle too.

What a client needs to know before reading the reference:

- Every parameter is optional. With none at all the endpoint returns the 12 most recent listings.
- Search and filter with `query`, `slug`, `similar`, `lang`, `site`, `location`, `country`, `brand`, `employment-type`, `seniority-level`, `industry`, `department`. Page with `limit` (12 by default, 48 maximum) and `offset` (10,000 maximum).
- `similar={slug}` switches to similarity mode, ranking by meaning and geography against a given listing rather than by keyword. `slug={slug}` returns that one listing.
- `site={locale}` selects a localised site — `fr-fr`, `fr-ch`, `de-de` and the rest. `lang=` is kept as a deprecated alias.
- `brand`, `location` and `country` take names as people write them — `Tiffany & Co.`, `Genève`, `NYC`, `US` — as well as slugs. Case does not matter, nor whether a space is sent as `+` or `%20`. The four taxonomy filters take the fixed values the reference lists.
- Every URL in a response is absolute, so an agent can follow one without knowing the host, and `slug` is the stable identifier for a listing — it is what `slug=` and `similar=` take.
- The endpoint never returns 4xx. A filter matching nothing gives `total: 0`; an unparseable value falls back to its default or is clamped. Whatever was ignored, clamped or not recognised comes back in a `warnings` array — `unknown_value` for a brand, place or country with no jobs on file, with close spellings in `suggestions` — so a typo is distinguishable from a genuinely empty result and no client needs error handling for one.
- The index is rebuilt roughly every four hours and responses are cached at the edge for an hour, so results can trail the site by up to one cycle.
- The MCP tools are shaped for a model rather than copied from this endpoint: their arguments are `snake_case` (`employment_type`), `query` takes keywords or a plain sentence, `fetch` returns one listing in full, and `locale`, a BCP 47 tag such as `fr-CH`, stands in for `site` and `lang`. A filter value outside its vocabulary is refused, with the valid values named, rather than returning `total: 0` — a model can correct itself from that.
- Please send a `User-Agent` that names your project and gives us a way to reach you, and prefer one large page to many small ones — `limit=48` costs us no more than `limit=1`.

## Job listings

- [Luxury Jobs](https://ceruleanjobs.com/jobs/): Every listing currently accepting applications, most recent first.
- [New Today](https://ceruleanjobs.com/new/): The listings that arrived most recently.
- [Search](https://ceruleanjobs.com/search/): The site's own search page, served by the index described above.
- [Brands](https://ceruleanjobs.com/brands/): Every house on the board, each linking to its own openings.
- [Jobs by Location](https://ceruleanjobs.com/locations/): Openings by city, region and country.
- [Luxury Careers](https://ceruleanjobs.com/careers/): Luxury careers grouped by the house that is hiring.
- [Industries](https://ceruleanjobs.com/industries/): Openings by sector of the luxury industry.
- [Departments](https://ceruleanjobs.com/departments/): Openings by function, from atelier production to clienteling.
- [Job Titles](https://ceruleanjobs.com/job-titles/): Openings grouped by the role itself.
- [Seniority Levels](https://ceruleanjobs.com/seniority-levels/): Openings from intern through executive.
- [Employment Types](https://ceruleanjobs.com/employment-types/): Full-time, contract, internship and the rest.

## About Cerulean

- [Mission](https://ceruleanjobs.com/about/mission/): The strategic purpose that drives everything Cerulean builds.
- [Six Pillars](https://ceruleanjobs.com/about/pillars/): The six founding principles that define every aspect of the Cerulean platform.
- [Founder](https://ceruleanjobs.com/about/founder/): Biography and a personal letter from the founder on the convictions that gave rise to Cerulean.
- [Brand](https://ceruleanjobs.com/about/brand/): The name, the marks, color, type, imagery and voice, with logo files to download.
- [Social Directory](https://ceruleanjobs.com/about/social/): The channels Cerulean posts to.
- [Contact](https://ceruleanjobs.com/about/contact/): How to reach Cerulean.
- [Talent](https://ceruleanjobs.com/about/talent/): Career resources and trust standards for luxury professionals.
- [Find luxury jobs with an AI assistant](https://ceruleanjobs.com/about/assistants/): Find open roles at luxury houses in ChatGPT or Claude.
- [Employers](https://ceruleanjobs.com/about/employers/): How a luxury house comes to be listed on Cerulean, and what it finds there.
- [Partners](https://ceruleanjobs.com/about/partners/): The XML job feeds, search API, and MCP server through which job sites and aggregators take Cerulean’s listings.
- [Press](https://ceruleanjobs.com/about/press/): The boilerplate, the founder’s biography, the logos, and the press contact.
- [Legal](https://ceruleanjobs.com/about/legal/): Terms of Service, Privacy Policy, Cookie Policy, and Accessibility statement.

## Optional

- [Luxury Lexicon](https://ceruleanjobs.com/lexicon/): A reference guide to the vocabulary of the industry — materials, techniques and house terminology.
- [Reference](https://ceruleanjobs.com/reference/): Background on the houses, their history and their craft.
- [Closed Positions](https://ceruleanjobs.com/closed/): Listings that have stopped accepting applications, kept for 90 days for reference.
- [Browse Luxury Careers](https://ceruleanjobs.com/browse/): A hub page linking every way of slicing the board.

## Other Cerulean sites

- [fr-FR](https://cerulean.fr/): https://cerulean.fr/llms.txt
- [fr-CH](https://ceruleanjobs.ch/): https://ceruleanjobs.ch/llms.txt
- [de-CH](https://ceruleanjobs.ch/de/): https://ceruleanjobs.ch/de/llms.txt
- [en-CA](https://ceruleanjobs.ca/): https://ceruleanjobs.ca/llms.txt
- [fr-CA](https://ceruleanjobs.ca/fr/): https://ceruleanjobs.ca/fr/llms.txt
- [de-DE](https://ceruleanjobs.de/): https://ceruleanjobs.de/llms.txt
- [en-GB](https://ceruleanjobs.co.uk/): https://ceruleanjobs.co.uk/llms.txt
- [es-ES](https://cerulean.es/): https://cerulean.es/llms.txt
- [it-IT](https://ceruleanjobs.it/): https://ceruleanjobs.it/llms.txt
- [en-US](https://ceruleancareers.com/): https://ceruleancareers.com/llms.txt