Search jobs on BirJob
search_jobsSearch open job vacancies on BirJob (birjob.com), Azerbaijan's job board, which also lists Uzbekistan, Kazakhstan, Turkey, Georgia and Kyrgyzstan. Use this when the user asks for jobs or vacancies (vakansiya, iş, вакансии) by role, skill, place, employer, pay or date. Returns 10 jobs a page by default (page_size up to 25): title, company, place, work format, employment type, seniority, salary as numbers and currency, dates, a short snippet and each job's birjob.com URL. query is matched by meaning across Azerbaijani, English and Russian; put place, country, field, company, date, work format, job type, seniority and pay in their own fields. Do not use for one job's full text or apply link (get_job), or for jobs listed after a known time (new_since).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_jobs"
}
}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. | |
| sort | No | relevance (the default with a query): best match first. newest (the default without a query): newest first. salary: highest stated monthly pay first (in manat, or in salary_currency when given), jobs without a salary last. | |
| 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. | |
| 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. | |
| posted_within_days | No | Only jobs posted in the last this many days, 1 to 30. | |
| 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. |