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

# Overview: Job Title API

> v0.0.1

<Note>
  Note: By default, all clients are allowed a maximum of 5 requests per second. Contact us here if you need an adjustment
</Note>

## Overview

**INOP Job Titles API** is a powerful and structured job classification system designed to bring consistency and intelligence to job title data. This API provides access to **INOP’s comprehensive library of job titles**, complete with **normalization capabilities**, **curated job title groupings**, and **skill mappings** for each title.

Organizations often deal with inconsistent, ambiguous, or unstructured job titles in hiring processes, job postings, and workforce analytics. **Job Titles API** addresses this challenge by offering a **standardized framework** to:

* **Normalize raw job titles** – Convert unstructured job titles into standardized INOP-defined titles.
* **Group related job titles** – Access curated job title clusters for better role categorization.
* **Map job titles to required skills** – Gain insights into core and associated skills for each title.

### Access the INOP Job Titles Library

* Retrieve a comprehensive list of standardized job titles used across industries.
* Use predefined taxonomies for consistent classification.

### Normalize Raw Job Titles

* Transform **raw, unstructured, or company-specific job titles** into **INOP-defined job titles**.
* Improve data quality in **HR systems, ATS platforms, and workforce analytics**.

**Raw Title → Standardized Title**

* “Sr. Software Eng.” → Senior Software Engineer
* “Frontend Dev” → Frontend Developer
* “AI Specialist” → Machine Learning Engineer

### Retrieve Curated Job Title Groupings

* Identify **hierarchical and related job families** (e.g., Engineering, Data Science, Product).
* Enable **better career pathing and internal mobility insights**.

#### Example

* **Software Engineer falls** under the **Software Development** job family.
* **Machine Learning Engineer** is categorized under **AI & Data Science**.

### Fetch Skill Mappings for Job Titles

* Discover **essential technical & soft skills** required for each job title.
* Get **role-specific skill expectations** to aid in **hiring, training, and skills gap analysis**.

##### Example:

For **Software Engineer**, the API might return:

```json theme={null}
{
  "job_title": "Software Engineer",
  "skills": {
    "primary": ["Python", "Java", "System Design"],
    "secondary": ["Cloud Computing", "DevOps"],
    "soft_skills": ["Problem-Solving", "Collaboration"]
  }
}
```