> ## Documentation Index
> Fetch the complete documentation index at: https://docs.letsfind.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Find open jobs with one request.

## 1. Get an API key

[Sign in](https://api.letsfind.work/signin), open your account page and create a key. See [Authentication](https://docs.letsfind.work/authentication.md).

```bash theme={null}
export BASE_URL="https://api.letsfind.work"
export API_KEY="your key"
```

## 2. Search

Find nursing jobs in Germany, newest first:

```bash theme={null}
curl "$BASE_URL/v1/jobs?q=nurse&country=DE&limit=2" \
  -H "Authorization: Bearer $API_KEY"
```

The answer is a page of jobs and a `next` cursor:

```json theme={null}
{
  "jobs": [
    {
      "id": 812345,
      "title": "Registered Nurse, Intensive Care",
      "company": "Example Clinic",
      "department": "Nursing",
      "location": "Berlin, Germany",
      "workplaceType": "onsite",
      "employmentType": "full-time",
      "language": "en",
      "countries": ["DE"],
      "regions": ["Berlin"],
      "cities": ["Berlin"],
      "salary": "EUR 48,000 to 56,000 a year",
      "salaryMin": 48000,
      "salaryMax": 56000,
      "salaryCurrency": "EUR",
      "salaryPeriod": "year",
      "salaryYearEur": 52000,
      "occupation": "2221",
      "postedAt": "2026-11-10T08:00:00.000Z",
      "firstSeenAt": "2026-11-10T09:12:31.000Z",
      "snippet": "Join our intensive care team in Berlin. You care for adult patients after major surgery.",
      "benefits": ["retirement", "paid_time_off"],
      "visaSponsorship": null,
      "ats": "personio",
      "url": "https://example-clinic.jobs.personio.de/job/812345",
      "applyUrl": "https://example-clinic.jobs.personio.de/job/812345#apply"
    }
  ],
  "next": "WyIyMDI2LTExLTEwIDA4OjAwOjAwKzAwIiw4MTIzNDVd"
}
```

The example is made up; the fields are the real ones. The [API reference](https://docs.letsfind.work/api-reference/overview.md) describes each field.

## 3. Get the next page

Send the same request with `cursor` set to `next`. Stop when `next` is `null`. See [Paging](https://docs.letsfind.work/paging.md).

```bash theme={null}
curl "$BASE_URL/v1/jobs?q=nurse&country=DE&limit=2&cursor=WyIyMDI2LTExLTEwIDA4OjAwOjAwKzAwIiw4MTIzNDVd" \
  -H "Authorization: Bearer $API_KEY"
```

## 4. See which values exist

Filter values come from the jobs themselves. Ask `GET /v1/facets` which countries, cities, ATS or occupations have open jobs, and how many:

```bash theme={null}
curl "$BASE_URL/v1/facets?q=nurse" -H "Authorization: Bearer $API_KEY"
```

## Next steps

* [Search and filters](https://docs.letsfind.work/search.md): every filter.
* [Credits](https://docs.letsfind.work/credits.md): what each call costs.
* [Errors](https://docs.letsfind.work/errors.md): what can go wrong.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.