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 } }