# Salary API for Global Compensation Data

The Jobicy Salary API lets developers integrate real-time salary ranges, compensation benchmarks, required skills, and labor market insights into websites, HR platforms, ATS software, and career applications through a fast REST API.

[Remote Jobs](https://jobicy.com/jobs.md) [Companies](https://jobicy.com/companies.md) [Job Categories](https://jobicy.com/categories.md) [Job Locations](https://jobicy.com/jobs-locations.md) [Remote Talent](https://jobicy.com/talent.md) [Job Alerts](https://jobicy.com/alerts.md) [Career Journal](https://jobicy.com/blog.md) [Salaries Directory](https://jobicy.com/salaries.md) Table of content: [Commercial Salary API](#section1)
[Quick Start](#section2)
[Query Parameters](#section3)
[Response Fields](#section4)
[API Features](#section5)
[JSON Response Schema](#section6)
[Interactive API Playground](#section7)
[Error Codes](#section8)
[Data Coverage](#section9)
[Pricing](#section10)
[Rate Limits](#section11)
[Common Use Cases](#section12)
[Frequently Asked Questions](#section13)

## Commercial Salary API

The Jobicy Salary API provides programmatic access to global salary ranges, compensation benchmarks, regional income data, required job skills, and labor market insights across more than 20 countries and thousands of job titles.

The REST API returns structured JSON responses containing salary ranges, hourly rates, compensation benchmarks, required skills, market demand, and regional employment insights. It's designed for HR platforms, ATS software, career websites, AI assistants, recruiting tools, and salary comparison applications.

Core API Specifications:
• Base Endpoint: GET https://jobicy.com/api/v2/salary
• Standard Rate: $0.109 USD per successful lookup.
• Cost Optimization Layer: Identical requests (same Title + Country) queried within a 30-day window are $0.000 (Free) if data has not changed on the server.
• Rate Limiting: Hard threshold capped at maximum 10 requests / second per key.

## Quick Start

Getting started with the Salary API only takes a few minutes.

* Create an API key from your [API Dashboard](https://jobicy.com/api-dashboard.md).
* Fund your API wallet.
* Send your first request using your API key.
* Receive a structured JSON response with salary and market data.

curl -X GET "https://jobicy.com/api/v2/salary?title=AI+Engineer&country=Canada" \
-H "Authorization: Bearer YOUR_API_KEY"

## Query Parameters

The endpoint requires both of the following parameters to execute data mapping operations safely:

title (required) - The specific job position framework to query (e.g., "3D Artist", "DevOps Engineer").
country (required) - The targeted geographic country name framework (e.g., "United States", "Germany").

## Response Fields

FieldTypeDescriptionmedianintegerMedian annual salary.minintegerEstimated minimum annual salary.maxintegerEstimated maximum annual salary.salary_tiersobjectJunior, middle and senior salary ranges.skillsobjectCore, trending and emerging skills.benefitsobjectCommon employee benefits.market_trendsobjectDemand, growth rate and remote work insights.

## API Features

* Bearer Token authentication
* Automatic response caching
* Free repeated requests for unchanged data
* Per-user API wallet
* IP address whitelisting
* Request logging
* Automatic low balance notifications
* API key expiration support
* JSON REST API
* HTTPS only

## JSON Response Schema

Every response includes salary ranges, percentile distributions, income brackets, required skills, education level, labor market indicators, and regional metadata.

{
"success": true,
"request_cost": 0.109,
"job_title": "Verified official occupation string mapping",
"country": "Sanitized destination country container",
"currency": "ISO 4217 currency code standard alignment",
"median": "Median annual gross salary",
"min": "Minimum estimated annual salary",
"max": "Maximum estimated annual salary",
"confidence": "Statistical accuracy weight percentage (0.00 - 1.00)",
"hourly_rate_min": "Estimated minimum hourly rate",
"hourly_rate_max": "Estimated maximum hourly rate",
"updated_at": "Last update date (ISO 8601)",
"salary_tiers": {
"junior": { "range": "Annual span", "experience": "Years baseline" },
"middle": { "range": "Annual span", "experience": "Years baseline" },
"senior": { "range": "Annual span", "experience": "Years baseline" }
},
"earnings_breakdown": {
"tax_rate": "Approximate country localized general tax deduction index",
"estimated_take_home_pay_monthly": "Net liquid monthly income computation",
"annual_bonus_min": "Performance payout minimal expectation profile",
"annual_bonus_max": "Performance payout maximum expectation profile",
"equity_stock_bonus_max": "Estimated capital options investment incentives"
},
"financial_planning": {
"monthly_savings_target": "Recommended percentage wealth accumulation target",
"retirement_contribution_target": "Long-term legacy retirement allocation fund",
"maximum_housing_budget_monthly": "Suggested upper safety threshold for rent/mortgage",
"emergency_safety_net_min": "3-month liquidity survival target cushion",
"emergency_safety_net_max": "6-month liquidity survival target cushion"
},
"healthcare": {
"infrastructure_type": "Healthcare system type",
"estimated_annual_cost": "Average private premium index incurred (if applicable)"
},
"skills": {
"core": ["High-priority industrial requirements"],
"trending": ["Trending skills"],
"emerging": ["Emerging skills"]
},
"specifics": {
"work_environment": "Distributed corporate layout infrastructure",
"tools": ["Primary cloud/local software engineering systems applications"],
"collaboration": "Asynchronous operational workflow structures",
"time_zones": "Localized overlap demands"
},
"benefits": {
"common": ["Standard insurance, workspace, hardware provisions"],
"additional": ["Remote-first lifestyle subventions, perks, additional employee benefits"]
},
"market_trends": {
"demand": "Current hiring demand",
"growth_rate": "Estimated annual growth rate",
"remote_work": { "availability": "Ratio index", "trend": "Velocity", "platforms": [] },
"key_industries": ["Primary industrial sectors hosting active vacancies"]
}
}

## Interactive API Playground

Try the API with sample requests and inspect the JSON response before integrating it into your application. Some response fields are masked in the public demo.

Job Title *   Target Country *   Send Request

GET https://jobicy.com/api/v2/salary

{
"status": "No request has been sent yet"
}

## Error Codes

HTTPDescription200Request completed successfully or returned an application-level error.401Invalid API key.429Rate limit exceeded.Missing ParametersThe title or country parameter was not provided.Insufficient BalanceYour API wallet balance is too low.IP RestrictedYour current IP address is not whitelisted.Expired KeyYour API key has expired or was revoked.

## Data Coverage

* 20+ supported countries
* Thousands of job titles
* Salary ranges
* Hourly rates
* Experience levels
* Estimated bonuses
* Tax estimates
* Take-home pay
* Financial planning metrics
* Healthcare information
* Required skills
* Benefits
* Remote work availability
* Market demand indicators

## Pricing

OperationPriceSuccessful lookup$0.109Repeated request (unchanged data within 30 days)FreeRepeated requests are automatically free when the underlying salary data has not changed.

## Rate Limits

* Maximum 10 requests per second per API key.
* Rate limiting is enforced automatically.
* Requests exceeding the limit return HTTP 429.
* Repeated requests may be served from cache when available.

## Common Use Cases

* Salary comparison websites
* Job boards
* HR software
* ATS platforms
* AI career assistants
* Recruitment marketplaces
* Compensation benchmarking
* Internal HR dashboards
* Career planning applications
* Workforce analytics

## Frequently Asked Questions

#### How often is salary data updated?

Salary data is refreshed regularly as new market information becomes available.

#### Do repeated requests cost money?

No. Identical requests are free for up to 30 days when the underlying salary data has not changed.

#### What authentication method is used?

The API uses Bearer Token authentication over HTTPS.

#### Can I use the API commercially?

Yes. The Salary API is designed for commercial applications, SaaS products, HR platforms, and recruiting software.

#### Which countries are supported?

The API currently supports more than 20 countries, with additional markets added over time.

#### What format does the API return?

All responses are returned as UTF-8 encoded JSON.