API en producción / REST + GraphQL
Documentación REST y GraphQL. Desarrolla a tu manera.
Recursos REST, consultas GraphQL y el esquema tipado de la API de datos de sneakers de KicksAPI, con peticiones de ejemplo en JavaScript y Python.
Cada petición necesita una clave de API. Crea una cuenta, genera una clave de prueba y llama a los endpoints de abajo; las claves de prueba devuelven datos de ejemplo y las claves reales, datos de mercado actuales de los mercados de tu plan.
Autenticación
La API usa un token bearer. Mantén las claves reales en tu servidor y nunca las incluyas en un paquete público de app; en el navegador usa una clave de prueba o una clave restringida por origen.
Authorization: Bearer YOUR_API_KEY
Recursos
GET /v1/productsBusca en el catálogo por nombre, marca o referencia. Paginado con limit (hasta 50) y page.
GET /v1/products/{id}Un producto con su tabla de tallas, enlaces a los marketplaces y el precio solicitado más bajo por mercado. {id} acepta nuestro ID, un slug de StockX o una referencia.
GET /v1/products/{id}/pricesPrecios solicitados por talla para un mercado. Opcionales source (stockx o goat) y size_system (EU, UK, US, US_W o CM).
GET /v1/products/{id}/historyRegistros diarios entre from y to, 90 días por defecto y hasta 366. Builder y Scale.
POST /v1/prices/batchPrecios de hasta 50 productos en un mercado en una sola petición. Scale.
GET /v1/marketsMercados, monedas y fuentes, cuáles incluye tu plan y cuándo se actualizó cada uno. No consume cuota.
GET /v1/meTu plan, sus límites y el consumo del ciclo actual. No consume cuota.
GraphQL: elige tus campos
Consulta un producto y sus precios por mercado a través de un solo endpoint. Selecciona solo los campos que necesita tu interfaz, sobre el mismo modelo de datos que REST.
POST /graphql Content-Type: application/json Authorization: Bearer YOUR_API_KEY
Envía un cuerpo JSON con query y variables. En el ejemplo de abajo, el selector de mercado actualiza las variables y la respuesta de ejemplo. Las pestañas Consulta, Variables y Respuesta pertenecen a la misma petición.
El esquema cubre búsqueda y consulta de productos, precios de mercado e historial de precios. Un documento cuenta como una petición y puede resolver como máximo 50 conjuntos de precios y 5 historiales; por encima, los campos extra devuelven un error query_too_large junto a los datos que caben. Un documento que no se puede analizar o validar no consume cuota.
Ejemplos de código
{
"id": "ka_concept_001",
"name": "KicksAPI Concept 01",
"style_code": "KA-001",
"market": "NL",
"currency": "EUR",
"source": "stockx",
"size_system": "EU",
"observed_at": "2026-09-10T08:00:00Z",
"variants": [
{
"size": "42",
"size_system": "EU",
"asking_price": 189
}
]
}Actualidad y valores ausentes
Guarda tanto la hora de observación de la fuente como el momento en que recibiste la respuesta. Un precio null significa que no hay un precio utilizable. No conviertas valores ausentes en cero ni interpretes un precio solicitado como una venta completada. Una talla puede ser null en un sistema que la marca no usa; todos los sistemas del producto aparecen en sizes.
Metodología de datosGestión de errores
Prepara respuestas para 401 por credenciales inválidas, 402 cuando el saldo no cubre el plan, 403 cuando un mercado o función no está en tu plan, 404 por productos desconocidos, 429 por límites y 503 por indisponibilidad temporal. Cada error lleva un código legible por máquina y un request_id, y las peticiones rechazadas no consumen cuota. Conserva el último registro válido y muestra su antigüedad si falla una actualización.
Con GraphQL, comprueba tanto el estado HTTP como el array errors. Una respuesta puede contener datos parciales y errores. Los ejemplos de integración rechazan respuestas con errores; las apps de producción pueden decidir cómo mostrar resultados parciales utilizables.
KICKS / API
Tu próxima idea. Nuestros datos.
Crea tu cuenta, genera una clave y haz tu primera petición hoy.
