Salary API for Global Compensation Data

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.

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

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.

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

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

Error Codes

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

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.