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.

1. Create an API key from your API Dashboard.
2. Fund your API wallet.
3. Send your first request using your API key.
4. 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

Field	Type	Description
median	integer	Median annual salary.
min	integer	Estimated minimum annual salary.
max	integer	Estimated maximum annual salary.
salary_tiers	object	Junior, middle and senior salary ranges.
skills	object	Core, trending and emerging skills.
benefits	object	Common employee benefits.
market_trends	object	Demand, 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"]
 }
}

Error Codes

HTTP	Description
200	Request completed successfully or returned an application-level error.
401	Invalid API key.
429	Rate limit exceeded.
400	The title or country parameter was not provided.
402	Your API wallet balance is too low.
403	Your current IP address is not whitelisted.
403	Your 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

Operation	Price
Successful lookup	$0.109
Repeated request (unchanged data within 30 days)	Free

Repeated 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.