MSEP Partner Portal JSON Feed Standards General JSON Feed Guidance The MSEP Partner Portal uses an automated importing of JSON feeds. Feeds can only be received via HTTP or HTTPS. The portal is unable to accept delivery as SFTP, FTP or daily emails due to security regulations. JSON feeds, at a minimum, must include the job title, job description, and the full job URL, which must be unique to that specific job post. We also recommend including the city, state, postal code, and country fields. This will allow military spouses to easily target jobs that you provide in their area. The addition of job type, preferred qualifications, education, and salary/hourly fields will further enhance the overall search results for your company. The portal technical team posts all jobs on the MSEP Partner Portal. They are responsible for testing, parsing, importing and ensuring the imports will work successfully on the MSEP Partner Portal. However, the portal contract technical team cannot make any edits to your feed. If you would like to schedule a conference call for clarification on this process, please submit a Contact Us. Prior to the conference call, we prefer that you provide a fully constructed test feed for us to review if one is available. This will allow the technical team to review the feed structure and provide feedback. April 2018
Required for JSON Job Postings Field Description Format Example title description url The title of job being posted. A description of the job overview being posted. The (unique) URL of the job posting on your company s site. Please include the full URL, including schema, domain and path as a minimum. This URL must be unique! No two jobs may have the same URL. Kindergarten Teacher <p>suspendisse mollis scelerisque aliquam. Fusce auctor elit a mauris tempus adipiscing. Aliquam eget mi turpis, vel venenatis mi.</p> http://www.yourcompany. co m/jobs/job-wd401 Highly Recommended for JSON Job Postings address address2 The street address Second line of address 123 Main Street Suite 100 city state postal country The city in which the job will be performed. The state or province The postal code The country Please use the two-letter abbreviation for the state or province. This may be either a USA formatted 5-digit zip code or an international postal code. Valid standards compliant country names or ISO codes in the case of overseas jobs 3166-1 alpha-3 specifications Must be as a three-letter country code. Washington DC 20001 USA http://www.nationsonline.org/oneworld/country_code_list.htm JSON Feed Guidance page 2
jobtype The type of job. You must use MSEP defined values (exactly): Full time Part time Internship Temp Flextime Seasonal Other Full Time, Internship Multiple terms must be separated by a comma and a space. industry The industry that this job is and can be located under through advanced job searching. You must use MSEP defined values (exactly). Architecture and Engineering Building and Grounds Business and Finance Community and Social Science Computer and Mathematical Construction and Extraction Education, Library, and Training Food Preparation and Serving Healthcare Practitioners and Technical Healthcare Support Installation, Maintenance, and Repair Life, Physical, and Social Science Management Office and Administrative Support Personal Care and Service Production Protective Service Sales Transportation Education, Library, and Training Jid Unique identifier your company uses to track this job post internally. compensation Type This field specifies whether the job posting is salaried or paid by the hour. No two jobs may have the same ID. HTML cannot be used in this field. You must enter either Salary or Hourly exactly. WD401 Salary JSON Feed Guidance page 3
education Required level of education for this job posting. You must use MSEP defined values (exactly): High School Associate Degree Bachelors Degree Advanced Degree Bachelors Degree addtlqualifications hourlyrate salary Additional required or preferred qualifications for this job posting. The hourly wage for this job posting. The starting (or minimum) salary range for this job posting. This field may be left blank if it is not applicable. The field may only contain integers and/or a period. It should not contain any other punctuation, such as a dollar sign or comma. You must use MSEP defined values (exactly): $0-$20,000 $20,001-$30,000 $30,001-$40,000 $40,001-$50,000 $50,001-$60,000 $60,001-$70,000 $70,001-$80,000 $80,001-$100,000 $100,001+ At least 5 years of experience as an elementary school teacher. 15.00 $60,001-$70,000 istelework tags The telework option Tags associated with the job posting. You must enter either True or False exactly. Any job with blank istelework field is set to False by default. Multiple terms must be separated by a comma and a space. True Engineering, Nursing, QA JSON Feed Guidance page 4
Node structure needed for the JSON Feed: { "jobs": { "job": [ { "title": "Web Developer", "jid": "WD400", "url": "http://www.example.com/jobs/web-developer-wd400", "industry": "Computer and Mathematical", "jobtype": "Full time", "description": "Suspendisse mollis scelerisque aliquam. Fusce auctor elit a mauris tempus adipiscing. Aliquam eget mi turpis, vel venenatis mi. Cras varius nisi ac urna vulputate non rutrum enim hendrerit. Etiam sodales ullamcorper vehicula. In semper, velit in bibendum pretium, neque mauris varius metus, eu ultricies ligula libero ac purus. Vivamus nibh augue, consequat non hendrerit eget, vulputate id felis. Quisque sodales bibendum sem, at laoreet justo vehicula nec.", "education": "Bachelors Degree", "addtlqualifications": "html /plain text", "compensationtype": "salary", "hourlyrate": "", "salary": "$60,001-$70,000", "address": "6404 Ivy Lane", "address2": "Suite 600", "city": "Greenbelt", "state": "MD", "postal": "20770", "country": "USA", "istelework": "True", "tags": "Test, One, Two" }, { "title": "Web Designer", "jid": "WD401", "url": "http://www.example.com/job/web-designer-wd401", "industry": "Computer and Mathematical", "jobtype": "Full time", "description": "Suspendisse mollis scelerisque aliquam. Fusce auctor elit a mauris tempus adipiscing. Aliquam eget mi turpis, vel venenatis mi. Cras varius nisi ac urna vulputate non rutrum enim hendrerit. Etiam sodales ullamcorper vehicula. In semper, velit in bibendum pretium, neque mauris varius metus, eu ultricies ligula libero ac purus. Vivamus nibh augue, consequat non hendrerit eget, vulputate id felis. Quisque sodales bibendum sem, at laoreet justo vehicula nec.", "education": "Bachelors Degree", "addtlqualifications": "html /plain text", "compensationtype": "hourly", "hourlyrate": "15.00", "salary": "", "address": "6404 Ivy Lane", "address2": "Suite 600", "city": "Greenbelt", "state": "MD", "postal": "20770", "country": "USA", "istelework": "", "tags": "Test1, Test2, Test3" } ] } } JSON Feed Guidance page 5
JSON Feeds with HTML content: Tags allowed by default a, abbr, acronym, address, area, article, aside, b, bdi, big, blockquote, br, button, caption, center, cite, code, col, colgroup, data, datalist, dd, del, details, dfn, dir, div, dl, dt, em, fieldset, figcaption, figure, font, footer, form, h1, h2, h3, h4, h5, h6, header, hr, i, img, input, ins, kbd, keygen, label, legend, li, main, map, mark, menu, menuitem, meter, nav, ol, optgroup, option, output, p, pre, progress, q, rp, rt, ruby, s, samp, section, select, small, span, strike, strong, sub, summary, sup, table, tbody, td, textarea, tfoot, th, thead, time, tr, tt, u, ul, var, wbr Attributes allowed by default abbr, accept, accept-charset, accesskey, action, align, alt, autocomplete, autosave, axis, bgcolor, border, cellpadding, cellspacing, challenge, char, charoff, charset, checked, cite, clear, color, cols, colspan, compact, contenteditable, coords, datetime, dir, disabled, draggable, dropzone, enctype, for, frame, headers, height, high, href, hreflang, hspace, ismap, keytype, label, lang, list, longdesc, low, max, maxlength, media, method, min, multiple, name, nohref, noshade, novalidate, nowrap, open, optimum, pattern, placeholder, prompt, pubdate, radiogroup, readonly, rel, required, rev, reversed, rows, rowspan, rules, scope, selected, shape, size, span, spellcheck, src, start, step, style, summary, tabindex, target, title, type, usemap, valign, value, vspace, width, wrap CSS properties allowed by default background, background-attachment, background-color, background-image, background-position, background-repeat, border, border-bottom, borderbottom-color, border-bottom-style, border-bottom-width, border-collapse, border-color, border-left, border-left-color, border-left-style, border-left-width, border-right, border-right-color, border-right-style, border-right-width, border-spacing, border-style, border-top, border-top-color, border-top-style, bordertop-width, border-width, bottom, caption-side, clear, clip, color, content, counter-increment, counter-reset, cursor, direction, display, empty-cells, float, font, font-family, font-size, font-style, font-variant, font-weight, height, left, letter-spacing, line-height, list-style, list-style-image, list-style-position, liststyle-type, margin, margin-bottom, margin-left, margin-right, margin-top, max-height, max-width, min-height, min-width, opacity, orphans, outline, outline-color, outline-style, outline-width, overflow, padding, padding-bottom, padding-left, padding-right, padding-top, page-break-after, page-breakbefore, page-break-inside, quotes, right, table-layout, text-align, text-decoration, text-indent, text-transform, top, unicode-bidi, vertical-align, visibility, white-space, widows, width, word-spacing, z-index CSS at-rules allowed by default namespace, style URI schemes allowed by default http, https JSON Feed Guidance page 6