Cerulean Jobs

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': "The listing's id, as every result carries it, or its URL on a Cerulean site."}, 'locale': {'type': 'string', 'pattern': '^([A-Za-z]{2,3}([-_][A-Za-z0-9]{1,8})*)?$', 'description': "The user's language and region, as a BCP 47 tag: fr-CH for someone writing French in Geneva, say. It sets the language of titles and descriptions, and adds localizedUrl, the listing on that locale's Cerulean site, where the site carries it. It does not filter: country and location do. Cerulean's sites are en: ceruleanjobs.com, English, worldwide; fr-FR: cerulean.fr, French, France; fr-CH: ceruleanjobs.ch, French, Switzerland; de-CH: ceruleanjobs.ch, German, Switzerland; en-CA: ceruleanjobs.ca, English, Canada; fr-CA: ceruleanjobs.ca, French, Canada; de-DE: ceruleanjobs.de, German, Germany; en-GB: ceruleanjobs.co.uk, English, UK; es-ES: cerulean.es, Spanish, Spain; it-IT: ceruleanjobs.it, Italian, Italy. Any other tag takes its language's site, so fr-BE reads as fr-FR and en-US as en; another language reads as en. Defaults to en."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id', 'title', 'text', 'url', 'metadata'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'description': 'The listing on ceruleanjobs.com, where a candidate reads it in full and applies.'}, 'text': {'type': 'string', 'description': 'The whole listing as text: its summary, responsibilities, qualifications, skills, experience, education, pay where stated, benefits and languages.'}, 'title': {'type': 'string'}, 'metadata': {'type': 'object', 'required': ['brand'], 'properties': {'city': {'type': 'string'}, 'brand': {'type': 'object', 'required': ['slug', 'name'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string', 'description': "The brand filter's value for this brand."}}, 'additionalProperties': False}, 'region': {'type': 'string'}, 'country': {'type': 'string'}, 'industry': {'type': 'string'}, 'warnings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'parameter': {'type': 'string'}, 'suggestions': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'languages': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'The languages the role asks for, as ISO 639 codes.'}, 'datePosted': {'type': 'string'}, 'department': {'type': 'string'}, 'compensation': {'type': ['null', 'object'], 'properties': {'max': {'type': ['null', 'number']}, 'min': {'type': ['null', 'number']}, 'text': {'type': 'string'}, 'period': {'type': 'string'}, 'currency': {'type': 'string'}}, 'description': 'The pay the listing states: a range, either end of which may be open, or text. Absent when it states none.', 'additionalProperties': False}, 'indexBuiltAt': {'type': 'string'}, 'localizedUrl': {'type': 'string'}, 'employmentType': {'type': 'string'}, 'seniorityLevel': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The id of the listing to find roles like, as every result carries it, or its URL on a Cerulean site. It is not among its own results.'}, 'limit': {'type': 'integer', 'description': 'How many similar roles to return, up to 20. Defaults to 12.'}, 'locale': {'type': 'string', 'pattern': '^([A-Za-z]{2,3}([-_][A-Za-z0-9]{1,8})*)?$', 'description': "The user's language and region, as a BCP 47 tag: fr-CH for someone writing French in Geneva, say. It sets the language of titles and descriptions, and adds localizedUrl, the listing on that locale's Cerulean site, where the site carries it. It does not filter: country and location do. Cerulean's sites are en: ceruleanjobs.com, English, worldwide; fr-FR: cerulean.fr, French, France; fr-CH: ceruleanjobs.ch, French, Switzerland; de-CH: ceruleanjobs.ch, German, Switzerland; en-CA: ceruleanjobs.ca, English, Canada; fr-CA: ceruleanjobs.ca, French, Canada; de-DE: ceruleanjobs.de, German, Germany; en-GB: ceruleanjobs.co.uk, English, UK; es-ES: cerulean.es, Spanish, Spain; it-IT: ceruleanjobs.it, Italian, Italy. Any other tag takes its language's site, so fr-BE reads as fr-FR and en-US as en; another language reads as en. Defaults to en."}, 'offset': {'type': 'integer', 'description': 'How many to skip, for the next page. Defaults to 0, maximum 10000.'}, 'country': {'type': 'string', 'description': 'Keep only similar roles in this country.'}, 'location': {'type': 'string', 'description': 'Keep only similar roles in this city, region or country.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['similarTo', 'results', 'hasMore', 'offset', 'limit'], 'properties': {'limit': {'type': 'integer'}, 'offset': {'type': 'integer'}, 'hasMore': {'type': 'boolean'}, 'results': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'title', 'url', 'brand'], 'properties': {'id': {'type': 'string', 'description': "The listing's id: what fetch and find_similar_jobs take."}, 'url': {'type': 'string', 'description': 'The listing on ceruleanjobs.com, where a candidate reads it in full and applies.'}, 'city': {'type': 'string'}, 'text': {'type': 'string', 'description': "The listing's summary, up to 300 characters."}, 'brand': {'type': 'object', 'required': ['slug', 'name'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string', 'description': "The brand filter's value for this brand."}}, 'additionalProperties': False}, 'title': {'type': 'string', 'description': 'The job title, in the language of locale where the listing has a translation.'}, 'region': {'type': 'string'}, 'country': {'type': 'string'}, 'industry': {'type': 'string', 'description': 'An industry filter value.'}, 'datePosted': {'type': 'string', 'description': 'When the listing was first seen, RFC 3339.'}, 'department': {'type': 'string', 'description': 'A department filter value.'}, 'localizedUrl': {'type': 'string', 'description': 'The listing on the Cerulean site for locale, when that site carries it.'}, 'employmentType': {'type': 'string', 'description': 'An employment_type filter value.'}, 'seniorityLevel': {'type': 'string', 'description': 'A seniority_level filter value.'}}, 'additionalProperties': False}}, 'warnings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'parameter': {'type': 'string'}, 'suggestions': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'similarTo': {'type': 'object', 'required': ['id', 'title', 'brand'], 'properties': {'id': {'type': 'string'}, 'brand': {'type': 'object', 'required': ['slug', 'name'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string', 'description': "The brand filter's value for this brand."}}, 'additionalProperties': False}, 'title': {'type': 'string'}}, 'additionalProperties': False}, 'indexBuiltAt': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'brand': {'type': 'string', 'description': 'A brand, by name or slug: "Tiffany & Co.", "LV", "louis-vuitton". A name that matches no brand comes back as an unknown_value warning with close spellings.'}, 'limit': {'type': 'integer', 'description': 'How many results to return, up to 20. Defaults to 12; more than 20 is served as 20 with a clamped warning.'}, 'query': {'type': 'string', 'description': 'Keywords, or the request as a plain sentence ("senior client advisor, Cartier, Geneva"). A brand, place, country or employment type it names is applied as that filter, unless the filter is set, and reported in interpreted. Leave it out, or empty, to browse by filters alone.'}, 'locale': {'type': 'string', 'pattern': '^([A-Za-z]{2,3}([-_][A-Za-z0-9]{1,8})*)?$', 'description': "The user's language and region, as a BCP 47 tag: fr-CH for someone writing French in Geneva, say. It sets the language of titles and descriptions, and adds localizedUrl, the listing on that locale's Cerulean site, where the site carries it. It does not filter: country and location do. Cerulean's sites are en: ceruleanjobs.com, English, worldwide; fr-FR: cerulean.fr, French, France; fr-CH: ceruleanjobs.ch, French, Switzerland; de-CH: ceruleanjobs.ch, German, Switzerland; en-CA: ceruleanjobs.ca, English, Canada; fr-CA: ceruleanjobs.ca, French, Canada; de-DE: ceruleanjobs.de, German, Germany; en-GB: ceruleanjobs.co.uk, English, UK; es-ES: cerulean.es, Spanish, Spain; it-IT: ceruleanjobs.it, Italian, Italy. Any other tag takes its language's site, so fr-BE reads as fr-FR and en-US as en; another language reads as en. Defaults to en."}, 'offset': {'type': 'integer', 'description': 'How many results to skip, for the next page. Defaults to 0, maximum 10000.'}, 'country': {'type': 'string', 'description': 'A country, by name or ISO code — "Switzerland", "US", "Deutschland". Narrower than location, and combinable with it.'}, 'industry': {'enum': ['fashion-apparel-leather', 'watches-horology', 'high-jewelry', 'perfumes-cosmetics-beauty', 'eyewear-vision-care', 'wines-spirits-gastronomy', 'luxury-hospitality-travel', 'selective-retailing', 'luxury-real-estate', 'yachting-aviation-mobility', 'pre-owned-vintage-luxury', 'media-art-culture', 'luxury-automotive', 'luxury-furniture-homewares', 'high-end-audio-electronics', 'premium-sporting-equipment', 'photography-optics'], 'type': 'string', 'description': 'Industry.'}, 'location': {'type': 'string', 'description': 'A city, region or country, in any common spelling: "Geneva" or "Genève", "New York" or "NYC", "Lombardy", "UAE".'}, 'department': {'enum': ['retail-operations', 'wholesale-b2b', 'merchandising-buying', 'ecommerce-digital', 'clienteling-crm', 'creative-design', 'research-innovation', 'visual-merchandising-architecture', 'heritage-archives', 'manufacturing-artisanal', 'supply-chain-logistics', 'culinary-food-production', 'food-beverage-service', 'front-office-guest-experience', 'housekeeping-cleaning', 'spa-wellness', 'engineering-facilities', 'real-estate-asset-management', 'corporate-affairs-csr', 'human-resources', 'finance-accounting', 'it-technology', 'medical-clinical', 'legal-compliance', 'executive-management', 'other'], 'type': 'string', 'description': 'Department.'}, 'employment_type': {'enum': ['full-time', 'part-time', 'contract', 'temporary', 'seasonal', 'internship', 'volunteer', 'per-diem', 'other'], 'type': 'string', 'description': 'Employment type.'}, 'seniority_level': {'enum': ['intern', 'entry-level', 'junior', 'mid-level', 'senior', 'lead', 'supervisor', 'manager', 'director', 'executive'], 'type': 'string', 'description': 'Seniority level.'}, 'posted_within_days': {'type': 'integer', 'description': "Only listings posted in the last N days, by when Cerulean first saw them: 1 for today's, 7 for this week's. Up to 365."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['results', 'total', 'hasMore', 'offset', 'limit'], 'properties': {'limit': {'type': 'integer'}, 'total': {'type': 'integer', 'minimum': 0, 'description': 'How many listings match, across every page.'}, 'offset': {'type': 'integer'}, 'hasMore': {'type': 'boolean'}, 'results': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'title', 'url', 'brand'], 'properties': {'id': {'type': 'string', 'description': "The listing's id: what fetch and find_similar_jobs take."}, 'url': {'type': 'string', 'description': 'The listing on ceruleanjobs.com, where a candidate reads it in full and applies.'}, 'city': {'type': 'string'}, 'text': {'type': 'string', 'description': "The listing's summary, up to 300 characters."}, 'brand': {'type': 'object', 'required': ['slug', 'name'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string', 'description': "The brand filter's value for this brand."}}, 'additionalProperties': False}, 'title': {'type': 'string', 'description': 'The job title, in the language of locale where the listing has a translation.'}, 'region': {'type': 'string'}, 'country': {'type': 'string'}, 'industry': {'type': 'string', 'description': 'An industry filter value.'}, 'datePosted': {'type': 'string', 'description': 'When the listing was first seen, RFC 3339.'}, 'department': {'type': 'string', 'description': 'A department filter value.'}, 'localizedUrl': {'type': 'string', 'description': 'The listing on the Cerulean site for locale, when that site carries it.'}, 'employmentType': {'type': 'string', 'description': 'An employment_type filter value.'}, 'seniorityLevel': {'type': 'string', 'description': 'A seniority_level filter value.'}}, 'additionalProperties': False}}, 'warnings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'parameter': {'type': 'string'}, 'suggestions': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'description': 'What was clamped, not recognised or matched nothing — what tells a typo from an empty shelf.'}, 'interpreted': {'type': ['null', 'object'], 'required': ['query'], 'properties': {'brand': {'type': 'string', 'description': "The brand the sentence named, as the brand filter's slug."}, 'query': {'type': 'string', 'description': 'The words left to search as text: empty when the sentence named only filters.'}, 'country': {'type': 'string', 'description': 'A second place the sentence named, a country, applied as the country filter.'}, 'location': {'type': 'string', 'description': 'The place the sentence named, applied as the location filter.'}, 'employmentType': {'type': 'string', 'description': 'The employment type the sentence named, applied as that filter.'}}, 'description': 'How the query was read, when it named filters or carried words every search does.', 'additionalProperties': False}, 'indexBuiltAt': {'type': 'string', 'description': 'When the index was built, RFC 3339: how far results can trail the site.'}}, 'additionalProperties': False}