Skip to main content
POST
/
api
/
stepstone
/
jobs
/
search
/stepstone/jobs/search
curl --request POST \
  --url https://api.anysite.io/api/stepstone/jobs/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "text": "<string>",
  "count": 2,
  "timeout": 300,
  "location": "<string>",
  "radius": 1,
  "salary_min": 1,
  "discipline": "<string>",
  "sector_id": 123,
  "region_id": 123,
  "city_id": 123
}
'
[
  {
    "id": 123,
    "title": "<string>",
    "url": "<string>",
    "@type": "@stepstone_search_item",
    "company_id": 123,
    "company_name": "<string>",
    "company_url": "<string>",
    "company_image": "<string>",
    "location": "<string>",
    "work_from_home": "<string>",
    "text_snippet": "<string>",
    "is_anonymous": true,
    "is_sponsored": true,
    "published_at": "<string>",
    "global_id": "<string>"
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
text
string
required

Search query — job title, skill, or company name

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 name or postal code

​
radius
integer | null

Search radius around the location in km

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

Restrict to recently posted jobs

Available options:
last_24h,
last_7_days
​
work_from_home
enum<string> | null

Remote-work option

Available options:
full,
partial
​
salary_min
integer | null

Minimum annual salary

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

How to apply for the job

Available options:
company_website,
quick_apply
​
language
enum<string> | null

Language of the job ad

Available options:
german,
english
​
contract_type
enum<string> | null

Type of employment contract

Available options:
permanent,
student_job,
temporary,
internship,
thesis,
trainee,
freelance,
apprenticeship,
temporary_employment,
franchise,
sales_agent,
doctorate,
legal_clerkship
​
work_type
enum<string> | null

Full-time or part-time

Available options:
full_time,
part_time
​
experience
enum<string> | null

Required level of experience

Available options:
no_experience,
with_experience,
with_management
​
discipline
string | null

Job field / professional category (e.g. IT, Marketing, Finanzen)

​
sector_id
integer | null

Employer industry sector id

​
region_id
integer | null

Region id

​
city_id
integer | null

City id

​
sort
enum<string> | null

Result ordering

Available options:
relevance,
date

Response

Successful Response

​
id
integer
required
​
title
string
required
​
url
string
required
​
@type
string
default:@stepstone_search_item
​
company_id
integer | null
​
company_name
string | null
​
company_url
string | null
​
company_image
string | null
​
location
string | null
​
work_from_home
string | null
​
text_snippet
string | null
​
is_anonymous
boolean | null
​
is_sponsored
boolean | null
​
published_at
string | null
​
global_id
string | null