Skip to content
This repository has been archived by the owner on Jan 27, 2023. It is now read-only.
/ jobful-api Public archive

A RESTful API to fetch latest job notifications(INDIA only) from various sources.

License

Notifications You must be signed in to change notification settings

deep5050/jobful-api

Repository files navigation

JOBful-API

A RESTful API to fetch latest job notifications(INDIA only) from various sources.

Fetches various job and exam notifications from popular websites and sereves them as json

Examples:

  1. freejobalerts.com Latest Notifications

GET http://localhost:3000/freejobalert/

Returns:

[
    {"title":"BECIL 1028 Skilled & Unskilled Manpower Walk in","link":"http://www.freejobalert.com/becil/25475/"},{"title":"Territorial Army Officer Online Form","link":"http://www.freejobalert.com/indian-army-territorial-army/99486/"},
    {"title":"RRB Paramedical Staff - 13 Lab Superintendent Vacancies Withdrawn","link":"http://www.freejobalert.com/rrb-paramedical/771840/"},
    {"title":"NVS 370 PGT, TGT & FCSA Notification","link":"http://www.freejobalert.com/navodaya-vidyalaya/1785/"},
    {"title":"SAIL Management Trainee through GATE 2019 Online Form","link":"http://www.freejobalert.com/sail/17043/"},
    {"title":"Indian Air Force AFCAT (02/2019) Online Form","link":"http://www.freejobalert.com/afcat/62751/"},
    {"title":"Coast Guard Assistant Commandant- 01/2020 Batch Online Link Available"}
]
  1. All govt. exams

GET http://localhost:3000/freejobalert/gov/other-all-india-exam

Returns:

[
    {"postDate":"27/05/2019","postBoard":"BECIL","postName":"Skilled & Unskilled Manpower  – 1028 Posts","qualification":"8th Class, ITI/ Diploma (Electrical)","advtNo":"001/2019","lastDate":"28 to 30-05-2019 – Walk in","link":"http://www.freejobalert.com/becil/25475/"},
    {"postDate":"27/05/2019","postBoard":"IIT, Kharagpur","postName":"Job Assisant  – 5 Posts","qualification":"Degree","advtNo":"-","lastDate":"17-06-2019","link":"http://www.iitkgp.ac.in/temporary-jobs"},
    {"postDate":"27/05/2019","postBoard":"NVS, Pune","postName":"TGT, PGT & Faculty Cum System Administrator  – 370 Posts","qualification":"DCA, Degree, PG (Relevant Discipline)","advtNo":"-","lastDate":"05-06-2019","link":"http://www.freejobalert.com/navodaya-vidyalaya/1785/#TGT"},
    {"postDate":"27/05/2019","postBoard":"BECIL","postName":"Skilled & Unskilled Manpower  – 1028 Posts","qualification":"8th Class, ITI/ Diploma (Electrical)","advtNo":"001/2019","lastDate":"28 to 30-05-2019 – Walk in","link":"http://www.freejobalert.com/becil/25475/"},
    {"postDate":"27/05/2019","postBoard":"IIT, Kharagpur","postName":"Job Assisant  – 5 Posts","qualification":"Degree","advtNo":"-","lastDate":"17-06-2019","link":"http://www.iitkgp.ac.in/temporary-jobs"},
    {"postDate":"27/05/2019","postBoard":"NVS, Pune","postName":"TGT, PGT & Faculty Cum System Administrator  – 370 Posts","qualification":"DCA, Degree, PG (Relevant Discipline)","advtNo":"-","lastDate":"05-06-2019","link":"http://www.freejobalert.com/navodaya-vidyalaya/1785/#TGT"},{"postDate":"25/05/2019","postBoard":"MECON Limited","postName":"Executive, Accountant, Jr Executive & Other  – 205 Posts","qualification":"Diploma, Degreee, PG (Relevant Discipline), CA/ CMA","advtNo":"-","lastDate":"20-06-2019","link":"https://img.freejobalert.com/uploads/2019/05/Notification-MECON-Limited-Executive-Accountant-Jr-Executive-Other-Posts.pdf"},
    {"postDate":"25/05/2019","postBoard":"NARI","postName":"Research Asst  – 8 Posts","qualification":"Degree/ PG (Relevant Discipline)","advtNo":"-","lastDate":"29-05 & 12-06-2019 – Walk in","link":"http://www.gsacsonline.org/images/News/RA_MH_GJ.pdf"},{"postDate":"25/05/2019","postBoard":"National Institute for Locomotor Disabilities","postName":"Staff Nurse, Hindi Translator, Professional Trainee  – 10 Posts","qualification":"Diploma (GNM), PG Degree/ Diploma (Relevant Discipline)","advtNo":"-","lastDate":"03-06-2019 – Walk in","link":"http://www.niohkol.nic.in/whatsnew/EMPLOYMENT%20NOTICE%20FOR%20WALK%20IN%20INTERVIEW%20on%2003-06-2019.pdf"},
    {"postDate":"25/05/2019","postBoard":"National Institute for Locomotor Disabilities","postName":"Project Coordinator,  Field Worker, Programme Asst, Clinical Tutor  – 5 Posts","qualification":"10th Class, Any Degree, PG","advtNo":"-","lastDate":"04-06-2019 – Walk in","link":"http://www.niohkol.nic.in/whatsnew/EMPLOYMENT%20NOTICE%20CBR%20PROJECT%20FOR%20WALK-IN-INTERVIEW%20on%20%2004-06-2019.pdf"},
    {"postDate":"25/05/2019","postBoard":"IICB","postName":"JRF  – 58 Posts","qualification":"M.Sc with NET-JRF","advtNo":"-","lastDate":"03-06-2019 – Walk in","link":"http://www.career.iicb.res.in/Recruitment%20Notice.php"},
    {"postDate":"25/05/2019","postBoard":"ESIC Hospital, Bareilly","postName":"Full Time Specialist/ Part Time Specialist, Senior Resident  – 19 Posts","qualification":"MBBS, PG Degree/ Diploma (Relevant Discipline)","advtNo":"-","lastDate":"31-05-2019 – Walk in","link":"https://www.esic.nic.in/attachments/recruitmentfile/32e92addf5b3e826af39b2f988994af4.pdf"},
    {"postDate":"26/04/2019","postBoard":"HMT Machine Tools Ltd","postName":"Joint General Manager, Dy General Manager, MO & Other  – 38 Posts","qualification":"Degree (Engg), MBBS, MBA, PGDM, CA/ CMA/ ICWA","advtNo":"22/2019-20","lastDate":"14-05-19 Extended to 31-05-19","link":"http://www.freejobalert.com/hmt-machine-tools-ltd/17916/"},{"postDate":"25/04/2019","postBoard":"Geological Survey of India","postName":"Ordinary Grade Driver  – 37 Posts","qualification":"10th Class","advtNo":"-","lastDate":"26-06-2019","link":"https://img.freejobalert.com/uploads/2019/04/Notification-Geological-Survey-of-India-Driver-Posts.pdf"}
]

