Search jobs

Jobs by title, company, city and state, open jobs only if you ask.

GET https://cotlet.dev/api/v1/jobdiva/jobs/search

read

Returns one row per job with its id, JobDiva reference, title, company, location and status. Use job_id in get_job, list_submittals and create_submittal. Jobs you cannot open in JobDiva are not returned.

Parameters

Parameters: search_jobs
NameTypeDescription
title string string Words from the job title.
company_name string string Company the job is for.
city string string City of the job.
state string string State of the job.
open_only boolean boolean true returns open jobs only.
limit integer integer Maximum number of jobs returned.

Request

cURL
curl https://cotlet.dev/api/v1/jobdiva/jobs/search \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("jobdiva", "search_jobs")
Node.js
const result = await cotlet.call('jobdiva', 'search_jobs');
CLI
cotlet call jobdiva search_jobs

Example response

JSON

{
  "jobs": [
    {
      "job_id": 24071835,
      "reference": "26-04817",
      "title": "Senior Data Analyst",
      "company": "Northwind Logistics",
      "location": "Chicago, IL",
      "status": "Open"
    },
    {
      "job_id": 24072210,
      "reference": "26-04902",
      "title": "Data Engineer",
      "company": "Harbor Freight Tech",
      "location": "Austin, TX",
      "status": "Open"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.