Skip to main content
POST
/
api
/
superjob
/
vacancies
/
search
/superjob/vacancies/search
curl --request POST \
  --url https://api.anysite.io/api/superjob/vacancies/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "text": "<string>",
  "count": 2,
  "timeout": 300,
  "town": 4,
  "subject": 123,
  "catalogue": 123,
  "salary_from": 1,
  "no_experience": true,
  "internship": true,
  "language": 123
}
'
[
  {
    "id": 123,
    "name": "<string>",
    "url": "<string>",
    "@type": "@superjob_vacancy_search_item",
    "salary": {
      "@type": "@superjob_salary",
      "salary_from": 123,
      "salary_to": 123,
      "currency": "<string>",
      "currency_label": "<string>",
      "period": "<string>",
      "period_label": "<string>",
      "is_by_agreement": true
    },
    "company": {
      "@type": "@superjob_vacancy_company",
      "id": 123,
      "name": "<string>",
      "image": "<string>",
      "web_url": "<string>",
      "vacancy_count": 123,
      "rating": 123,
      "review_count": 123,
      "is_redirect": true
    },
    "area_id": 123,
    "area_name": "<string>",
    "region_name": "<string>",
    "metro_stations": [],
    "experience": "<string>",
    "experience_label": "<string>",
    "profession": "<string>",
    "catalogues": [],
    "tags": [],
    "tag_keys": [],
    "snippet": "<string>",
    "is_remote": true,
    "published_at": "<string>",
    "created_at": "<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, keywords, or company name

Minimum string length: 1
count
integer
required

Max number of vacancies to return

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

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
town
integer
default:4

Town/city id (e.g. 4 = Moscow, 14 = Saint Petersburg)

subject
integer | null

Region (federal subject) id (see superjob/subjects)

catalogue
integer | null

Industry/specialization catalogue id

salary_from
integer | null

Minimum salary

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

Salary pay period

Available options:
1,
2,
3,
4
work_type
enum<string> | null

Employment type

Available options:
6,
7,
9,
10,
12,
13,
14
work_format
enum<string> | null

Work location format

Available options:
1,
2
no_experience
boolean | null

Only vacancies that require no experience

internship
boolean | null

Only internship vacancies

driving_license
enum<string> | null

Required driver-license category

Available options:
A,
B,
C,
D,
E
language
integer | null

Required foreign-language id

period
enum<string> | null

Publication period

Available options:
1,
3,
7,
0
sort
enum<string> | null

Result ordering

Available options:
relevance,
date_desc,
payment_desc,
payment_asc

Response

Successful Response

id
integer
required
name
string
required
url
string
required
@type
string
default:@superjob_vacancy_search_item
salary
SuperjobSalary · object
company
SuperjobVacancyCompany · object
area_id
integer | null
area_name
string | null
region_name
string | null
metro_stations
SuperjobMetroStation · object[]
experience
string | null
experience_label
string | null
profession
string | null
catalogues
string[]
tags
string[]
tag_keys
string[]
snippet
string | null
is_remote
boolean | null
published_at
string | null
created_at
string | null