CV APIcv.lv ↗

"""Walkthrough: CV.lv Job Board SDK — search vacancies, drill into details, browse reference data."""
from parse_apis.CV_lv_Job_Board_API import CVlv, Category, Sorting, DirectoryType, VacancyNotFound

client = CVlv()

# Search for IT jobs sorted by salary, capped at 5 results
for vacancy in client.vacancies.search(categories=Category.INFORMATION_TECHNOLOGY, sorting=Sorting.SALARY, limit=5):
    print(vacancy.position_title, vacancy.employer_name, vacancy.salary_from, vacancy.publish_date)

# Drill into the first vacancy's full details
vacancy = client.vacancies.search(categories=Category.SALES, limit=1).first()
if vacancy:
    detail = vacancy.details()
    print(detail.position, detail.highlights.salary_from, detail.highlights.rate_per)
    print(detail.contacts.first_name, detail.contacts.email)
    for section in detail.details.standard_details[:2]:
        print(section.id, section.title)

# Browse directory items by location type
for item in client.directory_items.list(type=DirectoryType.LOCATION, limit=3):
    print(item.id, item.type, item.target_type, item.count, item.display_on_main_page)

# Get top employers
for emp in client.employers.top(limit=5):
    print(emp.employer_name, emp.vacancy_count, emp.about[:60])

# Get category reference data
cat_map = client.category_maps.get()
print(cat_map.categories)

# Handle a missing vacancy gracefully
try:
    v = client.vacancies.search(limit=1).first()
    if v:
        v.details()
except VacancyNotFound as exc:
    print(f"Vacancy gone: {exc.vacancy_id}")

# Get all locations reference data — towns, counties, and countries
loc = client.locations.get()
for town in loc.towns[:3]:
    print(town.id, town.name, town.country_id)
for cid, country in list(loc.countries.items())[:2]:
    print(country.id, country.iso, country.name)

print("exercised: vacancies.search / vacancy.details / directory_items.list / employers.top / category_maps.get / locations.get")