New BirJob jobs since a time
new_sinceJobs BirJob first listed after a given time that match the same filters as search_jobs, newest first, with the same fields. Use this when the user asks what is new since a date or since the last check: keep the time of each call and pass it as since next time. since may be up to 30 days back. Do not use for a general search (search_jobs with posted_within_days covers "this week").
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"since": "<since>"
},
"name": "new_since"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | A city or district of Azerbaijan, in Azerbaijani, English or Russian spelling: "Bakı" / "Baku" / "Баку", "Gəncə" / "Ganja" / "Гянджа", "Sumqayıt" / "Sumgait" / "Сумгаит", "Şəki" / "Shaki" / "Шеки". Leave out for the whole country. | |
| page | No | Result page, 1 to 20 (default 1), 10 results a page. Past page 20, send the user to search_url. | |
| query | No | What the user is looking for, in their words: a job title, skills or a sentence about their work ("python", "mühasib", "accountant", "I build production LLM systems with Python and Azure"). Matched by meaning in the title, company and description, across Azerbaijani, English and Russian (mühasib = accountant = бухгалтер; LLM finds AI and ML roles); jobs whose title fits best come first. Azerbaijani letters are optional. Put the place, country, category, company, work format, job type, seniority and pay in their own fields. Leave out to browse. | |
| since | Yes | ISO 8601 date or time, within the last 30 days: "2026-11-20" or "2026-11-20T08:00:00Z". Returns jobs BirJob first listed after it. Keep the time of your last call and pass it next time. | |
| remote | No | Work format. exclude (the default, as on birjob.com): every job except remote ones. only: remote jobs only. any: every job. onsite or hybrid: jobs that say so. Always within the chosen country. | |
| company | No | One employer's jobs: its birjob.com company page URL or slug (from list_companies or a job's company_url), or its name. | |
| country | No | Which board to search: AZ (Azerbaijan, the default), UZ (Uzbekistan), KZ (Kazakhstan), TR (Turkey), GE (Georgia) or KG (Kyrgyzstan). city applies to AZ only. | |
| category | No | A field of work: it (IT / Texnologiya), proqram-tertibati (Proqram Tərtibatı), data-analitika (Data və Analitika), maliyye (Maliyyə / Mühasibat), satis (Satış / Marketing), huquq (Hüquq), muhendislik (Mühəndislik), bank (Bank / Sığorta), insan-resurslari (İnsan Resursları), tibb (Tibb / Səhiyyə), aqro-kend-teserrufat (Aqro / Kənd Təsərrüfatı), neft-qaz (Neft-Qaz), suni-intellekt (Süni İntellekt / AI). | |
| page_size | No | Results a page, 1 to 25 (default 10). Keep the same page_size while paging. | |
| seniority | No | Keep only jobs whose stated career level is one of these: intern (təcrübəçi, стажёр), junior (kiçik mütəxəssis, младший), mid (orta, средний), senior (böyük mütəxəssis, старший), lead (rəhbər, ведущий), exec (top menecer, руководитель). Most postings state none, so this narrows a lot. | |
| salary_min | No | Lowest monthly pay. Keeps only jobs that state a salary at least this high, in salary_currency (default AZN on the Azerbaijan board). Nothing is converted between currencies. | |
| work_format | No | remote (uzaqdan, удалённо), hybrid (hibrid, гибрид) or onsite (ofisdə, в офисе): the same as remote=only, hybrid or onsite. Send this or remote, not both. | |
| employment_type | No | Keep only jobs that state one of these types: full_time (tam ştat, полная занятость), part_time (yarım ştat, частичная занятость), contract (müqavilə, контракт), internship (təcrübə, стажировка), temporary (müvəqqəti, временная). A job that states no type is left out. | |
| salary_currency | No | ISO currency of salary_min. Alone, keeps only jobs that state pay in this currency. Required for salary_min outside Azerbaijan. | |
| exclude_employment_type | No | Leave out jobs that state one of these types, e.g. ["internship"]. A job that states no type stays. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobs | Yes | ||
| page | Yes | ||
| notes | Yes | ||
| pages | Yes | Pages an assistant can read, at most 20. | |
| total | Yes | Open jobs that match. | |
| filters | Yes | ||
| next_page | Yes | ||
| page_size | Yes | ||
| search_url | Yes | The same search on birjob.com, with every result. |