Wiki · API reference
ejobsitesoftware.com API reference
Integrate your job board with external systems and mobile apps using the ejobsitesoftware.com REST API. Authenticate users, search and apply for jobs, post jobs, and read resumes and application history — all through simple HTTP endpoints. Below is the full endpoint reference with parameters and examples.
What is the ejobsitesoftware.com API?
The ejobsitesoftware.com API is a set of REST endpoints that let external applications and mobile apps talk to an ejobsitesoftware.com job board — logging users in, registering job seekers, searching jobs, applying to jobs, posting jobs, and reading resumes and application history. Requests are made as HTTP POST calls, and most actions are protected by an access key you obtain when a user logs in.
https://www.ejobsitesoftware.com/jobboard_demo/app/On your own installation, replace the demo host with your domain — for example https://your-jobboard.com/app/. The endpoint paths stay the same.
Authentication
How access keys work
Most endpoints require an access key. The flow is simple.
Log in
POST to jobseeker_login or recruiter_login with email and password.
Get an access key
On success, the response returns an access_key for the session.
Call & log out
Send access_key with each request, then logout to end the session.
curl -X POST "https://www.ejobsitesoftware.com/jobboard_demo/app/jobseeker_login/" \ -d "act=check" \ -d "email_address=you@example.com" \ -d "password=your_password" # success returns an access_key to use on later calls
Quick reference
All endpoints at a glance
Every endpoint uses the POST method. Full parameters are listed in the sections below.
| Method | Endpoint | Purpose | Auth |
|---|---|---|---|
| POST | /jobseeker_login/ |
Log a job seeker in | — |
| POST | /recruiter_login/ |
Log a recruiter in | — |
| POST | /logout/ |
End the session | access_key |
| POST | /jobseeker_info/ |
Get logged-in job seeker info | access_key |
| POST | /jobseeker_reg/ |
Register or update a job seeker | partial |
| POST | /jobseeker_resumes/ |
List a job seeker’s resumes | access_key |
| POST | /search/ |
Search jobs | — |
| POST | /apply_job/ |
Apply to a job | access_key |
| POST | /applyed_jobs/ |
List applied jobs | access_key |
| POST | /job_countries/ |
List job countries | — |
| POST | /recruiter_info/ |
Get logged-in recruiter info | access_key |
| POST | /add_job/ |
Post a job | access_key |
Reference
Endpoints in detail
Parameters marked required must be sent; optional ones may be omitted.
Authentication
/app/jobseeker_login/Authenticate a job seeker and receive an access key.
actrequired — set tocheck.email_addressrequired — the job seeker’s email.passwordrequired — the account password.
/app/recruiter_login/Authenticate a recruiter and receive an access key.
actrequired — set tocheck.email_addressrequired — the recruiter’s email.passwordrequired — the account password.
/app/logout/End the current session.
access_keyrequired — the session access key.
Job seeker
/app/jobseeker_info/Return the logged-in job seeker’s profile information.
access_keyrequired — the session access key.
/app/jobseeker_reg/Register a new job seeker or update an existing profile.
actrequired —registerfor a new account orupdateto edit.email_addressrequired — the job seeker’s email.passwordrequired — required for a new registration.access_keyupdate — required when updating an existing profile.first_namerequired — the job seeker’s first name.last_nameoptional — the job seeker’s last name.address1required — address line.countryrequired — numeric country id.stateoptional — state or region.cityrequired — city.mobileoptional — mobile number.
/app/jobseeker_resumes/List the resumes belonging to the logged-in job seeker.
access_keyrequired — the session access key.
Returns: an array of resume_id and resume_title on success.
/app/apply_job/Apply to a job with a selected resume.
access_keyrequired — the session access key.job_idrequired — the job to apply to.resume_idrequired — the resume to submit.
/app/applyed_jobs/List the jobs the job seeker has applied to.
access_keyrequired — the session access key.
Returns:jobID, apply_id, job_title, and apply_date on success.
Recruiter
/app/recruiter_info/Return the logged-in recruiter’s profile information.
access_keyrequired — the session access key.
/app/add_job/Post a new job to the board (recruiter access key required).
access_keyrequired — the recruiter session access key.job_titlerequired — the job title.job_countryrequired — numeric country id (existing on site) or free text.job_short_descriptionrequired — a short summary.job_descriptionrequired — the full job description.referenceoptional — free-text reference.stateoptional — free-text state.locationoptional — free-text location.salaryoptional — free-text salary.job_industryoptional — numeric industry id (existing on site).job_experienceoptional — experience in months (numeric).job_typeoptional — existing job type on site.skillsoptional — job tags/skills.job_durationoptional — number of days to show the job (numeric).
Search & data
/app/search/Search jobs with optional filters and paging.
actrequired — set tosearch.keywordoptional — search term.countryoptional — country filter.stateoptional — state filter.locationoptional — location filter.job_categoryoptional — numeric category id (existing on site).start_indexoptional — result start position; defaults to0.
/app/job_countries/List the countries available for jobs.
actrequired — set tolist.
Returns:id and name for each country on success.
Example
Posting a job
A recruiter posts a job with the required fields after logging in.
curl -X POST "https://www.ejobsitesoftware.com/jobboard_demo/app/add_job/" \ -d "access_key=RECRUITER_ACCESS_KEY" \ -d "job_title=Senior PHP Developer" \ -d "job_country=US" \ -d "job_short_description=Build and maintain our job board" \ -d "job_description=Full description of the role..." \ -d "salary=Competitive" \ -d "skills=PHP,MySQL,REST" \ -d "job_duration=30"
Tip: numeric-id fields like job_country, job_industry, and job_category accept ids that already exist on your site. Some fields (like job_country) also accept free text. Check the database description for valid ids.
Answers
Frequently asked questions
What is the ejobsitesoftware.com API?
What is the API base URL?
/app/ path of your job board. The demo uses https://www.ejobsitesoftware.com/jobboard_demo/app/. On your own install, replace the demo host with your domain, e.g. https://your-jobboard.com/app/.How does authentication work?
jobseeker_login or recruiter_login) with email and password. On success you receive an access_key. Pass that key with later requests, and call logout to end the session.What format are the API requests?
act parameter to select an action, such as act=check for login or act=search for search.How do I post a job through the API?
add_job with a valid recruiter access_key. Required fields are job_title, job_country, job_short_description, and job_description, with optional fields like salary, location, industry, experience, skills, and duration.How do I search for jobs?
search with act=search and optional filters such as keyword, country, state, location, and job_category. Use start_index to page through results; it defaults to 0.Can job seekers apply through the API?
jobseeker_resumes, then call apply_job with the access_key, job_id, and resume_id. applyed_jobs returns the application history.Where are the rest of the developer docs?
Keep exploring
Resources & related pages
Build on the ejobsitesoftware.com API
Authenticate, search, apply, and post jobs from any app — with full source code and documented endpoints. Try the demo, or explore the wider developer wiki.