100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
Steam logoSteam API

Steam 스토어 가격과 게임 데이터 API

SocialCrawl API 키로 Steam 스토어를 검색하고 게임별 가격, 할인, 개발사, 장르, 메타크리틱 점수, 추천 수를 구조화 JSON으로 가져옵니다. 호출은 크레딧으로 과금됩니다.

Steam logo
/v1/steam

활성 엔드포인트는 2개입니다. 스토어 검색과 앱 상세를 지원합니다.

  • GET /v1/steam/search
  • GET /v1/steam/app

Steam 엔드포인트

공개 Steam 스토어를 읽는 엔드포인트는 2개입니다. 제목으로 검색한 뒤 원하는 국가의 스토어와 언어로 앱 하나를 전체 정보로 읽습니다.

스토어 검색

1 크레딧
/v1/steam/search

게임이나 소프트웨어 제목에 맞는 Steam 스토어 결과를 Steam 순위대로 최대 10개 반환합니다. 결과마다 앱 id, 이름, 스토어 링크, 캡슐 이미지, 스토어 통화 기준 가격이 포함되며 할인 중이면 할인 전 가격도 포함됩니다. Steam이 표시하는 경우 항목 유형, 메타크리틱 점수, 지원 플랫폼도 포함됩니다. 표준 티어(1 크레딧)입니다.

query, country, language

앱 상세

1 크레딧
/v1/steam/app

숫자 앱 id로 앱 하나를 반환합니다. 이름, 짧은 설명과 전체 설명, 헤더 이미지와 스크린샷, 가격과 할인, 구매 가능 여부, 기능 카테고리, 개발사, 퍼블리셔, 장르, 출시일, 연령 등급, 지원 플랫폼, 메타크리틱 점수, 추천 수와 도전 과제 수, 웹사이트, 지원 언어가 포함됩니다. country와 language로 스토어와 텍스트 언어를 고릅니다. Steam에 없는 앱 id는 404로 응답하며 과금되지 않습니다. 표준 티어(1 크레딧)입니다.

app_id, country, language

Steam API2개 엔드포인트 지원
문서 보기
Store

게임이나 소프트웨어 제목으로 Steam 스토어 검색 결과를 최대 10개 반환하며, 각 항목의 앱 id, 이름, 링크, 이미지, 현재 가격을 포함합니다.

steam/app을 호출하기 전에 게임의 앱 id를 찾거나 여러 제목의 가격을 비교할 때 사용하세요.

1크레딧

GET/v1/steam/search?query=portal

query · Game or software title, 1 to 200 characters, for example portal.

$ curl https://www.socialcrawl.dev/v1/steam/search?query=portal \
    -H "x-api-key: sc_YOUR_API_KEY"
대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

Steam API 동작

Steam도 다른 SocialCrawl 데이터 엔드포인트와 같습니다. API 키로 GET /v1/steam/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Steam 계정이나 파트너 권한은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.

GET과 쿼리 파라미터

검색은 query를 받고 앱 상세는 app_id를 받습니다. 두 경로 모두 country(두 글자 국가 코드)와 language(Steam 언어 이름)를 받습니다. 과금 전에 형식을 검증합니다.

크레딧 과금

Steam의 모든 경로는 1 크레딧입니다. 캐시 히트는 0입니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.

연동 순서

대부분 제품은 앱 id를 한 번 찾은 뒤 추적이 필요할 때마다 앱 상세를 읽습니다.

01스토어 검색
GET /v1/steam/search?query=…

앱 id와 가격이 있는 ProductList

앱 id는 모든 스토어 링크에 있는 숫자이므로 제목마다 한 번만 찾으면 됩니다.

02앱 읽기
GET /v1/steam/app?app_id=…

가격, 할인, 장르, 메타크리틱이 있는 Product

country로 다른 스토어의 가격과 통화를, language로 텍스트 언어를 고릅니다.

요청
GET /v1/steam/search?query=portal
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

