JSON Feed Documentation

Version 1.0 - Last updated: July 24, 2025

Introduction

Welcome to the documentation for job integration via JSON feed on Jobzem.com. This guide describes the format and fields required for our system to correctly read and display your job postings on our platform.

The feed must be a valid JSON file, hosted on a public URL on your server, and updated regularly. Our system will read your feed every 24 hours to add new jobs, update existing ones, and remove those no longer present in the file.

File Structure

The JSON file must follow a simple structure. It consists of a root object containing a single key (e.g., "source"). The value of this key must be an array of objects, where each object represents a single job posting.

Field Table (Keys)

Within each job object, the following keys are used to describe the job. Keys marked as "Required" must be present for the job to be validated.

JSON Key	Required	Description
`"title"`	Required	The job title. Ex: "Software Engineer".
`"description"`	Required	The full job description. HTML content should be provided as a string.
`"url"`	Required	The direct URL to the job application page on your site.
`"date_posted"`	Required	The job posting date in YYYY-MM-DD format.
`"date_expires"`	Optional	The job expiration date in YYYY-MM-DD format.
`"reference_number"`	Required	A unique ID for the job in your system. Used to identify and update the job.
`"company_name"`	Required	The hiring company's name.
`"source_name"`	Optional	The source of the job posting, if different from the company name.
`"country_code"`	Required	The country code (ISO 3166-1 alpha-2). Ex: "US".
`"state"`	Conditional	The state abbreviation. Required if `remote_type` is empty.
`"city"`	Conditional	The city where the job is located. Required if `remote_type` is empty.
`"postal_code"`	Optional	The postal code (ZIP code) of the job location.
`"street_address"`	Optional	The physical street address of the job.
`"salary"`	Optional	Salary information. Free format. Ex: "90000" or "Competitive".
`"salary_currency"`	Optional	The currency code for the salary (ISO 4217). Ex: "USD".
`"cpc"`	Optional	Cost Per Click (CPC) for the job. Numeric format. Ex: "0.35".
`"currency_cpc"`	Optional	The currency code for the CPC. Ex: "USD".
`"job_type"`	Optional	The type of contract. Ex: "Full-time", "Part-time", "Contract".
`"category"`	Optional	The job category. Ex: "Information Technology".
`"education_req"`	Optional	Education requirements. Ex: "Bachelor's Degree".
`"experience_req"`	Optional	Experience requirements. Ex: "Minimum 3 years".
`"remote_type"`	Optional	Indicates if the job is remote. Accepted values: "REMOTE", "HYBRID".

Full Example

Below is an example of a valid JSON feed with two jobs:

{
  "source": {
    "job": [
      {
        "title": "Senior Frontend Developer (React)",
        "description": "<p>We are looking for a Frontend Developer with solid experience in React, Redux, and TypeScript.</p><h6>Responsibilities:</h6><ul><li>Develop and maintain user interfaces.</li><li>Collaborate with UX/UI teams.</li></ul>",
        "url": "https://your-site.com/job/frontend-dev-123",
        "date_posted": "2025-07-24",
        "reference_number": "DEV-FRONT-123",
        "company_name": "Tech Solutions Inc.",
        "country_code": "US",
        "state": "NY",
        "city": "New York",
        "salary": "110000",
        "salary_currency": "USD",
        "job_type": "Full-time",
        "category": "Information Technology"
      } 
    ],
    "job": [
      {
        "title": "Digital Marketing Analyst",
        "description": "<p>Responsible for planning and executing digital marketing campaigns.</p>",
        "url": "https://your-site.com/job/mkt-digital-456",
        "date_posted": "2025-07-23",
        "reference_number": "MKT-DIG-456",
        "company_name": "Creative Marketing Co.",
        "country_code": "US",
        "salary_currency": "USD",
        "job_type": "Full-time",
        "category": "Marketing Analyst",
        "remote_type": "REMOTE"
      }
    ]
  }

Next Steps

After creating and hosting your JSON feed on a public URL, please contact our partnership team through the Publish Jobs page, providing the URL of your feed. We will validate it, and if everything is correct, your jobs will start appearing on our site.