Employer XML Job Feed Instructions

Use these instructions to send us an automated job feed (XML) so we can continuously sync your jobs into our job board.

---

1) What you Provide to Us

Please send:

1. Your job feed URL (publicly accessible HTTPS link)

2. Company name (as it should appear on postings)

3. Primary contact name + email

4. How often your jobs change (daily, weekly, etc.)

5. (Optional) A sample job posting URL from your careers site

Example feed URL:
https://careers.yourcompany.com/jobs-feed.xml

---

2) How Syncing Works (important)

• We automatically import jobs from your feed on a schedule (typically daily; more frequent is available).

• Your feed should always include all currently open jobs.

• When a job is removed from your feed (or marked closed), we will expire/remove it from our site.

• Updates in your feed (title, description, salary, location, etc.) will update automatically on our side.

Best practice: Your feed should reflect your ATS/careers site in real time.

---

3) Feed Access Requirements

Your feed must be:

• HTTPS (preferred)

• Publicly accessible (no login required)

  • If you must restrict access, we can support IP allowlisting (you allow our IPs) or a tokenized URL.

• Reliable and reachable (minimal downtime)

• Not blocked by robots/security rules

---

4) Supported Formats

• XML is accepted (preferred)

• If you already have JSON, ask us—often we can support it.

Encoding: UTF-8 recommended.

---

5) Required Job Fields (minimum)

Each job in your XML must include:

• job_id (unique, stable ID from your ATS)

• title

• company

• description (plain text or HTML)

• apply_url (direct application link)

• city

• state (or region)

• country

• employment_type (Full-time, Part-time, Contract, Temporary, Internship)

• posted_date (ISO format preferred)

• job_url (public job detail page, if different from apply_url)

If any required field is missing, that job may fail import.

---

6) Strongly Recommended Fields (improves visibility)

These fields help rankings, search filters, and candidate quality:

• remote_type (Onsite / Hybrid / Remote)

• department

• category (e.g., Maintenance, HVAC, Facilities, Electrical)

• salary_min

• salary_max

• salary_currency (USD)

• salary_interval (hourly / yearly)

• street_address (optional)

• zip

• benefits (short list)

• experience_level

• required_certifications

• shift (Day/Night/Rotating)

• hours_per_week

• license_requirements (if applicable)

---

7) XML Structure Guidelines

We can map many schemas, but your XML should follow these rules:

• One root element (example: <jobs>)

• Each job is a repeated element (example: <job>)

• Use consistent tag names for every job

• Job IDs must not change after posting (do not reuse IDs)

Dates

• Prefer ISO 8601: 2025-12-19 or 2025-12-19T09:30:00-05:00

Descriptions

• Plain text is fine

• HTML is accepted (we may sanitize unsafe tags)
  
  

  8) Example XML (simple)

  <?xml version="1.0" encoding="UTF-8"?>
  <jobs>
    <job>
      <job_id>12345</job_id>
      <title>Maintenance Technician</title>
      <company>Your Company Name</company>
      <description><![CDATA[
        <p>We are seeking a Maintenance Technician to support facility operations.</p>
        <ul>
          <li>Preventive maintenance</li>
          <li>Troubleshooting</li>
        </ul>
      ]]></description>
      <employment_type>Full-time</employment_type>
      <remote_type>Onsite</remote_type>
      <city>Palm Beach Gardens</city>
      <state>FL</state>
      <country>US</country>
      <posted_date>2025-12-19</posted_date>
      <job_url>https://careers.yourcompany.com/job/12345</job_url>
      <apply_url>https://careers.yourcompany.com/apply/12345</apply_url>
      <salary_min>28</salary_min>
      <salary_max>34</salary_max>
      <salary_currency>USD</salary_currency>
      <salary_interval>hourly</salary_interval>
    </job>
  </jobs>

  9) How to Handle Job Closures

  To close a job correctly, do one of the following:

  • Remove the <job> from the feed once it’s filled, or

  • Include a field like <status>closed</status> (if your feed supports it)

  Do not keep closed jobs in the feed unless clearly marked closed.

  ---

  10) Testing Checklist (please verify before sending)

  • Feed loads in a browser without authentication

  • Contains only open jobs (or clearly marks status)

  • Every job has a unique job_id

  • apply_url works and is not expired

  • Descriptions display correctly (no broken HTML)

  • Locations are consistent (City/State/Country)

  • No duplicate jobs

  ---

  • 11) Sending your Feed to Us

    Email us:

    • Your feed URL

    • Company name

    • Contact person plus email

    • Any notes about formatting, status fields, or salary fields

    • Once received, we will:

      Validate your feed