Skip to content

About oJobPub.json

oJobPub is our minimalistic data file in JSON (Wikipedia), containing meta infos about your job openings.

It must be placed in a defined path in your web hosting: <yourdomain.tld>/.well-known/ojobpub.json.

oJobPub Format

In the following sample, we see first an employer object containing infos about the company: name, location, industry, (main website) url.

Later we find a list of jobs. There is only one job in the sample but there is currently no limit how many job entries you add.

{
    "version": "1.0",
    "lastUpdated": "2025-09-13T12:00:00Z",
    "employer": {
        "name": "Acme Corp",
        "location": {
            "city": "New York",
            "country": "US"
        },
        "industry": "Software",
        "url": "https://example.com"
    },
    "jobs": [
        {
            "publishedAt": "2025-08-30",
            "category": "Engineering",
            "title": "Software Engineer",
            "referenceId": "SE-2023-001",
            "applyBefore": "2026-12-31",
            "language": "en",
            "description": "Develop and maintain software applications.",
            "jobType": "permanent",
            "workType": "hybrid",
            "experienceLevel": "mid",
            "workLoad": {
                "minPercentage": 80,
                "maxPercentage": 100
            },
            "tags": ["python", "flask", "backend"],
            "locations":
            [
                {
                    "city": "New York",
                    "country": "US"
                },
                {
                    "city": "San Francisco",
                    "country": "US"
                }
            ],
            "salary": {
                "minAmount": 70000,
                "maxAmount": 120000,
                "currency": "USD",
                "period": "yearly"
            },
            "url": "https://example.com/job/1"
        }
    ]
}
  1. The employer json object with minimal information about the employer.
  2. The list of jobs objects with meta information about the job openings.

Note

JSON might look complicated if you're not familiar with it, but don't worry — you won't have to write it by hand. Once this format is finalized, we'll provide tools to help you generate and validate the structure.

Some of the (blue) keys (e.g. workload or description) are optional while others are required (e.g. title).

This is why we provide a oJobPub JSON Schema (also see GitHub) and an online validator tool validator.letsemploy.org to allow verification of the data structure.

Tip

While not all properties are required for a valid file, we highly recommend you fill out as much metadata as possible.