The Salary API
Anonymised tech-compensation benchmarks as clean JSON: p25/p50/p75/p90 by role family, level, city tier, country and years of experience. Built from real, verified offers — every cohort is k≥12 contributors, so nothing here can re-identify a person.
k≥12 per cohort
CC-BY-4.0
GDPR R26 · DPDP §17 · CCPA
Free tier, no card
Endpoints
GET/api/v1/salary/bands
List cohorts with percentiles. Filter by role_family, level, city_tier, country_code, yoe_bucket; paginate with limit & offset.
curl -H "Authorization: Bearer <key>" \\
"https://gettevos.com/api/v1/salary/bands?role_family=software_eng&country_code=IN&level=senior"
GET/api/v1/salary/benchmark
A single benchmark. Requires role_family, level, country_code (optionally narrow by city_tier, yoe_bucket). Returns the percentile spread + the largest matching cohort.
curl -H "X-Tevos-Key: <key>" \\
"https://gettevos.com/api/v1/salary/benchmark?role_family=data_sci&level=mid&country_code=IN&city_tier=tier-1"
GET/api/v1/salary/meta
Discovery — every queryable dimension value, coverage counts, and the tier table. Start here.
GET/api/v1/salary/openapi.php
OpenAPI 3.0 spec — drop it into Swagger, Redoc, or a codegen.
Plans
| Tier | Daily requests | Auth |
|---|---|---|
| Anonymous | 25 | none (by IP) — for trying it out |
| Free | 250 | bearer key |
| Pro | 10,000 | bearer key |
| Scale | 100,000 | bearer key |
Pass your key as
Want a key? Email [email protected] with your use-case and tier.
Authorization: Bearer <key> or header X-Tevos-Key.
Rate-limit state is returned in X-RateLimit-Limit / -Remaining / -Reset.
Want a key? Email [email protected] with your use-case and tier.