boss.az APIboss.az ↗
Access job vacancies, company profiles, and contact details from boss.az. Search by keyword, salary, region, and category across Azerbaijan's job market.
curl -X GET 'https://api.parse.bot/scraper/cfd9cc2f-27e9-45aa-955b-64d969d76000/search_vacancies?limit=5&search_term=manager' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for job vacancies with optional filters including keyword, category, region, salary range, education, and experience. Returns paginated results with contact info (email, phones) and supports cursor-based pagination.
| Param | Type | Description |
|---|---|---|
| after | string | Cursor for pagination, use endCursor from a previous response's pageInfo. |
| limit | integer | Number of results to return per page. |
| region_ids | string | JSON array of region/city IDs to filter by (e.g. "[1,4]"). IDs available from get_all_regions. |
| salary_max | integer | Maximum salary filter. |
| salary_min | integer | Minimum salary filter. |
| search_term | string | Keyword to search for in vacancy listings. |
| category_ids | string | JSON array of job category IDs to filter by (e.g. "[37,38]"). IDs available from get_all_categories. |
| education_ids | string | JSON array of education level IDs to filter by. |
| experience_ids | string | JSON array of experience level IDs to filter by. |
{
"type": "object",
"fields": {
"nodes": "array of vacancy objects with id, positionName, name, location, salaryFrom, salaryTo, email, phones, description, requirements, responsibilities, education, experience, and profile",
"pageInfo": "object with endCursor (string) and hasNextPage (boolean)",
"totalCount": "integer total number of matching vacancies"
},
"sample": {
"data": {
"nodes": [
{
"id": "267852",
"name": "Mossino Parfumerie",
"email": "[email protected]",
"phones": [
"+1 (555) 012-3456"
],
"profile": {
"id": "81774",
"name": "Mossino Parfumerie"
},
"location": "Bakı",
"salaryTo": 1000,
"education": "Orta",
"__typename": "Vacancy",
"experience": "1 ildən 3 ilə qədər",
"salaryFrom": 700,
"description": "...",
"positionName": "Sales manager",
"requirements": "",
"responsibilities": ""
}
],
"pageInfo": {
"endCursor": "NQ",
"__typename": "PageInfo",
"hasNextPage": true
},
"__typename": "VacancyConnection",
"totalCount": 8
},
"status": "success"
}
}About the boss.az API
The boss.az API provides 5 endpoints for searching job vacancies, retrieving full vacancy details, and fetching company profiles from Azerbaijan's primary job board. The search_vacancies endpoint returns paginated results including contact emails and phone numbers directly from postings, filterable by salary range, region, category, and education level. Lookup endpoints cover individual vacancies and company profiles, while reference endpoints expose all available categories and regions.
Searching Vacancies
The search_vacancies endpoint accepts optional filters including search_term, salary_min, salary_max, category_ids, region_ids, and education_ids. Region and category IDs are JSON arrays — use get_all_regions and get_all_categories to retrieve valid IDs before filtering. Results come back with cursor-based pagination via pageInfo.endCursor and pageInfo.hasNextPage, plus a totalCount for the full result set. Each node in the response includes positionName, salaryFrom, salaryTo, email, phones, location, and a profile object linking to the hiring company.
Vacancy and Company Detail
get_vacancy_details takes a numeric vacancy id (available from search results) and returns the full record: company name, contact email, phone numbers, education requirement, experience requirement, and salary bounds. get_company_profile takes a company id (available from the profile.id field in search results) and returns name, email, phones, logoUrl, regionName, contactName, description, and publishedCount — the number of active listings that company currently has on the platform.
Reference Data
get_all_categories returns a flat array of top-level job categories, each with a children array of subcategories carrying their own id, name, and parentId. get_all_regions returns all geographic regions with id and name. Both endpoints require no inputs and are intended to be called once to build filter payloads for search_vacancies.
- Aggregate Azerbaijan job listings by category and region into a localized job board.
- Extract recruiter contact details (email and phones) from vacancy postings for outreach tools.
- Monitor a company's active vacancy count over time using publishedCount from get_company_profile.
- Build salary benchmarking reports using salaryFrom and salaryTo fields filtered by category or region.
- Match candidates to openings by filtering vacancies on education_ids and experience requirements.
- Sync structured job data into an ATS or CRM using vacancy IDs from paginated search results.
- Enumerate all job categories and regions to populate filter UIs in a recruitment application.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does boss.az have an official developer API?+
What contact information is returned for vacancies and companies?+
get_vacancy_details and get_company_profile return an email field and a phones array. The search_vacancies endpoint also includes email and phones directly on each vacancy node, so you can retrieve contact details without a separate lookup request.How does pagination work in search_vacancies?+
pageInfo object with endCursor (a string) and hasNextPage (boolean). Pass the endCursor value as the after parameter in your next request to retrieve the following page. The totalCount field tells you the total number of matching vacancies across all pages.Does the API return job application URLs or links to apply directly?+
Is vacancy data available for regions outside Azerbaijan?+
get_all_regions reflects Azerbaijani cities and districts. Listings outside that geography are not part of the platform's scope. You can fork this API on Parse and revise it to point to a different regional job source if broader geographic coverage is needed.