canonical: https://jentic.com/apis/payscale.com/jobalyzer-api

# Payscale Jobalyzer

Jentic publishes the only available OpenAPI specification for Jobalyzer, keeping it validated and agent-ready. Jobalyzer is a PayScale service that generates compensation reports based on job attributes including title, skills, certifications, education, and experience. The API provides 9 endpoints for job title matching, compensation impact analysis across skills, certifications, and education levels, location search, and pay report generation with years-of-experience breakdowns.

## For AI agents

Generate PayScale compensation reports and analyze the salary impact of specific skills, certifications, education levels, and experience for matched job titles.

## Scope

Does not handle payroll processing, employee management, or job posting - use for compensation analysis, pay benchmarking, and skills impact assessment only.

## Capabilities

- Match free-text job descriptions to standardized PayScale job titles
- Analyze the compensation impact of specific professional certifications
- Calculate how education level affects pay for a given role
- Measure salary impact of individual technical and soft skills
- Generate compensation reports with median pay and percentile ranges
- Retrieve pay-by-years-of-experience curves for specific job profiles
- Search and validate location data for geographically adjusted pay analysis

## Use cases

### Compensation Benchmarking

Generate market compensation reports for specific job profiles. Jobalyzer matches input job descriptions to standardized PayScale titles, then produces pay reports showing median salary, percentile ranges, and geographic adjustments. Reports can be customized with specific skills, education, and certification inputs to reflect the exact role profile.

Example prompt: Match a job title via POST `/jobalyzer/v2/jobtitlematch`, then generate a compensation report via POST `/jobalyzer/v2/reports` and retrieve pay data via GET `/jobalyzer/v2/reports/{ReportId}/pay`

### Skills and Certification Pay Impact Analysis

Quantify how specific skills and certifications affect compensation for a given role. The API returns pay premium or penalty data for individual competencies, enabling data-driven decisions about professional development investments and hiring requirements.

Example prompt: Query GET `/jobalyzer/v2/impact/skills` for a software engineer role and identify the top 3 skills with the highest pay premium

### Education Level Pay Modelling

Determine how different education levels (bachelor's, master's, PhD) affect compensation for specific roles. The API provides data showing the pay differential between education tiers, supporting decisions about degree requirements in job postings and educational investment ROI calculations.

Example prompt: Retrieve education impact data via GET `/jobalyzer/v2/impact/education` for a data analyst role and compare bachelor's vs master's pay differential

### AI Agent Compensation Research

AI agents use Jobalyzer through Jentic to research salary data and compensation benchmarks as part of hiring, budgeting, or career advisory workflows. Jentic provides intent-based discovery across the 9 Jobalyzer endpoints so agents can generate pay reports without navigating the report creation flow manually.

Example prompt: Search Jentic for 'get salary data for a job title', load the Jobalyzer report creation schema, and generate a compensation report for a product manager in San Francisco

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/jobalyzer/v2/jobtitlematch` | Match text to standardized job titles |
| POST | `/jobalyzer/v2/reports` | Generate a compensation report |
| GET | `/jobalyzer/v2/reports/{ReportId}/pay` | Retrieve pay data from a report |
| GET | `/jobalyzer/v2/reports/{ReportId}/yoe` | Get years-of-experience pay curve |
| GET | `/jobalyzer/v2/impact/skills` | Analyze pay impact of skills |
| GET | `/jobalyzer/v2/impact/certs` | Analyze pay impact of certifications |
| GET | `/jobalyzer/v2/impact/education` | Analyze pay impact of education level |
| GET | `/jobalyzer/v2/locations/{SearchTerm}` | Search for location codes |

## Key resources

- **Reports** — Generate compensation reports and retrieve pay and YOE data
- **Job Title Match** — Match free-text descriptions to standardized PayScale titles
- **Impact Analysis** — Analyze pay impact of skills, certifications, and education
- **Locations** — Search and validate location data for geographic pay adjustment

## Why Jentic

- **Setup:** Wiring Jobalyzer by hand means learning its JWT bearer auth and chaining the multi-step report flow, from title match to report creation to pay and impact lookups, yourself. Through Jentic you install once, import Jobalyzer from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Jobalyzer identifies reports by a generated id in the URL path, so scope the agent by the operations it needs, such as matching a job title or reading skills, certification, and education pay impact. You choose that set, so report creation is not included unless you add it.
- **Credential handling:** Your Jobalyzer bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'analyze the salary impact of certifications', and Jentic returns the matching Jobalyzer operation with its input schema so the agent calls the right endpoint without working out the multi-step report flow from the reference docs.

## Related APIs

- **PayScale API** — General PayScale compensation data and resource API
- **BambooHR** — HR platform for employee records that can consume salary benchmarks
- **Gusto** — Payroll platform that executes the compensation decisions informed by Jobalyzer data

## FAQ

### Why is there no official OpenAPI spec for Jobalyzer?

PayScale does not publish an OpenAPI specification for Jobalyzer. Jentic generates and maintains this spec so that AI agents and developers can call Jobalyzer via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the Jobalyzer API use?

Jobalyzer uses Bearer token authentication. Include your API token in the Authorization header as 'Bearer {token}' with each request. Through Jentic, bearer tokens are stored encrypted in your Jentic One instance and agents receive scoped access without handling raw credentials.

### Can I analyze the salary impact of specific skills?

Yes. The GET `/jobalyzer/v2/impact/skills` endpoint returns compensation impact data for specific skills associated with a job profile. It shows the pay premium or penalty for each skill, enabling quantitative comparison of how different competencies affect market salary.

### How do I generate a compensation report through Jentic?

Use Jentic to search for 'generate salary report', load the schema for POST `/jobalyzer/v2/reports` with job profile parameters, and execute. Then retrieve pay data via GET `/jobalyzer/v2/reports/{ReportId}/pay` for median salary, percentiles, and years-of-experience curves.

### What is job title matching and how does it work?

The POST `/jobalyzer/v2/jobtitlematch` endpoint takes a free-text job title or description and returns matching standardized PayScale job titles. This normalization step ensures compensation data is compared against the correct market benchmark rather than custom internal titles.

### Can I get location-adjusted salary data?

Yes. Use GET `/jobalyzer/v2/locations/{SearchTerm}` to find valid location identifiers, then include the location in your report parameters when calling POST `/jobalyzer/v2/reports.` The generated report reflects geographic pay adjustments for that market.

### Can I limit what my agent is allowed to do with the Jobalyzer API?

Yes. Because you run Jentic One yourself, your own rules decide which Jobalyzer operations and credentials the agent may use, so you can grant only the endpoints a given task needs. For example, you can allow read-only calls like matching a job title with POST `/jobalyzer/v2/jobtitlematch` or reading skills, certification, and education pay impact via the GET `/jobalyzer/v2/impact`/ operations, while withholding report creation with POST `/jobalyzer/v2/reports` unless you add it. Since reports are identified by a generated id in the URL path, the agent can only reach the specific operations you have scoped it to call.