Skip to main content
POST
/
api
/
habrcareer
/
companies
/
ratings
/habrcareer/companies/ratings
curl --request POST \
  --url https://api.anysite.io/api/habrcareer/companies/ratings \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "year": 2057,
  "city_id": 123
}
'
[
  {
    "alias": "<string>",
    "title": "<string>",
    "url": "<string>",
    "@type": "@habrcareer_company_rating_item",
    "id": 123,
    "position": 123,
    "rating": 123,
    "description": "<string>",
    "city": "<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 companies to return

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

Max scrapping execution timeout (in seconds)

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

Rating year (e.g. 2025)

Required range: 2015 <= x <= 2100
city_id
integer | null

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

size
enum<string> | null

Company size band

Available options:
5,
4,
3,
2,
1

Response

Successful Response

alias
string
required
title
string
required
url
string
required
@type
string
default:@habrcareer_company_rating_item
id
integer | null
position
integer | null
rating
number | null
description
string | null
city
string | null