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.
Your jobs will be appear on MWEEKLY.com based on our categories you select.  Your jobs will also appear throughout our Network of Maintenance and Construction Job Sites at no extra charge based on the categories and keywords in your job title.  If your job title matches words in our job site name the job will be included in that site (for example, if your job title is Electrician your job will automatically drop in to our ElectricianJobs.com site.)

---

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: info@mweekly.com

    • 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 and get back to you.
      
      If you have any questions please email info@mweekly.com