CleverJobs API


There is a simple API for employers or third party services on CleverJobs.

You can get your balance and post a job via API.


We use a simple url pattern for all api requests.

Base URL: https://cleverjobs.net/api/<apiKey>/<methodName>


Generate an api key from your "Account Setting" page.

get company Balance

getBalance (GET)

You can use this method to get your company balance. Balance currency is USD

URL:
https://cleverjobs.net/api/<apiKey>/getBalance

Response:
{ "success": true, "balance": 10000.00 }
Storing a Vacancy

storeVacancy (POST)

This method is for saving a job as draft on CleverJobs

Parameter Required Type Default Description
title Yes string - The job title (e.g. "senior python developer")
line_description Yes plain text - A short description - 1 or 2 line (you can start with "we are looking for ...")
requirements Yes plain text / html - The job requirements
apply_url Yes url / email - A url or an email to apply for this position.
category Yes One of [ development-programming | design-art | devops-sysadmin | database | writing-translation | sales-marketing | business-finance | product | management | other | customer-service | quality-assurance | network-security | human-resources ] - The category of this position. (e.g. "development-programming")
types Yes [ part_time | full_time | temporary | intern | volunteer | contractor | per_diem ] - The type of this position.(e.g. "part_time") (e.g. "full_time,part_time")
levels Yes [ intern | junior | middle | senior | lead ] - The level of this position. (e.g. "middle") (e.g. "junior,middle,senior")
tags Yes string - The tags (skills, techs) of this position. (e.g. "nodejs") (e.g. "nodejs,javascript,mysql")
description No plain text / html null The job description (other descriptions except requirements)
apply_description No plain text / html null Describe job seekers how they can apply.
salary No integer / range null How much is the salary of this position? (e.g. 80000)/(e.g. 80000-100000)
salary_type No One of [ hourly | daily | weekly | monthly | yearly | contract ] yearly Salary payment period.
salary_currency No One of [ usd | eur | gbp | jpy ] usd Salary payment currency.
preferred_time_zone No -12 to +14 all the employee working time zone (e.g. -8)
preferred_time_zone_tolerance No 0 to 8 0 how many hours the employee working time zone can be different.
preferred_countries No country code worldwide you want candidates from which countries? (e.g. "us")/(e.g. "us,fr,de")
is_external No true / false false If it set to true, this job will not be linked to your public profile and will be shown as independent job post.

it's useful when you post jobs for other companies as a recruiter, agency or as a third party service.
if set to true you MUST set the company_name parameter as well.

company_name No string null Hiring company name

It MUST be set if you set the is_external parameter as true

URL:
https://cleverjobs.net/api/<apiKey>/storeVacancy

Response:
{ "success": true, "vacancy": { "id": 1, "status": "draft", "url": "https://cleverjobs.net/remote/your-job-slug" } }
Publish a Vacancy

publishVacancy (POST)

This method is for publishing a job on CleverJobs

Parameter Required Type Default Description
vacancy_id Yes integer - The vacancy id that you have from storeVacancy method
send_to_telegram_channel No true / false true Should this vacancy publish on our Telegram channel?
send_to_telegram_subscribers No true / false true Should this vacancy send to subscribers of our Telegram bot?
send_to_email_subscribers No true / false true Should this vacancy send to subscribers via email?
is_extended No true / false false it will be extend the job availability for extra 30 days (60 days in total)
has_logo No true / false false Your company logo on the job card.
is_featured No true / false false show the job for a month on the home page.

URL:
https://cleverjobs.net/api/<apiKey>/publishVacancy

Response:
{ "success": true, "vacancy": { "id": 1, "status": "published", "valid_until": "2022-01-20 00:00", "featured_until": "2022-01-20 00:00", "url": "https://cleverjobs.net/remote/your-job-slug" }, "total": 300.00, "balance": 9700.00 }
Get a Vacancy Status

getVacancyStatus (GET)

This method is for getting a vacancy status on CleverJobs

Parameter Required Type Default Description
vacancy_id Yes integer - The vacancy id that you have from storeVacancy method

URL:
https://cleverjobs.net/api/<apiKey>/getVacancyStatus?<PARAMETERS>

Response:
{ "success": true, "vacancy": { "id": 54, "status": "draft", "valid_until": null, "featured_until": null, "url": "https://cleverjobs.net/remote/your-job-slug" }, "stats": { "views_on_website": 0, "shares_on_website": 0, "applies_on_website": 0, "delivery_count": 0 } }