Adzuna API Integration in Python
To fetch job listings using the Adzuna API in Python, you'll begin by interacting with the API through HTTP requests. Below, you'll find a structured approach to achieve this task using Python.
Install Required Libraries
- The `requests` library will be critical for sending HTTP requests. You can install it using pip if it's not already available in your environment.
pip install requests
Compose the API Request
- Adzuna's API requires specific parameters to retrieve job listings, such as your application's API ID, API Key, and the search criteria you want to use.
- You'll need to build the URL with the appropriate query parameters to get data from Adzuna's job listings endpoint.
import requests
def fetch_job_listings(app_id: str, app_key: str, search_query: str, location: str, country: str = 'us') -> dict:
base_url = f"https://api.adzuna.com/v1/api/jobs/{country}/search/1"
parameters = {
'app_id': app_id,
'app_key': app_key,
'what': search_query,
'where': location,
'content-type': 'application/json'
}
response = requests.get(base_url, params=parameters)
return response.json()
Handle the API Response
- Parse the JSON response to extract useful information about the job listings.
- Consider handling potential errors, such as network issues or invalid API credentials, to ensure your application can fail gracefully.
import json
def parse_response(response: dict):
if 'results' in response:
for job in response['results']:
job_title = job.get('title', 'N/A')
company = job.get('company', {}).get('display_name', 'N/A')
location = job.get('location', {}).get('display_name', 'N/A')
print(f"Job Title: {job_title}, Company: {company}, Location: {location}")
else:
print("No results found or an error occurred.")
Execute the Request
- Use the functions you've implemented to fetch and display the jobs based on your search criteria.
- Replace `` and `` with your actual Adzuna API credentials.
app_id = '<YOUR_APP_ID>'
app_key = '<YOUR_APP_KEY>'
search_query = 'Software Developer'
location = 'New York'
response_data = fetch_job_listings(app_id, app_key, search_query, location)
parse_response(response_data)
Ensure Compliance and Responsible Use
- Adhere to Adzuna's terms and conditions, ensuring your use of their API is compliant and responsible.
- Respect rate limits and avoid unnecessary API calls to maintain performance and avoid service disruptions.
