Skip to main content
POST
/
api
/
habrcareer
/
vacancies
/
search
/habrcareer/vacancies/search
curl --request POST \
  --url https://api.anysite.io/api/habrcareer/vacancies/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "text": "<string>",
  "specialization": "<string>",
  "skills": [
    123
  ],
  "salary": 1,
  "remote": true,
  "with_salary": true,
  "city_id": 123
}
'
[
  {
    "id": 123,
    "title": "<string>",
    "url": "<string>",
    "@type": "@habrcareer_vacancy_search_item",
    "salary": {
      "@type": "@habrcareer_search_salary",
      "salary_from": 123,
      "salary_to": 123,
      "currency": "<string>",
      "formatted": "<string>"
    },
    "salary_qualification": "<string>",
    "predicted_salary": {
      "@type": "@habrcareer_search_salary",
      "salary_from": 123,
      "salary_to": 123,
      "currency": "<string>",
      "formatted": "<string>"
    },
    "company": {
      "@type": "@habrcareer_search_company",
      "id": 123,
      "alias": "<string>",
      "title": "<string>",
      "image": "<string>",
      "rating": 123,
      "is_accredited": true,
      "web_url": "<string>"
    },
    "qualification": "<string>",
    "employment": "<string>",
    "is_remote": true,
    "is_marked": true,
    "divisions": [],
    "skills": [],
    "locations": [],
    "reaction_count": 123,
    "published_at": "<string>",
    "published_label": "<string>"
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
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
text
string | null

Search query

specialization
string | null

Specialization alias to browse (e.g. backend, frontend, data_scientist); resolved from the specializations reference. Cannot be combined with the other filters.

qualification
enum<string> | null

Required qualification level

Available options:
Intern,
Junior,
Middle,
Senior,
Lead
skills
integer[] | null

Skill ids to filter by

salary
integer | null

Minimum salary

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

Salary currency

Available options:
rur,
usd,
eur,
uah,
kzt
remote
boolean | null

Only remote-friendly vacancies

with_salary
boolean | null

Only vacancies that specify a salary

city_id
integer | null

City id to filter by (e.g. 678 = Moscow)

employment_type
enum<string> | null

Employment type

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

Result ordering

Available options:
relevance,
date,
salary_desc,
salary_asc

Response

Successful Response

id
integer
required
title
string
required
url
string
required
@type
string
default:@habrcareer_vacancy_search_item
salary
HabrcareerSearchSalary · object
salary_qualification
string | null
predicted_salary
HabrcareerSearchSalary · object
company
HabrcareerSearchCompany · object
qualification
string | null
employment
string | null
is_remote
boolean | null
is_marked
boolean | null
divisions
string[]
skills
string[]
locations
string[]
reaction_count
integer | null
published_at
string | null
published_label
string | null