salaryfyi 0.1.1

Salary comparison and tax calculator API client — salaryfyi.com

salaryfyi

Python API client for salaryfyi.com -- salary comparison and tax calculator platform covering 36 countries with income tax brackets, purchasing power parity data, and compensation benchmarks. Access salary calculators, country-specific tax information, and compensation guides through a free REST API, CLI, or MCP server for AI assistants.

SalaryFYI provides structured salary and tax data across 36 countries with calculators for net income, tax liability, and cost-of-living comparisons -- built for developers, HR professionals, and job seekers who need accurate compensation reference data.

Compare salaries at salaryfyi.com -- tax calculators, salary benchmarks, and cost-of-living comparisons across 36 countries.

Table of Contents

• Install
• Quick Start
• What You Can Do
  • Tax Calculators by Country
  • Salary Benchmarks and Comparisons
  • Purchasing Power and Cost of Living
• Command-Line Interface
• MCP Server (Claude, Cursor, Windsurf)
• REST API Client
• API Reference
• Learn More About Salaries
• Guide FYI Family
• FYIPedia Developer Tools
• License

Install

pip install salaryfyi              # Core (zero deps)
pip install "salaryfyi[cli]"       # + Command-line interface
pip install "salaryfyi[mcp]"       # + MCP server for AI assistants
pip install "salaryfyi[api]"       # + HTTP client for salaryfyi.com API
pip install "salaryfyi[all]"       # Everything

Quick Start

from salaryfyi.api import SalaryFYI

with SalaryFYI() as api:
    # List available tax calculators
    calculators = api.list_calculators()

    # Get details for a specific country's tax calculator
    us_tax = api.get_calculator("united-states")

    # Browse countries with salary data
    countries = api.list_countries()
    germany = api.get_country("germany")

    # Search across all salary content
    results = api.search("income tax brackets")

What You Can Do

Tax Calculators by Country

Income tax systems vary dramatically across countries. Progressive tax systems (used by most OECD nations) apply increasing rates to higher income brackets, while flat tax systems apply a single rate regardless of income. Some countries also levy social security contributions, solidarity surcharges, and local/state taxes on top of federal income tax.

Country	System	Top Rate	Social Security	Notable Feature
United States	Progressive (7 brackets)	37%	7.65% (FICA)	State taxes vary 0-13.3%
United Kingdom	Progressive (3 bands)	45%	12% (NI)	Personal allowance taper
Germany	Progressive (continuous)	45%	~20%	Solidarity surcharge 5.5%
Japan	Progressive (7 brackets)	45%	~15%	Residence tax ~10%
Singapore	Progressive (9 brackets)	22%	20% (CPF)	No capital gains tax
UAE	Flat	0%	0%	No personal income tax

from salaryfyi.api import SalaryFYI

# Explore tax calculators for specific countries
with SalaryFYI() as api:
    calculator = api.get_calculator("united-states")
    print(calculator["name"])  # US tax calculator details

    # Browse available categories (income tax, social security, etc.)
    categories = api.list_categories()

Learn more: Tax Calculators · Glossary · Guides

Salary Benchmarks and Comparisons

Salary benchmarking compares compensation packages across roles, industries, and geographies. Total compensation includes base salary, bonuses, equity/stock options, benefits, and retirement contributions. The Big Mac Index (published by The Economist) and purchasing power parity (PPP) adjustments help normalize salaries across countries with different cost levels.

Metric	Description	Use Case
Gross Salary	Total compensation before deductions	Job offer comparison
Net Salary	Take-home pay after taxes and social security	Living standard comparison
PPP-Adjusted	Salary adjusted for local purchasing power	Cross-country comparison
Median Salary	50th percentile for a role/industry	Market rate benchmarking
Total Compensation	Base + bonus + equity + benefits	Full package evaluation

from salaryfyi.api import SalaryFYI

# Browse country-level salary and tax data
with SalaryFYI() as api:
    countries = api.list_countries()
    south_korea = api.get_country("south-korea")

    # Access guides on salary negotiation and tax planning
    guides = api.list_guides()
    guide = api.get_guide("salary-negotiation")

Learn more: Browse Countries · Categories · API Docs

Purchasing Power and Cost of Living

