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

# Quickstart

> Make your first Normalize API call in minutes

## Get started in three steps

### Step 1: Get your API key

Obtain your API key from the [Normalize dashboard](https://trynormalize.com). You will use it to authenticate all requests.

### Step 2: Canonicalize a job title

Parse a job description and get the best matching canonical title:

```bash theme={null}
curl -X POST https://trynormalize.com/api/v1/job-titles/canonicalize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "Senior Software Engineer - Full Stack"}'
```

### Step 3: Booleanize a job title

Convert a job description into a boolean search string:

```bash theme={null}
curl -X POST https://trynormalize.com/api/v1/job-titles/booleanize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "Senior Software Engineer - Full Stack"}'
```

## Request options

Both endpoints accept single or batch input:

* **Single**: Use `input` with a string (max 500 characters)
* **Batch**: Use `inputs` with an array of strings (max 100 items)
* **Exclude**: Optional `exclude` array to filter out specific titles
* **Include**: Optional `include` array to override parsed include phrases
* **Debug**: Set `debug: true` to include parse structure and matches in the response

## Next steps

<CardGroup cols={2}>
  <Card title="Canonicalize" icon="check-double" href="/api-reference/endpoint/canonicalize">
    Full documentation for the canonicalize endpoint.
  </Card>

  <Card title="Booleanize" icon="magnifying-glass" href="/api-reference/endpoint/booleanize">
    Full documentation for the booleanize endpoint.
  </Card>

  <Card title="Bulk operations" icon="file-csv" href="/api-reference/endpoint/bulk-canonicalize">
    Process CSV files asynchronously.
  </Card>

  <Card title="API reference" icon="terminal" href="/api-reference/introduction">
    Overview of all endpoints.
  </Card>
</CardGroup>