API pública para desarrolladores
Una API JSON gratuita de solo lectura con precios de objetos de CS2, tasación de inventarios de Steam, equipos y jugadores profesionales. Funciona sin clave ni registro, CORS abierto, precios en dólares estadounidenses actualizados más o menos cada hora. Una clave gratuita desde tu perfil sube los límites.
Endpoints
La tabla se genera a partir del documento OpenAPI; las descripciones están en inglés. Los parámetros marcados con * son obligatorios.
| Endpoint | Devuelve | Parámetros |
|---|---|---|
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* |
Límites
Sin clave, los límites se cuentan por dirección IP; la siguiente sección los compara con los de una clave personal. Los asistentes de IA conocidos, identificados por su User-Agent, tienen su propio nivel:
- Solicitudes por minuto para asistentes de IA conocidos en /api/v1
- 600
- Tasaciones de inventario por hora para asistentes de IA
- 600
- Consultas por minuto de perfiles nunca tasados, compartidas por todos los asistentes de IA
- 8
Por encima del límite la API responde 429, y 503 mientras calcula una tasación nueva; ambas respuestas llevan Retry-After en segundos. Espera ese tiempo y reintenta una vez.
Límites más altos con una clave de API
Todos los endpoints funcionan sin clave. Con una clave personal gratuita los límites se cuentan por clave y no por dirección IP, son más altos, y /api/v1/inventory espera hasta 25 s una tasación nueva en lugar de responder 503.
| Límite | Sin clave | Con clave |
|---|---|---|
| Solicitudes por minuto | 120 | 600 |
| Tasaciones de inventario por hora | 60 | 300 |
| Perfiles nunca tasados por minuto | dentro del límite por hora | 30 |
| Perfiles por llamada a /api/ | 50 | 200 |
Cómo conseguir una clave
- Inicia sesión con Steam y abre la sección «Claves de API» de tu perfil. Ir al perfil
- Las claves están disponibles para cuentas con al menos un día de antigüedad. Puedes tener hasta 3 claves activas, cada una con un nombre que diga para qué sirve.
- La clave se muestra una sola vez, al crearla: guardamos solo su hash. Una clave perdida o filtrada se revoca con un clic y se sustituye por otra.
Cómo enviar la clave
Envía la clave en la cabecera Authorization con el esquema Bearer o en la cabecera X-Api-Key. Las claves solo se leen en /api/v1; no las pongas en código del navegador ni en repositorios públicos.
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"Cabeceras de respuesta y errores
- X-RateLimit-Limit
- solicitudes por minuto permitidas para esta clave
- X-RateLimit-Remaining
- solicitudes que quedan en la ventana actual
- X-RateLimit-Reset
- segundos hasta que se reinicia la ventana
Una clave mal escrita, desconocida o revocada nunca se ignora: la solicitud recibe 401 con WWW-Authenticate en vez de pasar a los límites anónimos. La clave de una cuenta bloqueada recibe 403. Por encima del límite la respuesta es 429 con Retry-After.
Especificación y archivos legibles por máquina
/api/openapi.jsonespecificación OpenAPI 3.1: parámetros, esquemas de respuesta y errores/.well-known/openapi.jsonla misma especificación en la dirección well-known/llms.txtresumen del sitio con patrones de URL y recetas de API para asistentes de IA/llms-full.txttodas las guías de texto en inglés en un solo archivo Markdown/llms-catalog.txttop 500 skins por valor de mercado listado en JSON Lines, actualizado cada hora/.well-known/ai-catalog.jsonmanifiesto de capacidades para agentes de IA- Metodología de dónde salen los precios y cómo se calculan
Licencia
Las guías, los textos editoriales y los datos derivados propios del sitio (estimaciones del pool de drops, RTP de cajas, índices, medianas diarias, tablas de patrones, la recopilación llms-catalog.txt) tienen licencia CC BY 4.0: cita a Skinory con un enlace a la página de origen.
Los datos de equipos y jugadores (/api/v1/teams, /api/v1/players) proceden de Liquipedia y tienen licencia CC BY-SA 4.0: cita a Skinory con un enlace y comparte las adaptaciones con la misma licencia.
El catálogo de objetos (nombres, imágenes, rarezas y colecciones de los archivos del juego mediante el conjunto de datos CSGO-API) y los precios de los mercados son datos de terceros. Este sitio no declara licencia sobre ellos; se aplican las condiciones de las fuentes originales.
Cómo citar
Cita una página como «Skinory — título de la página, URL, fecha de actualización», con la URL canónica y la fecha que muestra la página o, si no la tiene, la fecha de consulta. Da los precios con su moneda y hora: cambian.
Skinory — AK-47 | Redline, https://skinory.io/es/items/ak-47-redline, 2026-09-27