Job Search Service

api.careerbuilder.com

Service Info

http://api.careerbuilder.com/v1/jobsearch?

Returns a list of search results. GET requests only.

Parameters

  • &DeveloperKey=
    • Required
  • &Keywords=
    • Optional, string, must be URL encoded.
    • Can accept a single value, or a comma-separated list of values.
  • &ExcludeKeywords=
    • Optional, string, must be URL encoded.
    • Can accept a single value, or a comma-separated list of values.
  • &CompanyName=
    • Optional, string, must be URL encoded.
    • Accepts a single value
    • Will limit the Job Search to companies whose names contain the value provided
    • Use quote-marks if you have multiple words with spaces and want to match the exact string
  • &ExcludeCompanyNames=
    • Optional, string, must be URL encoded.
    • Accepts a single value
    • Will limit the Job Search to companies whose names not contain the value provided
    • Use quote-marks if you have multiple words with spaces and want to match the exact string
  • &ExcludeJobTitles=
    • Optional, string, must be URL encoded.
    • Accepts a single value
    • Will limit the Job Search to titles whose names not contain the value provided
    • Use quote-marks if you have multiple words with spaces and want to match the exact string
  • &Location=
    • Optional, string, must be URL encoded
    • Can accept a single city name, a single state name, a postal code (as in: 30092), a comma-separated city/state pair (as in: Atlanta, GA), or a latitude and longitude in decimal degree (DD) format (as in 36.7636::-119.7746).
    • If the given location is ambiguous, a list of possible locations will be returned.
  • &Radius=
    • Optional, numeric
    • Can accept a single value only.
    • The search radius size (in miles) around a specified location
    • Must be one of: 5, 10, 20, 30, 50, 100, 150. If no value is provided, defaults to 30.
  • &CountryCode=
    • Optional, string, two-characters
    • Will limit the Job Search to the given country
  • &Category=
    • Optional, string, must be URL encoded
    • Can accept a single value, or a comma-separated list of values. (Maximum 10)
    • If the given value(s) do not match any of CareeerBuilder's category names or category codes, this parameter is ignored. We do not attempt any partial matching.
    • Reference the Categories service for a complete list of valid category names and codes.
    • Note to internal CB developers: This parameter also accepts channel codes.
  • &SOCCode=
    • Optional, string
    • Accepts a single value
    • Will limit the Job Search to jobs related to the given SOC Code.
    • Searches on Major Group, Minor Group, Broad Occupation and Detailed Occuptation.
    • More specific matches are ranked as more relevant in the results
    • Information about SOC classification
  • &EducationCode=
    • Optional, string, must be URL encoded
    • Accepts a single value
    • If the given value does not match one of CareeerBuilder's education codes, this parameter is ignored.
    • By default search results will include results with the requested education code or lower, use the SpecificEducation parameter
    • Reference the EducationCodes service for a complete list of valid education codes.
  • &SpecificEducation=
    • Optional, boolean
    • If set to true, it will only return results with exactly the EducationCode parameter provided.
    • If no EducationCode parameter is provided, this parameter is ignored.
  • &PostedWithin=
    • Optional, numeric
    • Can accept a single value only.
    • Must be one of: 1, 3, 7, or 30. If no value is provided, defaults to 30.
  • &EmpType=
    • Optional, string, must be URL encoded
    • Can accept a single value, or a comma-separated list of values.
    • Valid values are variable, depending on what country is being searched.
    • Reference the Employee Types service for a complete list of valid employee types.
  • &PayLow=
    • Optional, integer
    • This can be used to set a maximum pay level for the search. It should be an integer multiple of 1000.
  • &PayHigh=
    • Optional, integer
    • This can be used to set a minimum pay level for the search. It should be an integer multiple of 1000.
  • &PageNumber=
    • Optional, numeric
    • Can accept a single value only.
    • Use this param to retrieve a specific page of results.
  • &PerPage=
    • Optional, numeric
    • Can accept a single value only.
    • Use this param to set the page size. If no value is provided, defaults to 25.
  • &OrderBy=
    • Optional, string
    • Can accept a single value only.
    • Use this param to set the ordering of the results. If no value is provided, defaults to Relevance.
    • Valid values are: Date, Pay, Title, Company, Distance, Location, and Relevance.
    • Note: Ordering by Date does not ensure strict date ordering.
  • &OrderDirection=
    • Optional, string
    • Can accept a single value only.
    • Use this param to set the direction of the results order. If no value is provided, defaults to descending (generally best to worst).
    • Valid values are: Ascending, ASC, Descending, DESC
    • Note: Ordering by distance defaults to ascending (nearest to farthest).
  • &BooleanOperator=
    • Optional, string
    • Can accept a single value only.
    • Use this param to set change how the keywords are joined together. If no value is provided, defaults to AND.
    • Valid values are: AND, OR
  • &ExcludeNational=
    • Optional, boolean
    • If set to true will exclude jobs whose location is "US-Nationwide"
  • &SiteID=
    • Optional, string
    • Some of our existing partners use this param for tracking purposes. If you don't already know what this is, don't worry about it.
  • &CoBrand=
    • Optional, string
    • Some of our existing partners use this param for tracking purposes. If you don't already know what this is, don't worry about it.
  • Note to internal CB developers: This service will accept a strcrit. If a strcrit is provided, all other params will be ignored.

Sample Output

<?xml version="1.0" encoding="UTF-8" ?>
<ResponseJobSearch>
  <Errors />
  <TimeResponseSent>9/26/2007 2:28:30 PM</TimeResponseSent>
  <TimeElapsed>0.2968826</TimeElapsed>
  <TotalPages>160</TotalPages>
  <TotalCount>436900</TotalCount>
  <FirstItemIndex>1</FirstItemIndex>
  <LastItemIndex>25</LastItemIndex>
  <Results>
    <JobSearchResult>
      <Company>ProTrades Connection</Company>
      <CompanyDetailsURL>http://www.careerbuilder.com/JobSeeker/...
      <DID>J8F7RZ75JKT1J9KBS28</DID>
      <Distance>(Nearby)</Distance>
      <EmploymentType />
      <JobDetailsURL>http://www.careerbuilder.com/JobSeeker/...
      <JobServiceURL>http://api.careerbuilder.com/v1/job?DID=...
      <LocationLatitude>36.763642</LocationLatitude>
      <LocationLongitude>-119.774665</LocationLongitude>
      <Location>CA - Fresno</Location>
      <PostedDate>9/26/2007</PostedDate>
      <Pay>N/A</Pay>
      <SimilarJobsURL>http://www.careerbuilder.com/jobseeker/...
      <JobTitle>Account Executive</JobTitle>
    </JobSearchResult>
    .
    .
    .
    (24 more Job Search Result elements)
    .
    .
    .
  </Results>
</ResponseJobSearch>