Skip to main content
POST
/
api
/
hh
/
employers
/
search
/hh/employers/search
curl --request POST \
  --url https://api.anysite.io/api/hh/employers/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "query": "<string>",
  "count": 2,
  "timeout": 300
}
'
[
  {
    "id": 123,
    "name": "<string>",
    "url": "<string>",
    "@type": "@hh_employer_search_item",
    "vacancy_count": 0,
    "organization_form_id": 123
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
query
string
required

Employer name to search for

Minimum string length: 1
Example:

"Sber"

​
count
integer
required

Max result count

Required range: x >= 1
Example:

20

​
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_search_item
​
vacancy_count
integer
default:0
​
organization_form_id
integer | null