Skip to main content
POST
/
api
/
simplyhired
/
jobs
/
search
/simplyhired/jobs/search
curl --request POST \
  --url https://api.anysite.io/api/simplyhired/jobs/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "text": "<string>",
  "count": 2,
  "timeout": 300,
  "location": "<string>",
  "country": "US",
  "min_salary": 1
}
'
[
  {
    "id": "<string>",
    "@type": "@simplyhired_search_item",
    "title": "<string>",
    "company": "<string>",
    "company_rating": 123,
    "company_page_url": "<string>",
    "location": "<string>",
    "salary": "<string>",
    "snippet": "<string>",
    "job_types": [],
    "benefits": [],
    "requirements": [],
    "skills": [],
    "remote_attributes": [],
    "is_sponsored": true,
    "is_indeed_apply": true,
    "posted_at": 123
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
text
string
required

Search keyword

Minimum string length: 1
​
count
integer
required

Max number of jobs to return

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
location
string | null

City, state, ZIP code, or 'Remote'

​
country
enum<string>
default:US

SimplyHired country edition to search

Available options:
US,
GB,
CA,
IE,
IN,
DE,
FR,
ES,
IT,
NL,
AT,
BE,
CH,
PT,
SE,
BR,
AR,
MX,
AU
​
sort
enum<string> | null

Result ordering

Available options:
relevance,
date
​
distance
enum<string> | null

Search radius around the location, in miles

Available options:
miles_5,
miles_10,
miles_15,
miles_25,
miles_50,
miles_100
​
job_type
enum<string> | null

Employment type

Available options:
full_time,
part_time,
contract,
permanent,
temporary,
temp_to_hire,
internship,
freelance
​
min_salary
integer | null

Minimum annual salary

Required range: x >= 0
​
date_posted
enum<string> | null

Restrict to jobs posted within the last N days

Available options:
last_day,
last_3_days,
last_7_days,
last_14_days

Response

Successful Response

​
id
string
required
​
@type
string
default:@simplyhired_search_item
​
title
string | null
​
company
string | null
​
company_rating
number | null
​
company_page_url
string | null
​
location
string | null
​
salary
string | null
​
snippet
string | null
​
job_types
string[]
​
benefits
string[]
​
requirements
string[]
​
skills
string[]
​
remote_attributes
string[]
​
is_sponsored
boolean | null
​
is_indeed_apply
boolean | null
​
posted_at
integer | null