API

개발자 API

이 사이트를 구동하는 것과 동일한 패널을 깔끔한 JSON으로 제공합니다. Bearer 키로 인증하십시오.

익명 호출은 낮은 한도로 평가 용도를 지원합니다. 계량된 액세스를 위해서는 발급받은 키를 Bearer 토큰으로 전달하십시오.

curl /api/v1/overview

불러오는 중…

엔드포인트

GET /api/v1/overview— 패널 핵심 KPI

GET /api/v1/salary?by=seniority|company|job_family|country— 차원별 급여 중앙값

GET /api/v1/facets— 라이브 필터 값과 행 수

GET /api/v1/explore?country=DE&salaried_only=true&sort=salary_desc— 필터링된 공고 행

GET /api/v1/explore?as_of=2026-08-05&…— 동일한 쿼리를 해당 날짜에 알려져 있던 패널 그대로 재현합니다 — 타임트래블 파라미터(/salary에서도 지원)

GET /api/v1/explore.csv?…— 동일 필터의 CSV 샘플 내보내기

GET /api/v1/insights/comp-mix?by=sector— 섹터·직군별 주식 보상 및 보너스 언급률

GET /api/v1/events?type=salary_revised_down&days=30— 도출된 변경 이벤트 — 급여 수정, 마감, 재오픈, 각 건에 출처 URL 포함

GET /api/v1/insights/time-to-fill?by=job_family— 공고 게시 기간 분포(중도절단 없는 구간만), 직군/국가/기업별

GET /api/v1/insights/market-mix?by=seniority— 직군·레벨·섹터별 진행 중 채용 구성

GET /api/v1/insights/benchmark-series?job_family=Engineering&country=US— 단일 시장의 일별 기록 벤치마크 이력

GET /api/v1/quality— 필드 완전성 및 환율 출처

GET /api/v1/coverage— 게시판별 커버리지 레지스트리

GET /api/v1/hiring?days=30— 진행 중 공고 시계열

GET /api/v1/signals/disclosure?days=30— 급여 공개율 추이(전체 vs EU)

GET /api/v1/signals/movers?days=30— 채용 가속 / 감속 기업

GET /api/v1/company/{platform}/{token}— 기업별 시그널

라이브 패널에 대한 요청을 구성하고 curl로 복사하십시오.

curl …

공고 행의 필드 의미입니다. 알 수 없는 값은 null이며 — 조용히 대체 추정되는 일은 결코 없습니다.

필드	타입	의미
salary_min / salary_max	number\|null	원 통화·원 주기 기준 고용주 명시 범위의 상·하한입니다.
currency	ISO 4217\|null	공고에서 판별 가능한 경우 ISO 4217 코드, 그 외에는 null입니다.
period	year\|month\|hour	명시된 급여 주기(연, 월 또는 시간)입니다.
salary_source	stated\|none	'stated'는 고용주가 직접 수치를 기재한 경우에만 부여됩니다. 결코 모델링하지 않습니다.
annual_usd	number\|null	날짜가 명시된 참조 환율로 USD 연 환산한 중간점이며, 통화를 알 수 없으면 null입니다.
confidence	0–1\|null	명시 범위에 대한 결정론적 추출기 신뢰도입니다.
has_equity / has_bonus	0\|1\|null	보상 발췌문의 주식 보상/보너스 언급 여부, null = 발췌문 미평가(결코 추측하지 않음)
as_of	date (param)	모든 explore/salary 쿼리는 as_of=YYYY-MM-DD를 받아 그날의 지식으로 답합니다 — 수치를 인용하면 누구나 재현할 수 있습니다
quality_flags	string[]	이 행의 알려진 공백입니다(예: no_country, no_currency).
observed_at	ISO 8601	이 상태가 소스 게시판에서 마지막으로 관측된 시점입니다.
first_seen_at	ISO 8601	이 공고가 라이브 패널에 처음 들어온 시점입니다.
url	string	공개 출처 공고 URL — 모든 행을 감사할 수 있습니다.
fx_as_of	date	이 응답의 USD 환산에 사용된 환율 스냅샷 날짜입니다.

모든 오류는 안정적인 구조의 JSON 본문과 적절한 상태 코드를 반환합니다.

{ "error": "explanation", "status": 4xx }

쿼터는 키별·UTC 일 단위로 적용됩니다. 429 는 해당 일의 쿼터가 소진되었다는 뜻입니다.

포인트인타임재현 가능한 리서치를 위한 기준일(as-of) 시맨틱스

출처 연결모든 공고 행에 공개 공고 URL

명시 vs 정규화원 현지 통화 범위 보존

명시적 쿼터키별 결정론적 일일 계량