Salary API for Global Compensation Data

Compensation data beyond a single median.

The Salary API returns structured compensation benchmarks for thousands of job-title and country combinations, together with the context needed to explain and compare those estimates.

Your first response in five steps.

Create a server-side key, normalize the requested title and country, and send a GET request over HTTPS.

1. Create an API key Open the API Dashboard and create a key for the integration.
2. Fund the API wallet Successful current-data lookups are charged to the wallet connected to the key.
3. Load supported values Read the country and position metadata before storing production mappings.
4. Send a GET request Include title, country, and the Bearer token.
5. Cache the result Store the response and its updated_at value instead of repeating requests unnecessarily.

curl -X GET "https://jobicy.com/api/v2/salary?title=ai-engineer&country=ca" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  "https://jobicy.com/api/v2/salary?title=ai-engineer&country=ca",
  {
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
      Accept: "application/json"
    }
  }
);

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const salary = await response.json();
console.log(salary);

Keep the API key on the server.

Every salary lookup requires a Bearer token. Send it in the Authorization header and never expose a production key in browser JavaScript, public repositories, or client-side mobile code.

Authorization: Bearer YOUR_API_KEY

Two required values define a lookup.

Use a supported position and country value. Normalize free-form user input before sending a billable request.

Structured data for display and analysis.

A successful response combines numeric compensation estimates with experience tiers, skills, market information, and freshness metadata.

{
  "success": true,
  "request_cost": 0.109,
  "job_title": "AI Engineer",
  "country": "Canada",
  "currency": "CAD",
  "median": 142000,
  "min": 92000,
  "max": 205000,
  "confidence": 0.95,
  "hourly_rate_min": 44.23,
  "hourly_rate_max": 98.56,
  "updated_at": "2026-06-01",
  "salary_tiers": {
    "junior": {
      "range": [92000, 118000],
      "experience": "0–2 years"
    },
    "middle": {
      "range": [121000, 158000],
      "experience": "2–5 years"
    },
    "senior": {
      "range": [162000, 205000],
      "experience": "5+ years"
    }
  },
  "skills": {
    "core": ["Python", "Machine learning", "Data pipelines"],
    "trending": ["LLM evaluation", "MLOps"],
    "emerging": ["Agent orchestration"]
  },
  "market_trends": {
    "demand": "High",
    "growth_rate": "18% annual growth",
    "remote_work": {
      "availability": "Highly available",
      "trend": "Expanding"
    }
  }
}

Preview the request and response shape.

This browser demo generates a masked sample locally. It does not send an API request, expose a key, or consume wallet balance.

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

{
  "status": "Enter a title and country, then generate a preview"
}

Usage-based access with free unchanged repeats.

Charges apply to successful lookups with current data. Cache responses by normalized title and country to reduce cost and latency.

Global compensation with clear freshness data.

Coverage includes thousands of position mappings across more than twenty countries. Additional markets are added when reliable data becomes available.

Handle validation, authentication, and limits.

Check the HTTP status first, then inspect the JSON response for an application-level result and message.

const retryable = [429, 500, 502, 503, 504];

if (retryable.includes(response.status)) {
  const delay = Math.min(1000 * 2 ** attempt, 30000);
  await new Promise((resolve) => setTimeout(resolve, delay));
}

Built for compensation products and workflows.

Use the response as an input to a transparent product experience, with context and ranges visible wherever a compensation estimate is shown.

Before moving to production.

Authentication, billing, supported mappings, and data freshness at a glance.