API công khai cho nhà phát triển

API JSON chỉ đọc miễn phí với giá vật phẩm CS2, định giá kho đồ Steam, các đội và tuyển thủ chuyên nghiệp. Dùng được mà không cần khóa hay đăng ký, CORS mở, giá tính bằng đô la Mỹ và cập nhật khoảng mỗi giờ. Khóa miễn phí từ hồ sơ của bạn sẽ nâng giới hạn.

Endpoint

Bảng được tạo từ tài liệu OpenAPI; phần mô tả bằng tiếng Anh. Tham số có dấu * là bắt buộc.

Endpoint	Trả về	Tham số
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*`

Giới hạn

Không có khóa, giới hạn được tính theo địa chỉ IP; phần tiếp theo so sánh chúng với giới hạn của khóa cá nhân. Các trợ lý AI đã biết, nhận diện qua User-Agent, có mức riêng:

Yêu cầu mỗi phút cho trợ lý AI đã biết trên /api/v1: 600
Lượt định giá kho đồ mỗi giờ cho trợ lý AI: 600
Lượt tra cứu mỗi phút với hồ sơ chưa từng được định giá, dùng chung cho mọi trợ lý AI: 8

Vượt giới hạn, API trả về 429, và 503 khi đang tính một lượt định giá mới; cả hai đều kèm Retry-After tính bằng giây. Hãy đợi chừng đó rồi thử lại một lần.

Giới hạn cao hơn với khóa API

Mọi endpoint đều dùng được mà không cần khóa. Với khóa cá nhân miễn phí, giới hạn được tính theo khóa thay vì theo địa chỉ IP và cao hơn, còn /api/v1/inventory sẽ chờ tối đa 25 giây để có định giá mới thay vì trả về 503.

Giới hạn	Không có khóa	Có khóa
Yêu cầu mỗi phút	120	600
Lượt định giá kho đồ mỗi giờ	60	300
Hồ sơ chưa từng được định giá mỗi phút	tính trong giới hạn theo giờ	30
Hồ sơ mỗi lần gọi /api/v1/inventories	50	200

Cách lấy khóa

Đăng nhập qua Steam và mở mục “Khóa API” trong hồ sơ của bạn. Đến hồ sơ
Khóa dành cho tài khoản đã tạo ít nhất một ngày. Bạn có thể giữ tối đa 3 khóa đang hoạt động, mỗi khóa có một cái tên cho biết dùng để làm gì.
Khóa chỉ hiện một lần, khi tạo: chúng tôi chỉ lưu mã băm (hash) của nó. Khóa bị mất hoặc bị lộ có thể thu hồi bằng một cú nhấp và thay bằng khóa mới.

Cách gửi khóa

Gửi khóa trong header Authorization với scheme Bearer hoặc trong header X-Api-Key. Khóa chỉ được đọc trên /api/v1; đừng đặt khóa trong mã chạy trên trình duyệt hay trong repository công khai.

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"

Header phản hồi và lỗi

Khóa gõ sai, không xác định hoặc đã thu hồi không bao giờ bị bỏ qua: yêu cầu nhận 401 kèm WWW-Authenticate thay vì chuyển về giới hạn ẩn danh. Khóa của tài khoản bị cấm nhận 403. Vượt giới hạn, phản hồi là 429 kèm Retry-After.

Đặc tả và tệp máy đọc được

/api/openapi.json đặc tả OpenAPI 3.1: tham số, lược đồ phản hồi và lỗi
/.well-known/openapi.json cùng đặc tả đó tại địa chỉ well-known
/llms.txt tổng quan trang với mẫu URL và công thức API cho trợ lý AI
/llms-full.txt mọi hướng dẫn dạng văn bản tiếng Anh trong một tệp Markdown
/llms-catalog.txt top 500 skin theo giá trị thị trường niêm yết dạng JSON Lines, cập nhật mỗi giờ
/.well-known/ai-catalog.json bản kê khả năng cho tác tử AI
Phương pháp giá lấy từ đâu và được tính thế nào

Giấy phép

Hướng dẫn, bài biên tập và dữ liệu phái sinh riêng của trang (ước tính drop pool, RTP của hòm, chỉ số, trung vị theo ngày, bảng pattern, tập tổng hợp llms-catalog.txt) được cấp phép CC BY 4.0: ghi nguồn Skinory kèm liên kết đến trang gốc.

Dữ liệu đội và tuyển thủ (/api/v1/teams, /api/v1/players) lấy từ Liquipedia và được cấp phép CC BY-SA 4.0: ghi nguồn Skinory kèm liên kết và chia sẻ bản chuyển thể theo cùng giấy phép.

Danh mục vật phẩm (tên, hình ảnh, độ hiếm và bộ sưu tập từ tệp game qua bộ dữ liệu CSGO-API) và giá trên các chợ là dữ liệu của bên thứ ba. Trang không công bố giấy phép cho chúng; áp dụng điều khoản của nguồn gốc.

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

Cách trích dẫn

Trích dẫn trang theo dạng “Skinory — tiêu đề trang, URL, ngày cập nhật”, dùng URL chuẩn và ngày trang hiển thị, nếu không có thì ngày bạn đọc. Ghi giá kèm đơn vị tiền tệ và thời điểm: giá luôn thay đổi.

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