Search jobs
Searches the whole job supply by title and place, beyond the candidate's matches. Answers only jobs GetMattered can apply to now, best first, at most 10: narrow the search rather than page it. Omit query and location to search the candidate's saved preferences. Pass a result's jobUrl to POST /developer/apply. Free.
DeveloperKeyAuthorizationBearer <gm_live_...>A GetMattered developer API key, sent as Authorization: Bearer gm_live_....
location?stringA city or country. Omit it to search the countries in the candidate's preferences.
2 <= length <= 200needsVisaSponsorship?stringtrue drops jobs that say they do not sponsor a visa.
"true""false"postedWithinDays?integerOnly jobs posted in the last this many days.
1 <= value <= 30query?stringA job title. Omit it to search the titles in the candidate's preferences.
2 <= length <= 200remoteOnly?stringtrue keeps only remote jobs.
"true""false"salaryMin?|Lowest yearly pay in US dollars. A job with no stated pay stays in.
0 <= valueJobs GetMattered can apply to now, best first.
application/json- response
Successful API response
data*meta?success*truetruecurl -X GET 'https://api.getmattered.com/api/v1/developer/jobs/search'{
"data": {
"countries": [
"ae"
],
"jobs": [
{
"company": "string",
"jobMatchId": 1,
"jobUrl": "string",
"location": "string",
"postedDate": "string",
"remote": true,
"salaryMaxUsd": 0,
"salaryMinUsd": 0,
"system": "string",
"title": "string"
}
],
"outcome": "found",
"titles": [
"string"
]
},
"meta": {
"duration": 0,
"performance": {
"dbQueries": 0,
"totalDbTime": 0
},
"requestId": "string",
"timestamp": "2019-08-24T14:15:22Z",
"version": "string"
},
"success": true
}List the candidate's matches GET
The candidate's matches: the jobs GetMattered found for their preferences and has not shown as decided, best fit first, the deck the candidate sees in the app. Reading it changes nothing. Free.
Apply to a job posting POST
Needs a key made with the `apply` scope. Applies to one job posting for the key owner's own account, the way GetMattered applies from the app: it resolves the link to the employer's posting, prepares the application and sends it, or holds it for the owner's approval. Answers at once; read the outcome from `GET /developer/applications/{id}`. The same posting twice answers with the same application. A stopped application starts again, except one `held` or one the owner cancelled. It spends the API balance, never the app plan, and needs 40,000 API tokens there for each application in progress plus this one to start; a running application finishes even if it takes the balance below zero, and the next call is refused until a top-up. At most 5 applications started by API are in progress at once, and an account reads at most 5 postings a minute across its keys. Spends the tokens the application uses plus the request fee, recorded as `apply`. A call refused before the posting is read spends nothing; once the posting is read, the call pays the request fee whatever it answers.