Juju.com Public API Docs

Juju.com offers a public API that allows developers to search and retrieve job listings from various job boards. In this blog post, we will explore the API documentation and provide example code in JavaScript.

API Authentication

Before making requests to the API, you need to obtain an API key from Juju.com. You can get an API key by signing up for an account on Juju.com. Once you have an account, you can generate an API key by navigating to the "API Access" page in your account settings.

Making a Job Search Request

To search for jobs using the Juju.com API, you need to make an HTTP GET request to the search endpoint with the following parameters:

  • q (required): The search query.
  • l (optional): The location to search for jobs.
  • radius (optional): The radius around the location to search.
  • jt (optional): The job type to search for.
  • start (optional): The starting index of the search results.
  • limit (optional): The maximum number of search results to return.

Here is an example HTTP GET request to search for jobs in San Francisco:

const axios = require('axios');

const API_KEY = 'YOUR_API_KEY';
const SEARCH_ENDPOINT = 'http://api.juju.com/jobs';
const SEARCH_QUERY = 'software engineer';
const SEARCH_LOCATION = 'san francisco';

axios.get(SEARCH_ENDPOINT, {
  params: {
    q: SEARCH_QUERY,
    l: SEARCH_LOCATION,
    limit: 10,
    apiKey: API_KEY,
  }
})
  .then((response) => {
    const jobs = response.data.jobs;
    console.log(jobs);
  })
  .catch((error) => {
    console.error(error);
  });

Retrieving Job Details

To retrieve details about a job listing, you need to make an HTTP GET request to the job details endpoint with the following parameters:

  • jobid (required): The ID of the job listing.
  • publisherid (required): Your Juju.com publisher ID.
  • apiKey (required): Your Juju.com API key.

Here is an example HTTP GET request to retrieve details about a job listing:

const axios = require('axios');

const API_KEY = 'YOUR_API_KEY';
const DETAILS_ENDPOINT = 'http://api.juju.com/jobs/job';
const JOB_ID = '1234';
const PUBLISHER_ID = '5678';

axios.get(`${DETAILS_ENDPOINT}/${JOB_ID}`, {
  params: {
    apiKey: API_KEY,
    publisherid: PUBLISHER_ID,
  },
})
  .then((response) => {
    const job = response.data.job;
    console.log(job);
  })
  .catch((error) => {
    console.error(error);
  });

Conclusion

In this blog post, we explored the Juju.com public API documentation and provided example code in JavaScript for searching for jobs and retrieving job details. The Juju.com API offers a convenient way to access job listings from multiple sources, and can be integrated into various types of applications.

Related APIs