Skip to main content

​
Overview

The Search Jobs endpoint lets you programmatically query job listings from the Mokaru database. It is the starting point for most automation workflows - search for relevant positions, then pipe the results into your application tracker or external tools. Common use cases:
  • AI agent job hunting - connect Claude Desktop, GPT, or any AI agent to search for jobs on your behalf. The agent can evaluate listings against your preferences and automatically create applications for the best matches.
  • n8n and Make workflows - build automated pipelines that search for new jobs on a schedule, filter by your criteria, and push results to Slack, Notion, or a spreadsheet.
  • Custom job boards - pull listings into your own interface or internal tool. Combine multiple searches (different roles, locations) into a single view.
  • Market research - track hiring trends by querying specific job titles or locations over time. Monitor how many positions a company has open or how salary ranges shift.
Each search returns up to 25 results per page. Use the page parameter to paginate through larger result sets. The hasMore field in the response tells you whether additional pages are available. Free-tier users receive results from the Mokaru database, which is refreshed daily with popular job titles. Plus users get additional results from external providers (JSearch, Fantastic.jobs), giving broader coverage for niche roles or less common locations. The response includes an id field for each listing. Pass this as jobListingId when creating an application to automatically link salary data and publisher information.
Scope required: jobs:search | Rate limit: 30 requests/min

​
Request

POST /v1/jobs/search

​
Body Parameters

​
query
string
required
Job search keywords (e.g. “software engineer”, “product manager”)
​
location
string
City, state, or country (e.g. “San Francisco”, “Remote”)
​
remote
boolean
Filter remote-only jobs
​
employmentType
string
Filter by type: FULLTIME, PARTTIME, CONTRACTOR, INTERN
​
datePosted
string
Filter by recency: day, 3days, week, month
​
page
number
default:"1"
Page number (25 results per page)

​
Example

curl -X POST "https://api.mokaru.ai/v1/jobs/search" \
  -H "Authorization: Bearer mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "software engineer",
    "location": "San Francisco",
    "remote": true,
    "datePosted": "week"
  }'

​
Response

​
data
array
Array of job listings
​
total
number
Total number of matching jobs
​
hasMore
boolean
Whether more pages are available
​
page
number
Current page number
​
source
string
database (Free) or database+providers (Plus)
{
  "data": [
    {
      "id": "clx1234...",
      "title": "Senior Software Engineer",
      "company": "Acme Corp",
      "companyLogo": "https://...",
      "location": "San Francisco, CA",
      "isRemote": true,
      "employmentType": "Full-time",
      "applyLink": "https://acme.com/careers/123",
      "salaryMin": 150000,
      "salaryMax": 200000,
      "salaryPeriod": "yearly",
      "postedAt": "2026-03-10T00:00:00.000Z"
    }
  ],
  "total": 142,
  "hasMore": true,
  "page": 1,
  "source": "database"
}
Plus users get results from external job providers (JSearch, Fantastic.jobs) in addition to the Mokaru database. The database is refreshed daily with the top 35 most popular job titles.