Title100/100
Search jobs
The title clearly communicates the tool’s action and subject. Keep it concise.
Description92/100
Search open tech jobs from company career pages tracked by lazee.dev, newest first. Filter by role, level, region, workplace, company, salary and posting date; every filter is optional and they combine with AND (values inside one filter combine with OR). Returns one page of jobs with title, company, location, salary when posted, and the link to apply on the company's own site. Accepted values for each filter are listed in its parameter schema.
The description explains the capability, when to use it, and what to expect.
Inputs97/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
Words to look for in the job title, company name or location, e.g. "react" or "Bangalore". Leave it out to search by filters alone.
Clear enough to supply this argument.
role
Job functions to include; a job matches any of them. "engineering" covers every engineering function at once.
Clear enough to supply this argument.
level
Seniority to include; a job matches any of the levels given.
Clear enough to supply this argument.
region
Countries or regions the person can work from; a job matches if it is open to any of them.
Clear enough to supply this argument.
workplace
Where the work happens; a job matches any of the arrangements given. Jobs whose posting doesn't say are left out when this is set.
Clear enough to supply this argument.
platform
Hiring platforms the job must be posted on. Rarely needed: leave it out unless the person asks for a specific platform.
Clear enough to supply this argument.
company
Companies to include, matched on the full company name ignoring case; a partial name matches nothing.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
has_salary
Only jobs that state their pay.
Clear enough to supply this argument.
salary_min
Lowest yearly pay wanted, in salary_currency. Jobs in other currencies are converted at the day's rate.
Clear enough to supply this argument.
salary_max
Highest yearly pay wanted, in salary_currency.
Clear enough to supply this argument.
salary_currency
Currency that salary_min and salary_max are written in, e.g. USD, INR or EUR. Default USD.
Clear enough to supply this argument.
posted_after
Only jobs posted on or after this date, YYYY-MM-DD.
Clear enough to supply this argument.
sort
posted_desc (newest first, the default) or posted_asc.
Clear enough to supply this argument.
page
Which page of results to return; the result's meta.total_pages says how many there are. Default 1.
Clear enough to supply this argument.
limit
How many jobs to return on each page. Default 10.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"title": "Search jobs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Output schema90/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"required": [
"data",
"meta",
"usage"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"company",
"title",
"url",
"posted_at"
],
"properties": {
"id": {
"type": "string",
"description": "lazee.dev job id."
},
"url": {
"type": "string",
"description": "Link to apply on the company's own site."
},
"role": {
"type": [
"string",
"null"
],
"description": "Job function key."
},
"level": {
"type": [
"string",
"null"
],
"description": "Seniority key."
},
"title": {
"type": "string",
"description": "Job title."
},
"salary": {
"type": [
"object",
"null"
],
"properties": {
"max": {
"type": [
"number",
"null"
],
"description": "Highest pay."
},
"min": {
"type": [
"number",
"null"
],
"description": "Lowest pay."
},
"period": {
"type": "string",
"description": "Pay period, e.g. year or hour."
},
"currency": {
"type": "string",
"description": "ISO 4217 code."
}
},
"description": "Pay read as numbers, in the job's own currency; null when the posting doesn't state it."
},
"company": {
"type": "string",
"description": "Hiring company."
},
"regions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Region keys the job is open to."
},
"location": {
"type": [
"string",
"null"
],
"description": "Location as the posting states it."
},
"platform": {
"type": "string",
"description": "Applicant tracking system the job is posted on."
},
"posted_at": {
"type": "string",
"description": "Posting date (ISO 8601)."
},
"synced_at": {
"type": "string",
"description": "When lazee.dev last confirmed the job is open (ISO 8601)."
},
"workplace": {
"type": [
"string",
"null"
],
"description": "remote, hybrid or onsite."
},
"department": {
"type": [
"string",
"null"
],
"description": "Team or department."
},
"compensation": {
"type": [
"string",
"null"
],
"description": "Pay as the posting words it."
},
"first_seen_at": {
"type": "string",
"description": "When lazee.dev first saw the job (ISO 8601)."
},
"employment_type": {
"type": [
"string",
"null"
],
"description": "Full-time, contract, internship and so on."
}
}
},
"description": "Jobs on this page."
},
"meta": {
"type": "object",
"required": [
"page",
"limit",
"total",
"total_pages"
],
"properties": {
"page": {
"type": "integer",
"description": "This page number."
},
"limit": {
"type": "integer",
"description": "Jobs per page."
},
"total": {
"type": "integer",
"description": "Jobs matching the filters."
},
"total_pages": {
"type": "integer",
"description": "Pages at this limit."
},
"last_synced_at": {
"type": [
"string",
"null"
],
"description": "When the jobs were last refreshed (ISO 8601)."
}
},
"description": "Paging and freshness."
},
"usage": {
"type": "object",
"required": [
"calls_used",
"calls_limit",
"calls_left",
"resets_at"
],
"properties": {
"resets_at": {
"type": "string",
"description": "When the count resets (ISO 8601, UTC)."
},
"calls_left": {
"type": "integer",
"description": "Calls left this month."
},
"calls_used": {
"type": "integer",
"description": "Calls used this month, including this one."
},
"calls_limit": {
"type": "integer",
"description": "Calls allowed per month on the account's plan."
}
},
"description": "This month's lazee.dev tool calls for the signed-in account."
}
}
}