Skip to main content
POST
/
api
/
comparably
/
companies
/comparably/companies
curl --request POST \
  --url https://api.anysite.io/api/comparably/companies \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "company": "<string>",
  "timeout": 300
}
'
[
  {
    "id": 123,
    "alias": "<string>",
    "name": "<string>",
    "url": "<string>",
    "@type": "@comparably_company",
    "mission": "<string>",
    "website": "<string>",
    "image": "<string>",
    "cover": "<string>",
    "phone": "<string>",
    "address": "<string>",
    "revenue": 123,
    "grade": "<string>",
    "grade_score": "<string>",
    "score": 123,
    "metro": "<string>",
    "metro_grade": "<string>",
    "metro_grade_score": "<string>",
    "participant_count": 123,
    "rating_count": 123,
    "award_count": 123,
    "is_claimed": true,
    "is_premium": true,
    "last_modified_date": "<string>",
    "owner": {
      "@type": "@comparably_company_owner",
      "name": "<string>",
      "job_title": "<string>",
      "image": "<string>"
    },
    "star_rating": {
      "@type": "@comparably_star_rating",
      "letter_grade": "<string>",
      "star_rating": 123,
      "participant_count": 123,
      "is_choice_employer": true
    },
    "ceo": {
      "@type": "@comparably_ceo",
      "name": "<string>",
      "score": "<string>",
      "total_score": 123,
      "image": "<string>"
    },
    "awards": [],
    "top_dimensions": [],
    "bottom_dimensions": []
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
company
string
required

Company alias (the URL segment, e.g. 'google') or a full company profile URL. The alias can be resolved via /comparably/companies/search.

Minimum string length: 1
Pattern: ^(?:https?://[^\s]+|[A-Za-z0-9][A-Za-z0-9._-]*)$
Examples:

"google"

"microsoft"

"https://www.comparably.com/companies/google"

timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

Response

Successful Response

id
integer
required
alias
string
required
name
string
required
url
string
required
@type
string
default:@comparably_company
mission
string | null
website
string | null
image
string | null
cover
string | null
phone
string | null
address
string | null
revenue
integer | null
grade
string | null
grade_score
string | null
score
integer | null
metro
string | null
metro_grade
string | null
metro_grade_score
string | null
participant_count
integer | null
rating_count
integer | null
award_count
integer | null
is_claimed
boolean | null
is_premium
boolean | null
last_modified_date
string | null
owner
ComparablyCompanyOwner · object
star_rating
ComparablyStarRating · object
ceo
ComparablyCeo · object
awards
ComparablyAward · object[]
top_dimensions
ComparablyDimension · object[]
bottom_dimensions
ComparablyDimension · object[]