Job Search API

This document describes the Monster Job Search API.

Summary

Monster Job Search is exposed to the programmer through a simple HTTP interface. Query parameters are sent via a single HTTP GET or POST query and search results, errors and diagnostic information are returned as an XML or JSON document based on standard HTTP content negotiation through headers.

Example:
https://api.jobs.com/v3/search/jobs?title=programmer&city=boston&state=MA&radius=40&country=US&age=365

Authentication and Authorization

Authentication and authorization happens through standard Reverse Proxy means, using Monster provided credentials:

POST: https://api.jobs.com/auth/token?AppId=MyApp&AppSecret=abcdaxkld1235

When supplied authentication information is valid, Reverse Proxy will respond with following information

{ "Token": "eyJ0kld…", "Expires": "2024-06-21T02:34:15.0813256Z" }

The token supplied in the response is then used for all subsequent requests by the application until it expires.

Headers

Authorization: bearer sample1234token

Response format defaults to JSON. If you want XML instead then use the following:

Accept: application/xml

Input Parameters

Parameter Format

All input parameters must be sent using HTTP GET. Care should be taken to URL-encode all parameters correctly. Parameters are also case sensitive. Malformed parameters will either be incorrectly interpreted and or give rise to unexpected results, or a 0xA0002000 – Invalid Input Parameter error will be returned.

Parameters listed as "multi-valued" accept multiple values and may be entered by repeating the parameter.

Query Parameters

Name	Description	Example
Title	Title of the jobs, from Semantic engine.	title=plumber
Skills	Skills of the job, from Semantic engine.	skills=java
Country	Country of the jobs. Required.	country=US
State	State of the jobs	state=MA
City	City of the jobs	city=Boston
Radius	Radius around the location (in miles)	radius=45 (default is 25 miles)
Postalcode	Postal or Zip code	postalcode=02204
Age	How many days old jobs are	age=30 (default is 1 day)
OrderBy	Type of sorting. Options: latest, relevancy	orderBy=latest
Company	Company of the jobs	company=Monster
BoardIds	Boards to limit the jobs to.	boardIds=1
Keywords	Any keywords to refine the search	keywords=java
jobType	Type: FullTime PartTime Internship	jobType=FullTime
MESCO	MESCO O*NET	mesco=1100005001001

Controlling the Results

The maximum number of jobs returned is limited to 1000 to not impact performance of the search engines. Attempting to specify a combination of values that would result in returning the 1001th job or higher will not return those jobs.

Paging (Link Style)
The page and perPage parameter indicates controls the result set that is going to be returned

Examples:

	page=1&perPage=100		return 20 results starting with the 1st job

The default page is 1, the default per page is 20.

In standard RESTful way, the response will also contain link style

Link:
<https://api.jobs.com/search/jobs?title=Engineer&page=1&perPage=100>; rel="first",
<https://api.jobs.com/search/jobs?title=Engineer&page=1&perPage=100>; rel="prev",
<https://api.jobs.com/search/jobs?title=Engineer&page=3&perPage=100>; rel="next",
<https://api.jobs.com/search/jobs?title=Engineer&page=12&perPage=100>; rel="last"

Total Hits

The total number of available jobs (total hits) is available in the response as a header with name "TotalHits" and value of the number of the total number of hits for that given search terms.

Date format

Dates in query results are formatted according to the ISO 8601 standard.

Times are expressed in local time, together with a time zone offset in hours and minutes. For example: 2023-06-04T20:22:25-05:00.

Response Format

JSON

