Description:
The Summer Jobs Plus Bank is a new search tool designed to help connect job seekers with employers. Summer Jobs Plus allows sites to search job postings using a widget that provides a single window into the myriad job boards, social media platforms, and corporate employment sites that are currently spread across the Internet.
The search widget is powered by a new open Web standard, the JobPosting schema, designed by a voluntary network of job search and technology companies and supported by schema.org—a collaboration among Bing, Google, and Yahoo to make structured data on the Web easier to find.
Interested in adding the widget as a feature on your website? Instructions are found here to learn how to add Summer Jobs Plus widget to your web site.
For employers committed to hiring, "tagging" job listings in the JobPosting schema ensures that those listings will be discoverable through the Summer Jobs Plus Bank.
Read our guide for tagging job posts for the Summer Jobs Plus search.
Service Operations Details
The Summer Jobs Plus API is supported using Service Operations. Service Operations provide users the ability to call other services, perform specific tasks, or retrieve data that is not found in the standard API datasets. To use the Summer Jobs Plus API the Operation name and parameters need to be supplied using the data services format. For summer jobs query and skip parameter are required.
Each request to the DOL API also requires the standard authorization header. View the authorization specification here.
Summer Jobs Signature
getJobsListing(string query, string employmentType, string region, string locality, string zip, int skipCount)
Parameter Encoding
Strings
Each String typed parameter must be surrounded in quotes in order to work correctly. These quotes are then Url encoded and passed to the Service Operation.
' = %27
For example: 'Nurse' Becomes %27Nurse%27
Int
Each integer typed parameter must be entered without quotes in order to work correctly.
Null Parameter
Each parameter that is assigned null should be left blank
For example: ?region=&locality=
Service Operation Examples
The following queries are examples of requests that can be made to the API to call the Summer Jobs API. Each SDK will require different usages of these forms. The Summer Jobs API requires either the query parameter to be filled out or, either the region or locality field to be filed out.
http://api.dol.gov/V1/SummerJobs/getJobsListing?format=%27json%27&query=%27Nurse%27®ion=&locality=&skipCount=1
http://api.dol.gov/V1/SummerJobs/getJobsListing?format=%27xml%27&query=®ion=%27FL%27&locality=&skipCount=99
http://api.dol.gov/V1/SummerJobs/getJobsListing?format=%27xml%27&query=®ion=&locality=%27Tampa%27&skipCount=99
http://api.dol.gov/V1/SummerJobs/getJobsListing?format=%27atom%27&query=%27Nurse%27®ion=%27New York%27&locality=%27New York%27&skipCount=1
Dataset Location
Dataset Sample
Dataset Tables:
List of Service Operations
getJobsListing Operation
- Returns a json, xml, or atom formatted string.
| Parameter Name | Parameter Description | Data Type |
|---|---|---|
| format | The format that the results string will be returned. See below for list | String |
| query | The keywords that will be used to find matching job listings. This is required if region or locality are not provided. | String(Required) |
| region | The state name or abbreviation used to filter jobs listings. This is required if query or locality are not provided. | String |
| locality | The city name used to filter job listings. This is required if query or region are not provided. | String |
| skipCount | The number of records to skip ahead from the first record. Valid range of 1-99. | int (Required) |