Usage

Install 😇

npm install

Run 🆒

npm start

Run As Developer 😎

npm run devrun

Dependencies 🔧

"dependencies": {
    "cheerio": "^1.0.0-rc.3",
    "dotenv": "^8.0.0",
    "express": "^4.17.1",
    "jest": "^24.8.0",
    "request": "^2.88.0",
    "signale": "^1.4.0"
  },
  "devDependencies": {
    "nodemon": "^1.19.1"
  }

State Codes For Query 🇮🇳

code name link
AN Andaman and Nicobar Islands http://www.freejobalert.com/an-government-jobs/
AP Andhra Pradesh http://www.freejobalert.com/ap-government-jobs/
AR Arunachal Pradesh http://www.freejobalert.com/arunachal-pradesh-government-jobs/
AS Assam http://www.freejobalert.com/assam-government-jobs/
BR Bihar http://www.freejobalert.com/bihar-government-jobs/
CG Chandigarh http://www.freejobalert.com/chandigarh-government-jobs/
CH Chhattisgarh http://www.freejobalert.com/chhattisgarh-government-jobs/
DH Dadra and Nagar Haveli http://www.freejobalert.com/dadra-nagar-haveli-government-jobs/
DD Daman and Diu http://www.freejobalert.com/daman-diu-government-jobs/
DL Delhi http://www.freejobalert.com/delhi-government-jobs/
GA Goa http://www.freejobalert.com/goa-government-jobs/
GJ Gujarat http://www.freejobalert.com/gujarat-government-jobs/
HR Haryana http://www.freejobalert.com/haryana-government-jobs/
HP Himachal Pradesh http://www.freejobalert.com/hp-government-jobs/
JK Jammu and Kashmir http://www.freejobalert.com/jk-government-jobs/
JH Jharkhand http://www.freejobalert.com/jharkhand-government-jobs/
KA Karnataka http://www.freejobalert.com/karnataka-government-jobs/
KL Kerala http://www.freejobalert.com/kerala-government-jobs/
LD Lakshadweep http://www.freejobalert.com/lakshadweep-government-jobs/
MP Madhya Pradesh http://www.freejobalert.com/mp-government-jobs/
MH Maharashtra http://www.freejobalert.com/maharashtra-government-jobs/
MN Manipur http://www.freejobalert.com/manipur-government-jobs/
ML Meghalaya http://www.freejobalert.com/meghalaya-government-jobs/
MZ Mizoram http://www.freejobalert.com/mizoram-government-jobs/
NL Nagaland http://www.freejobalert.com/nagaland-government-jobs/
OR Odisha http://www.freejobalert.com/odisha-government-jobs/
PY Puducherry http://www.freejobalert.com/puduchhery-government-jobs/
PB Punjab http://www.freejobalert.com/punjab-government-jobs/
RJ Rajasthan http://www.freejobalert.com/rajasthan-government-jobs/
SK Sikkim http://www.freejobalert.com/sikkim-government-jobs/
TN Tamil Nadu http://www.freejobalert.com/tn-government-jobs/
TS Telangana http://www.freejobalert.com/telangana-government-jobs/
TR Tripura http://www.freejobalert.com/tripura-government-jobs/
UK Uttarakhand http://www.freejobalert.com/uttarakhand-government-jobs/
UP Uttar Pradesh http://www.freejobalert.com/up-government-jobs/
WB West Bengal http://www.freejobalert.com/wb-government-jobs/

How To Use State Codes In HTTP Request?

GET http://localhost:3000/freejobalert/gov/state/ap

OR

GET http://localhost:3000/freejobalert/gov/state/WB

Sources:

Developer Hacks

  1. install vsCode and install REST Client Extension

gnome-shell-screenshot-B7LZ1Z

  1. open the test.rest file and send request directly from vsCode 💥

Screenshot from 2019-05-28 20-39-59

Thankful To

License

MIT License

Copyright (c) 2019 dipankar pal

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

DONATE

If this project helps you in any way making your life easier, you can buy me a ☕ .