GET /v1/steam/app?app_id=620&country=GB
응답 봉투
{
  "success": true,
  "data": {
    "product": {
      "id": "620",
      "title": "Portal 2",
      "brand": "Valve",
      "price": {
        "current": 9.99,
        "original": null,
        "currency": "USD"
      },
      "availability": "Available",
      "ext": {
        "steam": {
          "type": "game",
          "genres": ["Action", "Adventure"],
          "release_date": "Apr 18, 2011",
          "metacritic_score": 95,
          "recommendations": 393264
        }
      }
    }
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

아키타입이 맞는 범위에서 필드 이름은 SocialCrawl 나머지와 같습니다. 한 번 파싱해 여러 플랫폼에 재사용합니다.

ProductListsearch

items[]에 id(앱 id), title, url, image_urls, price, ext.steam의 type, metascore, platforms

Productapp

description, brand(첫 번째 개발사), features, availability, ext.steam의 developers, publishers, genres, release_date, metacritic_score, recommendations

게이트웨이 내부

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Steam은 사이드카가 아닙니다.

  1. 01

    엣지가 호출을 받음

    Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.

  2. 02

    검증 후 차감

    레지스트리에서 steam 경로를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 읽기를 시작하기 전에 티어 비용을 원자적으로 차감합니다.

  3. 03

    캐시 또는 수집

    platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 공개 데이터를 실시간으로 읽으며 5xx나 네트워크 오류는 재시도하고 소스가 불안정하면 서킷 브레이커를 사용합니다.

  4. 04

    정규화 후 반환

    Steam 데이터를 Product와 ProductList 아키타입으로 매핑하고 Steam 전용 정보를 product.ext.steam에 담아 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.

운영에서 중요한 과금 규칙

  • search, app: 1 크레딧
  • 캐시 히트: 0 크레딧
  • 빈 응답 / 하드 실패: 자동 환불
  • 잘못된 파라미터: 400, 과금 없음
  • 크레딧 부족: 402, 과금 없음
  • 없는 앱 id: 404, 과금 없음
  • 검색은 최대 10개 결과의 한 페이지
  • 가격은 선택한 스토어의 통화 기준
  • 구매, 찜 목록, 계정 데이터 없음

Steam 데이터 수집 방식

Steam 스토어 데이터는 공개 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 벤더 SDK를 배울 필요가 없습니다.

이 API에서 Steam의 의미

공개 Steam 스토어입니다. 게임, DLC, 소프트웨어, 사운드트랙의 검색 결과와 앱 페이지를 원하는 국가의 스토어와 언어로 읽습니다.

SocialCrawl 수집 경로

공개 스토어 데이터를 요청 시점에 읽어 서버에서 정규화합니다. Steam 로그인이나 파트너 연동을 직접 운영할 필요가 없습니다.

엣지에서 나가는 형태

검색은 ProductList, 앱 하나는 Product로 공통 커머스 형태입니다. Steam 전용 정보는 product.ext.steam에 담깁니다.

라이브로 제공하지 않는 것

구매, 찜 목록, 사용자 라이브러리, 리뷰 본문, 계정 데이터는 제공하지 않습니다.

필드 매핑
Steam store item→ product.*앱 id, 이름, 스토어 링크, 이미지
price and discount→ product.price / ext.steam.discount_percent현재 가격, 할인 전 가격, 통화, 할인율
developers, genres, Metacritic→ product.ext.steam개발사, 퍼블리셔, 장르, 출시일, 메타크리틱, 추천 수

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

2active Steam endpoints in the registry
1Steam 전 경로의 호출당 크레딧

게임 가격 추적, 할인 모니터링, 카탈로그 조사

호출은 제목의 앱 id를 한 번 찾은 뒤 관심 있는 스토어에서 앱 상세를 주기적으로 읽는 흐름입니다. 국가별 통화의 스토어 가격, 할인, 장르, 메타크리틱, 추천 수를 같은 키로 호출하며 공통 Product 스키마로 받습니다.

라이브 미스는 요청 시점에 공개 스토어를 읽습니다. 반복 호출은 캐시에서 0 크레딧으로 응답합니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

지역별 가격 추적

Python, 예약 작업

시장마다 country를 지정해 app을 호출하고 관심 타이틀의 스토어별 가격과 통화를 기록합니다.

할인 알림

Node, 웹훅

app을 주기적으로 호출해 할인이 시작되는 시점의 할인 전 가격과 할인율을 확인합니다.

카탈로그 조사

Python, notebooks

제목으로 search를 호출한 뒤 app으로 게임 목록의 장르, 개발사, 출시일, 메타크리틱 점수, 추천 수를 수집합니다.

Steam API 호출 방법

Steam의 모든 경로는 1 크레딧입니다. 캐시 히트는 무료입니다.

curl "https://www.socialcrawl.dev/v1/steam/search?query=portal" \
  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/steam/app?app_id=620&country=GB" \
  -H "x-api-key: sc_your_api_key_here"
Steam logoSocialCrawl의 Steam

카탈로그 전 구간과 같은 키

엔드포인트

Steam API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

자주 묻는 질문

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기
SocialCrawl 스팀 API는 무엇을 제공하나요?
엔드포인트 2종(Search and App)으로 스팀 스토어 검색과 앱별 가격, 할인, 개발사, 장르, 메타크리틱 점수, 추천 수를 받아요. 다른 94개 플랫폼과 같은 통합 JSON으로 와요.
스팀 계정이나 Web API 키가 필요한가요?
아니요. SocialCrawl API 키 하나로 호출하니 스팀 로그인이나 파트너 신청, 키 관리가 필요 없어요.
다른 국가의 스팀 가격도 받을 수 있나요?
네, country에 GB나 DE 같은 두 글자 국가 코드를 넣으면 그 스토어의 통화와 할인으로 가격이 와요.
스팀 할인 정보도 받을 수 있나요?
네, 할인 중이면 product.price.original에 할인 전 가격이, product.ext.steam.discount_percent에 할인율이 와요.
스팀 API는 크레딧이 얼마나 드나요?
스팀의 두 경로 모두 호출당 1 크레딧이고 캐시 히트는 무료예요. 새 계정은 카드 없이 무료 100 크레딧을 받아요.
Steam 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Steam 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Steam 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Steam 스크래핑 API와 공식 Steam API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Steam 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

Steam API 레퍼런스 문서 보기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요