# The Talent Os Vercel — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Generate personalized career learning roadmaps by analyzing your GitHub and LeetCode profiles alongside job descriptions you're targeting. Get AI-powered guidance on the specific skills and knowledge you need to develop to land your dream role.

**Category:** Developer Tools | **Website:** [the-talent-os.vercel.app/](https://the-talent-os.vercel.app/) | **Docs:** [parse.bot/marketplace/ddfdef66-99ad-4e48-af9d-0e417d8db4a8/the-talent-os-vercel-app-api](https://parse.bot/marketplace/ddfdef66-99ad-4e48-af9d-0e417d8db4a8/the-talent-os-vercel-app-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-the-talent-os-vercel-app-api-ddfdef66/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### analyze_github

Analyze a GitHub user profile to produce skill category scores (frontend, backend, AI, DevOps, open-source) and a language breakdown by repository count. One round-trip per call; no pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | GitHub username or organization name to analyze. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-the-talent-os-vercel-app-api-ddfdef66/analyze_github \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### analyze_leetcode

Retrieve a LeetCode user's problem-solving statistics including total solved count by difficulty, contest rating, and acceptance rate. One round-trip per call; no pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | LeetCode username to look up. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-the-talent-os-vercel-app-api-ddfdef66/analyze_leetcode \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### generate_roadmap

Generate a personalized career or learning roadmap via AI chat. Describe a career goal, technology to learn, or skill gap and receive a structured text roadmap with phases, daily plans, and recommendations. Supports multi-turn conversation via optional history.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `history` | string | No | JSON-encoded array of previous conversation turns for multi-turn context. Each element is an object with 'sender' (ai or user) and 'text' fields. Omit for a fresh conversation. |
| `message` | string | Yes | The career goal, learning topic, or question to generate a roadmap for (e.g. 'Create a 30-day roadmap for learning React'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-the-talent-os-vercel-app-api-ddfdef66/generate_roadmap \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"history":"<string>","message":"<string>"}'
```

### parse_job_description

Parse a raw job description text into structured fields: title, required skills, technologies, experience level, education, location, salary, responsibilities, and nice-to-haves. One round-trip per call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `text` | string | Yes | The full job description text to parse. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-the-talent-os-vercel-app-api-ddfdef66/parse_job_description \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"<string>"}'
```