Filter for Job Data in Scotland

As a job board owner, recruiting agency or researcher one of the most effective ways to localize job listings and provide a tailored experience is by filtering by state or administrative region. Using our jobdata API, you can easily query job listings based on specific states or provinces. Let's explore how you can leverage state-level filtering, focusing on Scotland.

Why Filter by State/Canton/Administrative Region?

Filtering by state offers several advantages:

• Precision: Focus job listings on specific states within a country for enhanced user relevance.
• Localization: Many job seekers search for opportunities within their region, making state-level filters a critical feature for job boards.
• Detailed Insights: State-level data allows for deeper analysis of job trends and market opportunities.
• Improved User Experience: Offering users the ability to filter jobs by state/region ensures more relevant search results, leading to higher satisfaction and engagement.

To fetch job listings specific to Scotland, you can utilize the /api/jobstates/ endpoint to retrieve the state details, followed by the /api/jobs/ endpoint to get relevant job listings. For more details, visit our API documentation.

Step 1: Fetch the state code for Scotland within its country.

import requests

url = "https://jobdataapi.com/api/jobstates/"
params = {
    "country_code": "GB",  # Specify the country code for United Kingdom
    "name": "Scotland"   # Specify the state name
}
headers = {
    "Authorization": "Api-Key YOUR_API_KEY"  # Replace YOUR_API_KEY with your actual API key
}

response = requests.get(url, params=params, headers=headers)

if response.status_code == 200:
    states = response.json()
    if states["results"]:
        state_code = states["results"][0]["code"]  # Get the code of the first matching state
        print(f"State Code for Scotland: {state_code}")
    else:
        print("No matching state found.")
else:
    print(f"Error: {response.status_code}, {response.text}")    

Step 2: Use the obtained state code in combination with the country_code (or use the state_id as single parameter instead - see Job States API Endpoint Documentation) to fetch job listings specific to Scotland.

url_jobs = "https://jobdataapi.com/api/jobs/"
params = {
    "country_code": "GB",
    "state_code": "SCT"
}
headers = {
    "Authorization": "Api-Key YOUR_API_KEY"
}

response = requests.get(url_jobs, headers=headers, params=params)
jobs = response.json()

Example Response (👉 click here for live results from the API):

{
  "count": 1278,
  "next": "https://jobdataapi.com/api/jobs/?country_code=GB&state_code=SCT&page=2",
  "previous": null,
  "results": [
    {
      "id": 871234,
      "company": {
        "name": "InnovateTech",
        "logo": "https://jobdataapi.com/media/company/logo/innovate_logo.jpg"
      },
      "title": "Software Engineer",
      "location": "Remote, Scotland, GB",
      "description": "Join our team of innovators...",
      "application_url": "https://innovate-tech.com/jobs/871234"
      ...
    },
    ...
  ]
}

Benefits for Job Board Owners

Using state-level filtering not only enhances the user experience but also provides you with:

• Granular Control: Target job seekers in Scotland based on specific regions, improving job matching accuracy.
• Scalable Data: Easily expand your database with targeted state-level job data to meet user demands.
• Cross-Filtering Options: Combine state filters with additional parameters like job type, industry, and remote availability for highly specific results.

The state filter works seamlessly with other filters in the API, enabling layered and precise searches that cater to the requirements of your project or use case.