Skip to main content
POST
/
api
/
dice
/
jobs
/
search
/dice/jobs/search
curl --request POST \
  --url https://api.anysite.io/api/dice/jobs/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "q": "python",
  "location": "New York, NY, USA",
  "employment_type": [],
  "workplace_types": [],
  "easy_apply": true,
  "is_remote": true,
  "willing_to_sponsor": true
}
'
[
  {
    "id": "<string>",
    "@type": "@dice_job_search_result",
    "title": "<string>",
    "url": "<string>",
    "summary": "<string>",
    "company_name": "<string>",
    "company_url": "<string>",
    "company_logo": "<string>",
    "client_brand_id": "<string>",
    "employment_type": "<string>",
    "employer_type": "<string>",
    "workplace_types": [],
    "is_remote": true,
    "easy_apply": true,
    "willing_to_sponsor": true,
    "location": {
      "@type": "@dice_job_location",
      "city": "<string>",
      "region": "<string>",
      "postal_code": "<string>",
      "country": "<string>"
    },
    "salary": {
      "@type": "@dice_job_salary",
      "text": "<string>",
      "currency": "<string>",
      "min_value": 123,
      "max_value": 123
    },
    "posted_at": "<string>",
    "modified_at": "<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 jobs to return

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

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
q
string | null

Keyword to search jobs by (title, skills, company)

Example:

"python"

location
string | null

Location to search in

Example:

"New York, NY, USA"

posted_date
enum<string> | null

Only jobs posted within this window

Available options:
ONE,
THREE,
SEVEN
employment_type
enum<string>[] | null

Filter by one or more employment types

Available options:
FULLTIME,
PARTTIME,
CONTRACTS,
THIRD_PARTY
workplace_types
enum<string>[] | null

Filter by one or more workplace settings

Available options:
Remote,
On-Site,
Hybrid
employer_type
enum<string> | null

Filter by who is hiring

Available options:
Direct Hire,
Recruiter
easy_apply
boolean | null

Only jobs that support quick apply

is_remote
boolean | null

Only fully remote jobs

willing_to_sponsor
boolean | null

Only jobs willing to sponsor work authorization

Response

Successful Response

id
string
required
@type
string
default:@dice_job_search_result
title
string | null
url
string | null
summary
string | null
company_name
string | null
company_url
string | null
company_logo
string | null
client_brand_id
string | null
employment_type
string | null
employer_type
string | null
workplace_types
string[]
is_remote
boolean | null
easy_apply
boolean | null
willing_to_sponsor
boolean | null
location
DiceJobLocation · object
salary
DiceJobSalary · object
posted_at
string | null
modified_at
string | null