# SalaryFYI

> Comprehensive salary and compensation reference for job seekers, HR professionals, and employers. Covers salary data by country, city, and job role with cost of living, tax brackets, benefits, interactive calculators, country and role comparisons, glossary, and in-depth guides. 15 languages supported.

## Data Scope
- Countries with average salary, minimum wage, tax structure, and cost of living
- Cities with salary data and cost of living indices
- Job roles with salary ranges across countries
- Salary data — country × role combinations with median, percentiles
- Tax brackets by country with effective rate calculations
- Employee benefits comparison by country
- Country-to-country salary comparisons
- Role-to-role salary comparisons
- Interactive tools: tax calculator, salary converter, cost of living adjuster, take-home pay, worldwide comparison, raise calculator, freelance rate, employer cost
- Compensation glossary with HR and payroll terminology
- In-depth guides on salary negotiation, compensation, relocation

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id).
- `/countries/` — Browse countries with salary data (e.g. `/countries/`)
- `/countries/{slug}/` — Country salary detail (e.g. `/countries/united-states/`)
- `/cities/` — Browse cities (e.g. `/cities/`)
- `/cities/{slug}/` — City salary detail (e.g. `/cities/san-francisco/`)
- `/roles/` — Job roles (e.g. `/roles/`)
- `/roles/{slug}/` — Role salary detail (e.g. `/roles/software-engineer/`)
- `/salary/{country}/{role}/` — Country×role salary (e.g. `/salary/united-states/software-engineer/`)
- `/compare/{slug_a}/vs/{slug_b}/` — Country comparison (e.g. `/compare/united-states/vs/united-kingdom/`)
- `/compare/roles/{slug_a}/vs/{slug_b}/` — Role comparison (e.g. `/compare/roles/software-engineer/vs/data-scientist/`)
- `/tools/` — Interactive tools (e.g. `/tools/`)
- `/tools/tax-calculator/` — Tax calculator (e.g. `/tools/tax-calculator/`)
- `/tools/salary-converter/` — Salary converter (e.g. `/tools/salary-converter/`)
- `/tools/cost-of-living-adjuster/` — Cost of living adjuster (e.g. `/tools/cost-of-living-adjuster/`)
- `/tools/take-home-pay/` — Take-home pay calculator (e.g. `/tools/take-home-pay/`)
- `/tools/salary-worldwide/` — Worldwide salary comparison (e.g. `/tools/salary-worldwide/`)
- `/tools/raise-calculator/` — Raise calculator (e.g. `/tools/raise-calculator/`)
- `/tools/freelance-rate/` — Freelance rate calculator (e.g. `/tools/freelance-rate/`)
- `/tools/employer-cost/` — Employer cost calculator (e.g. `/tools/employer-cost/`)
- `/glossary/` — Compensation glossary (e.g. `/glossary/`)
- `/glossary/{slug}/` — Glossary term detail (e.g. `/glossary/gross-salary/`)
- `/guides/` — In-depth guides (e.g. `/guides/`)
- `/guides/{slug}/` — Guide detail (e.g. `/guides/salary-negotiation-playbook/`)
- `/reports/` — Salary reports (e.g. `/reports/`)
- `/faq/` — FAQ (e.g. `/faq/`)

## Salary Data
- [Countries](https://salaryfyi.com/countries/)
- [Cities](https://salaryfyi.com/cities/)
- [Job Roles](https://salaryfyi.com/roles/)
- [Reports](https://salaryfyi.com/reports/)

## Comparisons
- [US vs UK Salary Comparison](https://salaryfyi.com/compare/united-states/vs/united-kingdom/)
- [Software Engineer vs Data Scientist](https://salaryfyi.com/compare/roles/software-engineer/vs/data-scientist/)

## Interactive Tools
- [Tax Calculator](https://salaryfyi.com/tools/tax-calculator/)
- [Salary Converter](https://salaryfyi.com/tools/salary-converter/)
- [Cost of Living Adjuster](https://salaryfyi.com/tools/cost-of-living-adjuster/)
- [Take-Home Pay](https://salaryfyi.com/tools/take-home-pay/)
- [Worldwide Comparison](https://salaryfyi.com/tools/salary-worldwide/)
- [Raise Calculator](https://salaryfyi.com/tools/raise-calculator/)
- [Freelance Rate](https://salaryfyi.com/tools/freelance-rate/)
- [Employer Cost](https://salaryfyi.com/tools/employer-cost/)

## Learn
- [Glossary](https://salaryfyi.com/glossary/)
- [Guides](https://salaryfyi.com/guides/)
- [FAQ](https://salaryfyi.com/faq/)

## Embed Widget
- [SalaryFYI Widget Docs](https://widget.salaryfyi.com)
- [salaryfyi-embed on npm](https://www.npmjs.com/package/salaryfyi-embed)
- [salaryfyi-embed on GitHub](https://github.com/fyipedia/salaryfyi-embed)

## REST API

Free REST API. No authentication required. JSON responses. CORS enabled.

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/v1/countries/` | Countries with salary data |
| GET | `/api/v1/countries/{slug}/` | Country detail |
| GET | `/api/v1/cities/` | Cities |
| GET | `/api/v1/roles/` | Job roles |
| GET | `/api/v1/salary/` | Salary records |
| GET | `/api/v1/glossary/` | Glossary terms |
| GET | `/api/v1/guides/` | Guide articles |
| GET | `/api/v1/faqs/` | FAQs |
| GET | `/api/v1/stats/` | Site statistics |
| GET | `/api/v1/search/?q={query}` | Search across all content |

```bash
curl -s "https://salaryfyi.com/api/v1/countries/"
```

[API Docs](https://salaryfyi.com/developers/) · [OpenAPI Spec](https://salaryfyi.com/api/v1/openapi.json)

## Developer Tools
- **PyPI**: `pip install salaryfyi` — [salaryfyi](https://pypi.org/project/salaryfyi/) — Salary comparison and tax calculator API client
- **Embed Widget**: [salaryfyi-embed](https://widget.salaryfyi.com)

## Guide FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [CalcFYI](https://calcfyi.com) — 200+ calculators, financial, health, math
- [UnivFYI](https://univfyi.com) — University rankings, programs, admissions
- [BoardGameFYI](https://boardgamefyi.com) — Board games, rules, reviews, recommendations

## Full Index
- [Full content index](https://salaryfyi.com/llms-full.txt)
- [XML Sitemap](https://salaryfyi.com/sitemap.xml)