Skip to main content
POST
/
api
/
dice
/
companies
/
search
/dice/companies/search
curl --request POST \
  --url https://api.anysite.io/api/dice/companies/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "industry": [
    "Finance",
    "Banking"
  ],
  "size": [],
  "office_policy": [],
  "latitude": 0,
  "longitude": 0,
  "hiring": true
}
'
[
  {
    "id": "<string>",
    "@type": "@dice_company_search_result",
    "name": "<string>",
    "profile_url": "<string>",
    "image": "<string>",
    "employee_count": "<string>",
    "office_policy": [],
    "categories": [],
    "benefits": [],
    "locations": [],
    "job_count": 123,
    "completeness_score": 123
  }
]

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
​
industry
string[] | null

Filter by one or more industries. Values are the industry display names Dice exposes in the company categories facet (e.g. Finance, Banking, Healthcare, IT Services) — a result's categories field lists the valid names to reuse.

Example:
["Finance", "Banking"]
​
size
enum<string>[] | null

Filter by one or more company employee-count bands

Available options:
1-50,
51-100,
101-200,
201-500,
501-1000,
1001-5000,
5001-10,000,
10,000+
​
office_policy
enum<string>[] | null

Filter by one or more office policies

Available options:
Remote,
Onsite,
Hybrid
​
latitude
number | null

Latitude to search companies near (paired with longitude)

Required range: -90 <= x <= 90
​
longitude
number | null

Longitude to search companies near (paired with latitude)

Required range: -180 <= x <= 180
​
hiring
boolean | null

Only companies that are actively hiring

Response

Successful Response

​
id
string
required
​
@type
string
default:@dice_company_search_result
​
name
string | null
​
profile_url
string | null
​
image
string | null
​
employee_count
string | null
​
office_policy
string[]
​
categories
string[]
​
benefits
string[]
​
locations
string[]
​
job_count
integer | null
​
completeness_score
number | null