[
  {
    "location": "Alpharetta, GA, 30004",
    "distance": "-1,NaN,INVALID_QUERY_LOCATION",
    "refCode": "d2253c82-93f4-4ee3-bf8d-2eda1d2db0a8",
    "dateCreated": "06\/02\/2023 12:00:00 AM",
    "companyName": "Solutions Inc.",
    "title": "not solution abstract best nervous",
    "url": "https:\/\/jobview.monster.com\/GetJob.aspx?JobID=6982983",
    "summary": "not solution abstract best nervous premium industrial requesting vaste fact master valuable historical letter vaste requirement brainstorming create similar create oposite extra letter fantastic a no newest sampling problems win human sing violin a ...",
    "postingId": "d73d0459-11c5-423a-9578-77bb0a3f28a6",
    "id": "1837271",
    "score": 93.448,
    "companyGuid": "sdfsa74example5sdfkjhdsg",
    "mesco": {
      "id": 4100672001001,
      "alias": "Advertising Sales Agents"
    }
  },
  {
    "location": "Alpharetta, GA, 30009",
    "distance": "-1,NaN,INVALID_QUERY_LOCATION",
    "refCode": "8b9e0f24-430a-4ea3-a10a-65020088c799",
    "dateCreated": "06\/02\/2023 12:00:00 AM",
    "companyName": "Violins Inc.",
    "title": "scale sample violin features features",
    "url": "https:\/\/jobview.monster.com\/GetJob.aspx?JobID=3909161",
    "summary": "scale sample violin features features filtering public business total newest almanah statuses freezing rest and stateman are better Cambridge cooking between statuses abstract Cambridge craftman problematic almanah united crucial info creative never...",
    "postingId": "d216f96d-bea5-4a8d-ae7c-23e81791f564",
    "id": "1831568",
    "score": 93.448,
    "companyGuid": "sdfs345345example2hdsg65757",
    "mesco": {
      "id": 1300093001001,
      "alias": "Business Operations Specialists, All Other"
    }
  }
]


XML FORMAT:

<jobs xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <job>
        <clientrefcode>1941</clientrefcode>
        <companyguid>tzhsymbpb5b33cwlmvru4pz3wa</companyguid>
        <companyname>Monster</companyname>
        <datecreated>07/20/2023 12:00:00 AM</datecreated>
        <jobid>816126591</jobid>
        <location>Mclean, VA, 22102</location>
        <mesco>
            <alias>Information Technology Project Managers</alias>
            <id>1500145001001</id>
        </mesco>
        <monsterurl>https://job-openings.monster.com/project-manager-technical-mclean-va-us-monster/260087387?mstr_dist=true</monsterurl>
        <postingid>d748b3ca-d8d2-450f-a9fb-d3c94bbf15aa</postingid>
        <score>100</score>
        <summary>Project Manager (Technical), Professional Services 

        Own the product! 

        Monster Government Solutions (MGS) is looking for a customer-focused problem solver to work with in a team to co-manage SaaS web-focused HR system implementations. Monster World...</summary>
        <title>Project Manager (Technical)</title>
        <url>https://job-openings.monster.com/project-manager-technical-mclean-va-us-monster/260087387?mstr_dist=true</url>
    </job>
    <job>
        <clientrefcode>1982</clientrefcode>
        <companyguid>tzhsymbpb5b33cwlmvru4pz3wa</companyguid>
        <companyname>Monster</companyname>
        <datecreated>07/20/2023 12:00:00 AM</datecreated>
        <jobid>804622319</jobid>
        <location>Weston, MA</location>
        <mesco>
            <alias>Software Developers, Systems Software</alias>
            <id>1500128001001</id>
        </mesco>
        <monsterurl>https://job-openings.monster.com/net-back-end-developer-contractor-weston-ma-us-monster/258836495?mstr_dist=true</monsterurl>
        <postingid>7c87fb50-742c-4a17-8e5c-f4386695a1eb</postingid>
        <score>100</score>
        <summary>.NET Back-End Developer Contractor 

        We are looking for a .NET back-end developer with experience building system to system data integrations 

        Who We Are  

        Monster’s Government Solutions division provides a variety of hiring and onboarding solutio...</summary>
        <title>.NET back-end Developer Contractor</title>
        <url>https://job-openings.monster.com/net-back-end-developer-contractor-weston-ma-us-monster/258836495?mstr_dist=true</url>
    </job>
</jobs>