Skip to Content

List Jobs

GET
/v1/jobsearch/{userId}/{keyword}/{location}/{radius}/{sortColumns}/{sortOrder}/{startRecord}/{pageSize}/{days}
Parameters
string


api token is required field
string


userId is required field
string

ex: nurse or 29-1171.00(onetcode)
Default value is 0 for relevance

keyword is required field
string

city, state(reston, va) or state (VA) or zipcode (20191)
Default value is United states or 0

location is required field
string

ex: 25

radius is required field
integer

ex: 60
Value is 0 to retrieve all jobs

days is required field
string

ex: jobtitle or company or location or accquisitiondate
Default value is 0 for relevance

sortColumns is required field
string

ex: ASC or DESC
Default value is 0 for relevance

sortOrder is required field
integer

ex: 0

startRecord is required field
integer

ex: 10

pageSize is required field
string

filter

string

filter

string

ex: NLx

boolean

ex: true or false

Example Code

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;
using System.Collections.Specialized;
using System.Linq;

namespace CareerOneStopAPISample
{
    class Program
    {
        static void Main(string[] args)
        {
            CreateRequest().Wait();
        }
        private static async Task CreateRequest()
        {
            var qs = new NameValueCollection();
            qs["companyName"] = "value";                        
            qs["locationFilter"] = "value";                        
            qs["source"] = "value";                        
            qs["showFilters"] = "value";                        
            
            var uri = new UriBuilder(Uri.UriSchemeHttps, "api.careeronestop.org")
            {
                Path = "/v1/jobsearch/{userId}/{keyword}/{location}/{radius}/{sortColumns}/{sortOrder}/{startRecord}/{pageSize}/{days}",
                Query = string.Join("&", qs.AllKeys.Select(key => key + "=" + Uri.EscapeUriString(qs[key])))
            };
            
            using (var http = new HttpClient())
            {
                http.DefaultRequestHeaders.Accept.Clear();
                http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "API Token");
                http.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
                var response = await http.GetAsync(uri.Uri).ConfigureAwait(false);
                if (response.IsSuccessStatusCode)
                {
                    var result = await response.Content.ReadAsStringAsync().ConfigureAwait(false);
                }
            }
        }
    }
}
import java.io.IOException;
import java.net.URI;
import java.net.URISyntaxException;
import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class CareerOneStopAPISample {
    public static void main(String[] args) throws IOException, URISyntaxException {
	URI uri = new URIBuilder()
		.setScheme("https")
		.setHost("api.careeronestop.org")
		.setPath("/v1/jobsearch/{userId}/{keyword}/{location}/{radius}/{sortColumns}/{sortOrder}/{startRecord}/{pageSize}/{days}")
                .setParameter("companyName", "value")
                .setParameter("locationFilter", "value")
                .setParameter("source", "value")
                .setParameter("showFilters", "value")
		.build();
	CloseableHttpResponse response = null;
	HttpGet httpGet = null;
	try {
		CloseableHttpClient httpClient = HttpClients.createDefault();
		httpGet = new HttpGet(uri);
		httpGet.setHeader("Content-Type","application/json");
		httpGet.setHeader("Authorization", "Bearer API Token");
		response = httpClient.execute(httpGet);
		HttpEntity entity = response.getEntity();
		System.out.println(EntityUtils.toString(entity));
	} finally {
		if(httpGet != null) httpGet.releaseConnection();
		if(response != null) response.close();
	}
   }
}


Response Structure
                        {
  "Jobcount": "string",
  "Jobs": [
    {
      "JvId": "string",
      "JobTitle": "string",
      "Company": "string",
      "AccquisitionDate": "string",
      "URL": "string",
      "Location": "string",
      "Fc": "string"
    }
  ],
  "Locations": [
    {
      "LocationName": "string",
      "LocationCount": "string"
    }
  ],
  "Companies": [
    {
      "CompanyName": "string",
      "JobCount": "string",
      "CompanyId": "string"
    }
  ],
  "JobsKeywordLocations": {
    "Keyword": "string",
    "Location": "string",
    "IsValidLocation": true,
    "Radius": "string",
    "StartRow": "string",
    "EndRow": "string",
    "IsCode": true,
    "Title": "string",
    "LocationState": "string",
    "Message": "string"
  }
}
                    
                        <ListJobSearch xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/XPAND.CareerOneStop.WebApi.ViewModels">
  <Companies>
    <Company>
      <CompanyId>string</CompanyId>
      <CompanyName>string</CompanyName>
      <JobCount>string</JobCount>
    </Company>
  </Companies>
  <Jobcount>string</Jobcount>
  <Jobs>
    <Job>
      <AccquisitionDate>string</AccquisitionDate>
      <Company>string</Company>
      <Fc>string</Fc>
      <JobTitle>string</JobTitle>
      <JvId>string</JvId>
      <Location>string</Location>
      <URL>string</URL>
    </Job>
  </Jobs>
  <JobsKeywordLocations>
    <EndRow>string</EndRow>
    <IsCode>true</IsCode>
    <IsValidLocation>true</IsValidLocation>
    <Keyword>string</Keyword>
    <Location>string</Location>
    <LocationState>string</LocationState>
    <Message>string</Message>
    <Radius>string</Radius>
    <StartRow>string</StartRow>
    <Title>string</Title>
  </JobsKeywordLocations>
  <Locations>
    <Locations>
      <LocationCount>string</LocationCount>
      <LocationName>string</LocationName>
    </Locations>
  </Locations>
</ListJobSearch>