API
API para desenvolvedores
O mesmo painel que alimenta este site, em JSON limpo. Autentique-se com uma chave Bearer.
Autenticação
Chamadas anônimas permitem avaliação com um limite baixo. Envie uma chave emitida como token Bearer para acesso medido.
curl /api/v1/overview
Resposta ao vivo
Carregando…
Endpoints
GET /api/v1/overview— KPIs de destaque do painel
GET /api/v1/salary?by=seniority|company|job_family|country— mediana salarial por dimensão
GET /api/v1/facets— valores de filtros ao vivo e contagens de linhas
GET /api/v1/explore?country=DE&salaried_only=true&sort=salary_desc— linhas de vagas filtradas
GET /api/v1/explore?as_of=2026-08-05&…— a mesma consulta, reproduzida como o painel era conhecido naquela data — o parâmetro de viagem no tempo (também em /salary)
GET /api/v1/explore.csv?…— mesmos filtros, exportação de amostra CSV
GET /api/v1/insights/comp-mix?by=sector— taxas de menção a equity e bônus por setor ou família de cargos
GET /api/v1/events?type=salary_revised_down&days=30— eventos de mudança derivados — revisões salariais, encerramentos, reaberturas, cada um com URL de origem
GET /api/v1/insights/time-to-fill?by=job_family— distribuição do tempo de vida das vagas (apenas períodos não censurados), por família/país/empresa
GET /api/v1/insights/market-mix?by=seniority— composição da contratação aberta por função, nível ou setor
GET /api/v1/insights/benchmark-series?job_family=Engineering&country=US— histórico de benchmark gravado diariamente para um mercado
GET /api/v1/quality— completude de campos e proveniência do câmbio
GET /api/v1/coverage— registro de cobertura por portal
GET /api/v1/hiring?days=30— série temporal de vagas abertas
GET /api/v1/signals/disclosure?days=30— tendência de divulgação salarial (Total vs UE)
GET /api/v1/signals/movers?days=30— aceleradores / desaceleradores de contratação
GET /api/v1/company/{platform}/{token}— sinais por empresa
Construtor de consultas
Componha uma requisição contra o painel ao vivo e copie-a como curl.
curl …
Dicionário de dados
Semântica dos campos das linhas de vagas. Valores desconhecidos são null — nunca imputados silenciosamente.
| Campo | Tipo | Significado |
|---|---|---|
| salary_min / salary_max | number|null | Limites da faixa declarada pelo empregador na moeda e no período originais. |
| currency | ISO 4217|null | Código ISO 4217 quando determinável a partir da vaga; caso contrário, null. |
| period | year|month|hour | Período de pagamento conforme declarado (ano, mês ou hora). |
| salary_source | stated|none | 'stated' apenas quando o empregador escreveu o valor. Nunca modelado. |
| annual_usd | number|null | Ponto médio anualizado em USD com câmbio de referência datado; null quando a moeda é desconhecida. |
| confidence | 0–1|null | Confiança do extrator determinístico para a faixa declarada. |
| has_equity / has_bonus | 0|1|null | equity / bônus mencionados no trecho de remuneração; null = trecho não avaliado (nunca adivinhado) |
| as_of | date (param) | qualquer consulta explore/salary aceita as_of=YYYY-MM-DD e responde com o conhecimento daquele dia — cite um número e qualquer pessoa poderá reproduzi-lo |
| quality_flags | string[] | Lacunas conhecidas nesta linha, ex.: no_country, no_currency. |
| observed_at | ISO 8601 | Quando este estado exato foi observado pela última vez no portal de origem. |
| first_seen_at | ISO 8601 | Quando a vaga entrou pela primeira vez no painel ao vivo. |
| url | string | URL pública da vaga de origem — cada linha é auditável. |
| fx_as_of | date | Data do snapshot de câmbio usado para a conversão em USD nesta resposta. |
Erros
Todos os erros retornam um corpo JSON com formato estável e código de status apropriado.
{ "error": "explanation", "status": 4xx }
As cotas são aplicadas por chave e por dia UTC. 429 significa que a cota do dia está esgotada.
Versionamento e descontinuação
- Os endpoints v1 são aditivos: novos campos podem aparecer, campos existentes nunca mudam de significado dentro da v1.
- Mudanças incompatíveis são lançadas como /api/v2, com as duas versões servidas em paralelo por pelo menos 90 dias.
- Descontinuações são anunciadas no registro de alterações e nos cabeçalhos de resposta antes da remoção. Registro de alterações →
Point-in-timeSemântica de data de referência para pesquisa reproduzível
Vinculado à fonteURL pública da vaga em cada linha
Declarado vs normalizadoFaixa local original preservada
Cotas explícitasMedição diária determinística por chave