Skip to main content
POST
/
api
/
superjob
/
clients
/
search
/superjob/clients/search
curl --request POST \
  --url https://api.anysite.io/api/superjob/clients/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "text": "<string>",
  "count": 2,
  "timeout": 300,
  "town": 123,
  "with_vacancies": true
}
'
[
  {
    "id": 123,
    "name": "<string>",
    "url": "<string>",
    "@type": "@superjob_client_search_item",
    "description": "<string>",
    "image": "<string>",
    "web_url": "<string>",
    "vacancy_count": 123,
    "employee_count_label": "<string>",
    "review_score": {
      "@type": "@superjob_review_score",
      "total_votes": 123,
      "general_score": 123,
      "career_score": 123,
      "salary_score": 123,
      "stability_score": 123,
      "management_score": 123,
      "team_score": 123,
      "recommend_score": 123
    }
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
text
string
required

Company name to search for

Minimum string length: 1
Example:

"Сбер"

count
integer
required

Max number of companies to return

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

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
town
integer | null

Town/city id to scope the search (e.g. 4 = Moscow)

with_vacancies
boolean | null

Only companies that currently have open vacancies

Response

Successful Response

id
integer
required
name
string
required
url
string
required
@type
string
default:@superjob_client_search_item
description
string | null
image
string | null
web_url
string | null
vacancy_count
integer | null
employee_count_label
string | null
review_score
SuperjobReviewScore · object