Skip to Content
Jobs

Search jobs

GET
/developer/jobs/search

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.

Authorization

DeveloperKey
headerAuthorizationBearer <gm_live_...>

A GetMattered developer API key, sent as Authorization: Bearer gm_live_....

Query Parameters

location?string

A city or country. Omit it to search the countries in the candidate's preferences.

Length2 <= length <= 200
needsVisaSponsorship?string

true drops jobs that say they do not sponsor a visa.

Value in"true""false"
postedWithinDays?integer

Only jobs posted in the last this many days.

Range1 <= value <= 30
query?string

A job title. Omit it to search the titles in the candidate's preferences.

Length2 <= length <= 200
remoteOnly?string

true keeps only remote jobs.

Value in"true""false"
salaryMin?|

Lowest yearly pay in US dollars. A job with no stated pay stays in.

Range0 <= value

Response Body

Jobs GetMattered can apply to now, best first.

application/json
  1. response

Successful API response

data*
meta?
success*true
Value intrue
Example Request
curl -X GET 'https://api.getmattered.com/api/v1/developer/jobs/search'
Example Response
{
  "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
}