GET /markets/dimensions

현재 조회 가능한 region / category / period 조합 목록. /pulse 호출 전 반드시 먼저 참조.

Last updated: 2026-04-23

사용 가능한 region, category, period 값을 반환합니다. /pulse 호출 전 어떤 조합에 데이터가 있는지 확인할 때 씁니다.

GET https://veacon.io/api/v1/markets/dimensions

인증

X-API-Key 또는 veacon_session 쿠키.

쿼리 파라미터

없음.

응답 200

json
{
  "data": {
    "regions": [
      { "value": "강남권",   "sample_count": 5 },
      { "value": "도심권",   "sample_count": 2 },
      { "value": "서남권",   "sample_count": 1 },
      { "value": "서울기타", "sample_count": 1 },
      { "value": "충청권",   "sample_count": 1 }
    ],
    "categories": [
      { "value": "office", "sample_count": 10 }
    ],
    "periods": [
      { "value": "2026-04", "sample_count": 1 },
      { "value": "2026-03", "sample_count": 4 },
      { "value": "2026-01", "sample_count": 3 },
      { "value": "2025-11", "sample_count": 1 },
      { "value": "2025-10", "sample_count": 1 }
    ]
  },
  "_meta": {
    "service": "veacon",
    "api_version": "v1",
    "generated_at": "2026-04-23T10:00:00Z",
    "total_combinations": 25,
    "auth_method": "api_key",
    "rate_limit": { "limit_per_min": 60, "remaining": 59 }
  }
}

필드 설명

필드설명
value/pulse 의 해당 파라미터에 그대로 사용 가능한 문자열
sample_count이 값을 포함한 조합의 수 (cross-product 아닌 최소 1개 이상 데이터 있는 조합)
_meta.total_combinationsregions × categories × periods — 실제 데이터 있는 조합 수는 이보다 적을 수 있음

사용 예

전형적 흐름:

python
import requests

API_KEY = "veacon_pk_live_..."
H = {"X-API-Key": API_KEY}
BASE = "https://veacon.io/api/v1"

# 1) 가능한 조합 조회
dims = requests.get(f"{BASE}/markets/dimensions", headers=H).json()["data"]

# 2) 각 region × category 조합으로 pulse 호출
for r in dims["regions"]:
    for p in dims["periods"][:3]:  # 최근 3개월만
        res = requests.get(
            f"{BASE}/markets/pulse",
            headers=H,
            params={"region": r["value"], "category": "office", "period": p["value"]},
        )
        if res.status_code == 200:
            print(r["value"], p["value"], res.json()["data"][0]["avg_price"])

쿼터 소진 주의

/dimensions 호출도 월 쿼터에 카운트됩니다 (성공 시). 가능 조합이 자주 바뀌지 않으므로 캐시하여 재사용하는 것을 권장합니다.

권장 캐시 TTL: 6시간 — ETL 이 일 1회 실행되므로 충분.