Sommaire

1. Description
2. Base URL
3. Endpoints
4. Reference
5. Errors

Description

This is an api to fetch published jobs

Base URL

The base URL for all API requests is:

https://app.marvinrecruiter.com/api/website/jobs

Endpoints

GET /:organizationName

Returns a list of all jobs published for the organization.

Response

Returns a XML object with the following properties:

• job: Job object (can occur multiple times) with the following properties:
  • title: (String) The job title
  • date: (Date, format: YYYY-MM-DDThh:mm:ss+01:00) The publication date
  • uniqueid: (Int) Unique job identifier
  • jobid: (String) Marvin's internal unique identifier for this job instance
  • url: (String) URL to the job description page (not application page). Include origin=Indeed parameter to track clicks from Indeed
  • company: (String) Company name shown in search results
  • sourcename: (String) Parent organization name. Used when multiple locations/subsidiaries share the same parent company—the sourcename remains consistent across these jobs
  • city: (String) Job location city
  • state: (String) Job location state/province/region. Use postal abbreviation for US states (e.g., AZ) or appropriate regional designation for other countries (e.g., FR)
  • country: (String) Job location country
  • lat: (String) Job location latitude
  • lng: (String) Job location longitude
  • professions List of profession
    • profession (String) profession name
  • skills List of skill
    • skill (String) Skill name
  • email: (String) Contact email for this job offer
  • description: (String, HTML format) Job description
  • salary: (String, format: "{amount}(K) {salaryPeriod}") Offered salary. Period can be: per day, per month, per year, net per month, percentage The "K" value only appears when the salary period is "per year"
  • jobtype: (String, format: "{contractDuration}, {contract}") Employment type. Duration: fulltime/parttime. Contract type: permanent contract, fixed-term contract etc.
  • experience: (String, format: "{min},{max}") Required experience level in years
  • remotetype: (Enum: Fully remote, Hybrid remote) Work arrangement type:
    • Fully remote: Employee works entirely remotely/from home.
    • Hybrid remote: Employee splits time between office and remote work on a regular schedule
  • lastactivitydate: (Date, format: YYYY-MM-DDThh:mm:ss+01:00) Timestamp of the most recent system action on this job
  • bluecoders : (Enum: oui, non) If the job is sent to bluecoders Jobs platform
  • bluecoders : (Enum: oui, non) If the job is sent to bluecoders Mobility platform

Example

Request: