WageAPI
WageAPI provides clean, developer-friendly access to salary, compensation, and pay transparency compliance data sourced from official government statistics — Bureau of Labor Statistics (US), Eurostat SES (EU), Destatis (Germany), INSEE (France), and O*NET. **Salary Benchmarking (US + EU)** - Salary percentiles (p10, p25, median, p75, p90) for 1,400+ US occupations across 500+ metro areas - EU…
WageAPI endpoints
| Method | Endpoint | Description |
|---|---|---|
| Salary | ||
| GET |
compare_salary_v1_salary_compare_get /v1/salary/compare |
Compare salaries for the same job title across up to 10 locations. Locations can mix US metro areas and EU countries/cities. Use this when someone asks 'How do developer salaries… |
| GET |
get_salary_v1_salary_get /v1/salary |
Get salary data for a job title in any location — US metro area or EU country. Use this when someone asks 'What do software developers earn in Berlin?' or 'What is the average… |
| Jobs | ||
| GET |
search_jobs_v1_jobs_search_get /v1/jobs/search |
Fuzzy search across 1,400+ US occupations by job title. Returns SOC codes, descriptions, required skills, education level, and job outlook. Uses 3-tier matching: exact alias,… |
| Trends | ||
| GET |
get_trends_v1_trends_get /v1/trends |
Returns year-over-year median salary data and compound annual growth rate (CAGR) for a job title. Covers up to 6 years of BLS data. Useful for analyzing wage growth and… |
| EU Salary | ||
| GET |
compare_eu_salaries_endpoint_v1_salary_eu_compare_get /v1/salary/eu/compare |
**Deprecated — use GET /v1/salary/compare?locations=DE;FR;NL instead.** Compare mean/median salaries for the same occupation across up to 10 EU countries. Includes gender pay gap… |
| GET |
list_eu_countries_v1_salary_eu_countries_get /v1/salary/eu/countries |
**Deprecated — use the unified /v1/salary endpoint instead.** List all EU/EEA countries with available Eurostat SES salary data, including the latest data year and number of ISCO… |
| GET |
get_eu_salary_endpoint_v1_salary_eu_get /v1/salary/eu |
**Deprecated — use GET /v1/salary?location= instead.** Returns mean/median annual salary in EUR, percentile distribution (p10-p90), gender pay gap, and minimum wage for an EU… |
| Compliance | ||
| GET |
get_requirements_v1_compliance_requirements__country__get /v1/compliance/requirements/{country} |
Get pay transparency requirements for a specific EU country. Requires Pro tier or higher (compliance:read scope). Use this when someone asks 'What are the pay transparency rules… |
| POST |
generate_pay_gap_report_v1_compliance_pay_gap_report_post /v1/compliance/pay-gap-report |
Generate a gender pay gap analysis from company workforce data. Requires Enterprise tier (compliance:report scope). Use this when an HR department needs to calculate their gender… |
| POST |
validate_salary_range_v1_compliance_validate_salary_range_post /v1/compliance/validate-salary-range |
Validate whether a job posting's salary range complies with EU Pay Transparency requirements. Requires Pro tier or higher (compliance:read scope). Use this when an employer asks… |
| GET |
get_salary_bands_v1_compliance_salary_bands__country__get /v1/compliance/salary-bands/{country} |
Get recommended salary bands for a job title in an EU country. Requires Pro tier or higher (compliance:read scope). Use this when an employer asks 'What salary range should I put… |
| Intelligence | ||
| GET |
get_salary_competitiveness_v1_salary_competitiveness_get /v1/salary-competitiveness |
Assess whether a salary offer is competitive for a role and location. Use this when someone asks 'Is €65K competitive for a developer in Berlin?' or when an HR system needs to… |
| GET |
get_best_cities_v1_best_cities_for_get /v1/best-cities-for |
Rank cities or countries by salary-to-cost-of-living ratio for an occupation. Use this when someone asks 'Where should I move as a software developer for the best purchasing… |
| GET |
get_salary_adjusted_v1_salary_adjusted_get /v1/salary-adjusted |
Calculate salary adjusted for cost of living between two locations. Use this when someone asks 'What salary in Berlin equals my $120K in San Francisco?' or 'How does purchasing… |
| Portal | ||
| DELETE |
revoke_key_portal_keys__prefix__delete /portal/keys/{prefix} |
|
| GET |
get_profile_portal_me_get /portal/me |
|
| GET |
get_logs_portal_logs_get /portal/logs |
Query API request logs for the authenticated user's keys. |
| POST |
create_key_portal_keys_post /portal/keys |
|
| GET |
list_keys_portal_keys_get /portal/keys |
|
| GET |
get_usage_portal_usage_get /portal/usage |
|
| PATCH |
update_profile_portal_me_patch /portal/me |
|
| GET |
list_products_portal_products_get /portal/products |
List all available products with tiers, pricing, and metadata. Used by the Console frontend to render billing page dynamically. No authentication required — product info is public. |
| Billing | ||
| POST |
create_checkout_portal_billing_checkout_post /portal/billing/checkout |
Create a Paddle transaction or upgrade existing subscription. |
| GET |
get_management_urls_portal_billing_portal_get /portal/billing/portal |
Get Paddle management URLs for payment update and cancellation. |
| POST |
cancel_subscription_portal_billing_cancel_post /portal/billing/cancel |
Cancel the active subscription for a product at end of billing period. |
| GET |
get_billing_portal_billing_get /portal/billing |
Get current subscription info for a product. |
| Webhooks | ||
| POST |
handle_paddle_webhook_webhooks_paddle_post /webhooks/paddle |
Receive Paddle webhook events. Store-then-process pattern. |
| Other endpoints | ||
| GET |
search_jobs_v1_jobs_search_get /v1/jobs/search |
|
| GET |
compare_salary_v1_salary_compare_get /v1/salary/compare |
|
| GET |
get_salary_v1_salary_get /v1/salary |
|
| GET |
get_trends_v1_trends_get /v1/trends |
|
| GET |
health_health_get /health |
|
| GET |
search_jobs_v1_jobs_search_get /v1/jobs/search |
Fuzzy search across 1,400+ US occupations by job title. Returns SOC codes, descriptions, required skills, education level, and job outlook. Uses 3-tier matching: exact alias,… |
| GET |
get_salary_v1_salary_get /v1/salary |
Returns salary percentiles (p10, p25, median, p75, p90), mean wage, and cost-of-living index for a given job title and optional location. Covers 1,400+ US occupations from BLS… |
| GET |
get_trends_v1_trends_get /v1/trends |
Returns year-over-year median salary data and compound annual growth rate (CAGR) for a job title. Covers up to 6 years of BLS data. Useful for analyzing wage growth and… |
| GET |
compare_salary_v1_salary_compare_get /v1/salary/compare |
Compare median salaries for the same job title across up to 10 US metro areas. Includes cost-of-living adjusted median for purchasing power comparison. Locations are… |
| GET |
health_health_get /health |
|
| GET |
get_trends_v1_trends_get /v1/trends |
|
| GET |
get_salary_v1_salary_get /v1/salary |
|
| GET |
compare_salary_v1_salary_compare_get /v1/salary/compare |
|
| GET |
search_jobs_v1_jobs_search_get /v1/jobs/search |
|
| GET |
search_jobs_v1_jobs_search_get /v1/jobs/search |
|
| GET |
compare_salary_v1_salary_compare_get /v1/salary/compare |
|
| GET |
health_health_get /health |
|
| GET |
get_salary_v1_salary_get /v1/salary |
|
| GET |
get_trends_v1_trends_get /v1/trends |
|
WageAPI pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO Recommended | $29 / month | 10 / second |
|
| ULTRA | $79 / month | 20 / second |
|
| MEGA | $149 / month | 30 / second |
|