Make your first request

Create an API key, export it locally and list current jobs.

1. Create a key

Open Settings, open API keys for a workspace and create a key with the jobs:read scope. The secret is shown once.

2. Set the environment variable

Store the key in your server-side secret manager. For a local shell:

export LURANTA_API_KEY="lur_..."

3. List jobs

curl --request GET \
  --url "https://api.luranta.com/v0/jobs" \
  --header "Authorization: Bearer $LURANTA_API_KEY" \
  --header "Accept: application/json" \
  --get \
  --data-urlencode "roles=software-engineering" \
  --data-urlencode "locations=London" \
  --data-urlencode "experience[min]=3" \
  --data-urlencode "experience[max]=8" \
  --data-urlencode "workArrangements=hybrid" \
  --data-urlencode "workArrangements=remote"

import { Client } from "@luranta/sdk"

const client = new Client({
  apiKey: process.env.LURANTA_API_KEY!,
})

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

for (const job of page.data) {
  console.log(job.title)
}

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)

What to check

Signal	Expected value
Status	200
Body	data array and meta object
Request identity	X-Request-Id response header
Pagination	meta.resultCount, meta.nextToken and meta.previousToken
Billing	Resource count, cost and balance headers