Objects

This section aims at providing examples for the data structures that are used while interacting with De Carrièrebus API. All examples are in JSON.

The top level object is Job.

Top level object

Job

Basic data related to the job such as reference, employment type, title, description, etc.

Parameters

Sample

{
    "reference":"2005020014",
    "employmentType":"\"FULL_TIME\", \"PART_TIME\"",
    "title":"International Key Account Manager",
    "description":"",
    "datePosted":"2020-04-22T17:27:00+02:00",
    "validThrough":"2020-07-22T00:00:00+02:00",
    "urlToApply":"https://careers.abnamro.com/job/Amsterdam-Network-Manager-Clearing-I-%28832M10%29-Noor/641793500/",
    "company":{
        "name":null,
        "logoUrl":null
    },
    "location":{
        "guid":"cfaca49e-60ce-46b5-9bc6-361c1a320c8e",
        "branchName":"Abn Amro",
        "type":null,
        "floor":"",
        "room":"A.20",
        "building":"",
        "street":{
            "houseNumber":"32 hs",
            "name":{
                "longName":"Admiraal de Ruijterweg",
                "shortName":"Adm. de Ruijterweg"
            }
        },
        "postalcode":"1056 GJ",
        "neighborhood":"",
        "city":{
            "longName":"Amsterdam",
            "shortName":"A'dam"
        },
        "state":{
            "longName":"Noord-Holland",
            "shortName":"NH"
        },
        "country":{
            "longName":"Nederland",
            "shortName":"NL"
        },
        "location":{
            "latitude":3.122422,
            "longitude":45.7763875
        },
        "additionalInfo":""
    },
    "locationType":"",
    "salary":{
        "unitText":"YEAR",
        "currency":"EUR",
        "fixedAmount":null,
        "minimumSalary":58709,
        "maximumSalary":83870
    },
    "siteListing":{
        "baitTitle":"Network Manager Clearing",
        "baitText":"<p>Can you manage the relationships with and the performance of our international service providers and counterparties of the ABN AMRO Clearing Bank (AACB)?</p>",
        "image":"https://carrierebus.nl/content/images/carrierebus/job-bg.jpg",
        "tags":null
    },
    "data":{
        "educationLevel":[

        ],
        "workHours":{
            "min":36,
            "max":null
        },
        "workExperience":{
            "min":null,
            "max":10
        },
        "responsibilities":null,
        "qualitifications":null,
        "requirements":null,
        "fringeBenefits":null
    }
}

JobContent

Company

The name and logo of the company.

Parameters

Sample

{
    "name": "De Carrièrebus B.V.",
    "logoUrl": "https://carrierebus.nl/content/images/company-logo.png"
}

Data

Extra data related to the job such as number of working hours, level of education, number of years of work experience, responsibilities, qualifications, job requirements and benefits offered.

Parameters

Sample

{
    "educationLevel":[
        "HBO",
        "WO"
    ],
    "workHours":{
        "min":36,
        "max":null
    },
    "workExperience":{
        "min":null,
        "max":10
    },
    "responsibilities":null,
    "qualifications":null,
    "requirements":null,
    "fringeBenefits":null
}

Naming

The name of the component which contains a longName and/ or shortName.

Parameters

Sample

{
    "longName": "Admiraal de Ruijterweg",
    "shortName": "Adm. de Ruijterweg"
}

Salary

The actual basic salary for the position, as provided by the employer (no estimate). A fixed salary or salary range. With a certain currency.

Parameters

Sample

{
    "unitText":"MONTH",
    "currency":"EUR",
    "fixedAmount":"54.500",
    "minimumSalary":"24.500",
    "maximumSalary":"32.500"
}

SiteListing

The content of a job result in a job listing.

Parameters

Sample

{
    "baitTitle": "A target driven International Key Account Manager",
    "baitText": "The International Key Account Manager (IKAM) is responsible for the turnover and gross margin of existing and new international clients.",
    "image": "https://carrierebus.nl/content/images/carrierebus/job-bg.jpg",
    "tags": "Python, C#"
}

ValueRange

The range of a certain component with a minimum and a maximum value

Parameters

Sample

{
    "min": 32,
    "max": 40
}

Guidelines

Job title guidelines

Best practices:

• This property should be the title of the job only.
• Don't include job codes, addresses, dates, salaries, or company names in the title property.
  • 👎 Not recommended: Apply now for IT job -FRENCH speaker in Amsterdam.
  • 👍 Recommended: Market Specialist, French speaker
• Provide concise, readable titles.
• Don't overuse special characters such as "!" and "*". Abusing special characters might cause your structured data to be considered as Spammy Structured Markup. Numbers and characters such as "/" and "-" are acceptable.
  • 👎 Not recommended: *** WAREHOUSE HIRING NOW!! ON A BUS ROUTE!! ***
  • 👍 Recommended: Shipping and Receiving Warehouse Associate
• Don't use name instead of title. The properties title and name aren't interchangeable.
• If you're a third party job site, don't attempt to modify the job title to follow the guidelines above, as it can make the title unreadable. Instead, provide the title as you received it from the employer.

Job description guidelines

• You must format the description in HTML.
• At minimum, add paragraph breaks using 

  <p>, <h1>, <h2>, <ul>, <ol> and <li>.

• The feature recognizes the following HTML tags: ...
• The feature doesn't accept other character-level tags, such as ...