Skip to main content
POST
/
api
/
hh
/
employers
/hh/employers
curl --request POST \
  --url https://api.anysite.io/api/hh/employers \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "employer_id": "<string>",
  "timeout": 300
}
'
[
  {
    "id": 123,
    "name": "<string>",
    "url": "<string>",
    "@type": "@hh_employer",
    "description": "<string>",
    "description_text": "<string>",
    "image": "<string>",
    "cover": "<string>",
    "site_url": "<string>",
    "site_hostname": "<string>",
    "area_name": "<string>",
    "country_code": "<string>",
    "category": "<string>",
    "size_category": "<string>",
    "organization_form_id": 123,
    "industries": [],
    "badges": [],
    "hh_rating_position": "<string>",
    "hh_rating_year": 123,
    "active_vacancy_count": 123,
    "has_open_reviews": true,
    "is_accredited_it": true,
    "is_trusted": true,
    "is_accepted": true,
    "is_zp_employer": true,
    "has_divisions": true
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
employer_id
string
required

HeadHunter employer id, or an employer URL containing it

Minimum string length: 1
Examples:

"1740"

"https://hh.ru/employer/1740"

​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

Response

Successful Response

​
id
integer
required
​
name
string
required
​
url
string
required
​
@type
string
default:@hh_employer
​
description
string | null
​
description_text
string | null
​
image
string | null
​
cover
string | null
​
site_url
string | null
​
site_hostname
string | null
​
area_name
string | null
​
country_code
string | null
​
category
string | null
​
size_category
string | null
​
organization_form_id
integer | null
​
industries
HhEmployerIndustry · object[]
​
badges
HhEmployerBadge · object[]
​
hh_rating_position
string | null
​
hh_rating_year
integer | null
​
active_vacancy_count
integer | null
​
has_open_reviews
boolean | null
​
is_accredited_it
boolean | null
​
is_trusted
boolean | null
​
is_accepted
boolean | null
​
is_zp_employer
boolean | null
​
has_divisions
boolean | null