luranta

Official Python client for the Luranta API. Search current jobs and companies from a trusted server.

API keys belong in server-side secrets. Do not put them in browsers, mobile apps, or other public clients.

Requires Python 3.10–3.14.

Install

pip install luranta

Quick start

Create a key in Settings, then:

import os
from luranta import Client

client = Client(api_key=os.environ["LURANTA_API_KEY"])

page = client.jobs.list({
    "roles": ["software-engineering"],
    "locations": ["London"],
    "experience": {"min": 3, "max": 8},
    "work_arrangements": ["hybrid", "remote"],
})

for job in page.data:
    print(job.title, job.company.name)

Jobs

List returns one page of summaries. Iterate walks every page. Retrieve loads a full listing.

for job in client.jobs.iterate({
    "roles": ["software-engineering"],
    "locations": ["London"],
}):
    print(job.title)

listing = client.jobs.retrieve("018f1f8a-4d6e-7a6b-8a2b-7f3e8d1c9a10")
print(listing.description_markdown)

Location filters accept place names, the same way search works on luranta.com.

Companies

companies = client.companies.list({
    "query": "Luranta",
    "countries": ["GB"],
})

jobs and companies both expose list, retrieve, iterate, and with_raw_response.

raw = client.jobs.with_raw_response.list({
    "roles": ["software-engineering"],
})
print(raw.request_id, raw.cost_usd)

Errors

Failed requests raise LurantaProblemError. Network failures without a usable HTTP response raise TransportError.

from luranta import Client, LurantaProblemError

try:
    client.jobs.list({"locations": ["Atlantis"]})
except LurantaProblemError as error:
    print(error.status, error.request_id)
    for issue in error.errors:
        print(issue.code, issue.message, issue.pointer)

Webhooks

import os
from luranta import Client

client = Client(api_key=os.environ["LURANTA_API_KEY"])

def handle(raw_body: bytes, headers: dict[str, str]) -> None:
    event = client.webhooks.construct_event(
        raw_body,
        headers,
        os.environ["LURANTA_WEBHOOK_SECRET"],
    )
    if event["event_type"] == "signals.monitor.delivery":
        return
    if event["event_type"] == "integration.test":
        return

Documentation

• Guides
• API reference
• GitHub

MIT