개발자용 공개 API

CS2 아이템 가격, Steam 인벤토리 평가, 프로 팀과 선수 정보를 제공하는 무료 읽기 전용 JSON API입니다. 키나 가입 없이 사용할 수 있고 CORS가 열려 있으며, 가격은 미국 달러 기준으로 약 1시간마다 갱신됩니다. 프로필에서 발급하는 무료 키를 쓰면 제한이 올라갑니다.

엔드포인트

표는 OpenAPI 문서에서 생성되며 설명은 영어입니다. *가 붙은 파라미터는 필수입니다.

엔드포인트	반환 내용	파라미터
GET `/api/v1/inventory`	Appraise a public CS2 Steam inventory	`steam*lang`
GET `/api/v1/inventories`	Stored appraisals of up to 50 Steam inventories in one call (200 with an API key)	`steam*lang`
GET `/api/v1/price`	Find CS2 items by name and get their current prices	`q*lang`
GET `/api/v1/price/history`	Daily price history of one CS2 item	`q*dayslang`
GET `/api/v1/teams`	Top CS2 teams by the official Valve ranking	`region`
GET `/api/v1/teams/{slug}`	Team profile: roster, trophies, current events, recent matches, map stats and rank history	`slug*`
GET `/api/v1/players`	Players of the ranked teams, optionally only those with a public Steam profile	`steamlimit`
GET `/api/v1/players/{slug}`	Player of a ranked team	`slug*`

제한

키가 없으면 제한은 IP 주소 단위로 계산되며, 다음 섹션에서 개인 키의 제한과 비교합니다. User-Agent로 식별되는 알려진 AI 어시스턴트에는 별도 등급이 적용됩니다:

/api/v1에서 알려진 AI 어시스턴트의 분당 요청 수: 600
AI 어시스턴트의 시간당 인벤토리 평가 수: 600
한 번도 평가되지 않은 프로필의 분당 조회 수, 모든 AI 어시스턴트가 공유: 8

제한을 넘으면 API는 429를, 새 평가를 계산하는 동안에는 503을 반환합니다. 두 응답 모두 초 단위 Retry-After가 있으니 그만큼 기다린 뒤 한 번만 다시 시도하세요.

API 키로 더 높은 제한

모든 엔드포인트는 키 없이 작동합니다. 무료 개인 키를 쓰면 제한이 IP 주소가 아닌 키 단위로 계산되고 더 높아지며, /api/v1/inventory는 503을 반환하는 대신 새 평가를 최대 25초 기다립니다.

제한	키 없음	키 사용
분당 요청 수	120	600
시간당 인벤토리 평가 수	60	300
분당 미평가 프로필 조회 수	시간당 제한에 포함	30
/api/v1/inventories 호출당 프로필 수	50	200

키 받는 방법

Steam으로 로그인한 뒤 프로필의 “API 키” 섹션을 여세요. 프로필로 이동
키는 생성된 지 하루 이상 지난 계정에서 만들 수 있습니다. 활성 키는 최대 3개까지 둘 수 있고, 각 키에는 용도를 알려 주는 이름을 붙입니다.
키는 만들 때 한 번만 표시되며, 저희는 해시만 저장합니다. 잃어버리거나 유출된 키는 클릭 한 번으로 폐기하고 새 키로 바꿀 수 있습니다.

키 보내는 방법

키는 Bearer 스킴의 Authorization 헤더나 X-Api-Key 헤더로 보냅니다. 키는 /api/v1에서만 읽힙니다. 브라우저에서 실행되는 코드나 공개 저장소에는 넣지 마세요.

curl -H "Authorization: Bearer $SKINORY_API_KEY" \
  "https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline"

curl -H "X-Api-Key: $SKINORY_API_KEY" \
  "https://skinory.io/api/v1/inventory?steam=76561197960287930"

응답 헤더와 오류

잘못 입력했거나 알 수 없거나 폐기된 키는 절대 무시되지 않습니다. 익명 제한으로 넘어가는 대신 WWW-Authenticate와 함께 401을 받습니다. 차단된 계정의 키는 403을 받습니다. 제한을 넘으면 Retry-After와 함께 429를 받습니다.

명세와 기계 판독 파일

/api/openapi.json OpenAPI 3.1 명세: 파라미터, 응답 스키마, 오류
/.well-known/openapi.json 같은 명세를 well-known 주소에서 제공
/llms.txt AI 어시스턴트를 위한 URL 패턴과 API 레시피가 담긴 사이트 개요
/llms-full.txt 모든 영어 텍스트 가이드를 하나의 Markdown 파일로
/llms-catalog.txt 등록 매물 시장가치 기준 상위 500개 스킨, JSON Lines 형식, 1시간마다 갱신
/.well-known/ai-catalog.json AI 에이전트용 기능 매니페스트
방법론 가격의 출처와 계산 방법

라이선스

가이드, 편집 글, 사이트 자체 파생 데이터(드롭 풀 추정치, 케이스 RTP, 지수, 일별 중앙값, 패턴 표, llms-catalog.txt 모음)는 CC BY 4.0 라이선스입니다. Skinory과 원본 페이지 링크를 표기해 주세요.

팀과 선수 데이터(/api/v1/teams, /api/v1/players)는 Liquipedia에서 가져온 것으로 CC BY-SA 4.0 라이선스입니다. Skinory과 링크를 표기하고 2차 저작물은 같은 라이선스로 공유해 주세요.

아이템 카탈로그(CSGO-API 데이터셋을 통해 게임 파일에서 가져온 이름, 이미지, 등급, 컬렉션)와 마켓 가격은 제3자 데이터입니다. 이 사이트는 여기에 라이선스를 선언하지 않으며, 원출처의 조건이 적용됩니다.

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

인용 방법

페이지는 “Skinory — 페이지 제목, URL, 업데이트 날짜” 형식으로 인용하세요. 정식 URL과 페이지에 표시된 날짜를, 날짜가 없으면 읽은 날짜를 씁니다. 가격은 통화와 시각을 함께 적으세요. 가격은 바뀝니다.

Skinory — AK-47 | Redline, https://skinory.io/ko/items/ak-47-redline, 2026-09-27