Purchasing power parity (PPP) measures how much a basket of goods costs in different countries. A salary of $100,000 in San Francisco has different purchasing power than $100,000 in Bangkok. The PPP conversion factor, published by the World Bank, adjusts nominal salaries to reflect real buying power.

City	Cost Index	$100K USD Equivalent Lifestyle
San Francisco	187	$100,000
New York	173	$108,000
London	141	$133,000
Berlin	107	$175,000
Seoul	107	$175,000
Bangkok	63	$297,000
Mexico City	52	$360,000

from salaryfyi.api import SalaryFYI

# Explore salary FAQs and common questions
with SalaryFYI() as api:
    faqs = api.list_faqs()

    # Search for specific salary topics
    results = api.search("cost of living comparison")

Learn more: Countries · FAQs · Guides

Command-Line Interface

pip install "salaryfyi[cli]"

# Search for salary data
salaryfyi search "Germany income tax"

# Output is JSON for easy piping
salaryfyi search "tax brackets" | jq '.results[0]'

MCP Server (Claude, Cursor, Windsurf)

Add salary and tax data tools to any AI assistant that supports Model Context Protocol.

pip install "salaryfyi[mcp]"

Add to your claude_desktop_config.json:

{
    "mcpServers": {
        "salaryfyi": {
            "command": "python",
            "args": ["-m", "salaryfyi.mcp_server"]
        }
    }
}

Available tools: search_salaryfyi

REST API Client

from salaryfyi.api import SalaryFYI

with SalaryFYI() as api:
    # List endpoints
    calculators = api.list_calculators()
    categories = api.list_categories()
    countries = api.list_countries()
    guides = api.list_guides()

    # Detail endpoints
    calculator = api.get_calculator("united-kingdom")
    country = api.get_country("japan")

    # Search
    results = api.search("social security")

API Reference

Method	Description
list_calculators(**params)	List all tax calculators
get_calculator(slug)	Get calculator detail
list_categories(**params)	List all categories
get_category(slug)	Get category detail
list_countries(**params)	List all countries
get_country(slug)	Get country detail
list_guides(**params)	List all guides
get_guide(slug)	Get guide detail
list_faqs(**params)	List all FAQs
get_faq(slug)	Get FAQ detail
search(query)	Search across all content

Full API documentation at salaryfyi.com/developers/.

Learn More About Salaries

• Browse: Tax Calculators · Countries · Categories
• Guides: Guides · FAQs
• API: REST API Docs · OpenAPI Spec

Guide FYI Family

Part of the FYIPedia open-source developer tools ecosystem -- life reference guides, calculators, education, and games.

Package	PyPI	Description
calcfyi	PyPI	200+ calculators, financial, health, math -- calcfyi.com
salaryfyi	PyPI	Salary comparison, tax calculators, 36 countries -- salaryfyi.com
univfyi	PyPI	University rankings, programs, admissions -- univfyi.com
boardgamefyi	PyPI	Board games, rules, reviews, recommendations -- boardgamefyi.com

FYIPedia Developer Tools

Package	PyPI	npm	Description
colorfyi	PyPI	npm	Color conversion, WCAG contrast, harmonies -- colorfyi.com
emojifyi	PyPI	npm	Emoji encoding & metadata -- emojifyi.com
symbolfyi	PyPI	npm	Symbol encoding in 11 formats -- symbolfyi.com
unicodefyi	PyPI	npm	Unicode lookup with 17 encodings -- unicodefyi.com
fontfyi	PyPI	npm	Google Fonts metadata & CSS -- fontfyi.com
distancefyi	PyPI	npm	Haversine distance & travel times -- distancefyi.com
timefyi	PyPI	npm	Timezone ops & business hours -- timefyi.com
namefyi	PyPI	npm	Korean romanization & Five Elements -- namefyi.com
unitfyi	PyPI	npm	Unit conversion, 220 units -- unitfyi.com
holidayfyi	PyPI	npm	Holiday dates & Easter calculation -- holidayfyi.com
salaryfyi	PyPI	--	Salary comparison, tax calculators, 36 countries -- salaryfyi.com
cocktailfyi	PyPI	--	Cocktail ABV, calories, flavor -- cocktailfyi.com
fyipedia	PyPI	--	Unified CLI for all FYI tools -- fyipedia.com

License

MIT