Ir al contenido
LosPerris API

Listar clips

JSON

Devuelve clips recientes de un canal en JSON. Sirve para widgets, carruseles en OBS o integraciones web — no es un comando de chat. Para crear clips desde el bot, usa Crear clip.

GEThttps://ttv.losperris.dev/api/dashboard/get-clips
AutenticaciónTodos los endpoints requieren el parámetro apiKey en la query. Obtén la tuya desde el panel.

Límites

Sección titulada «Límites»

Parámetros

Sección titulada «Parámetros»
ParámetroTipoRequeridoDescripción
channelStringSíLogin del canal de Twitch (sin @).
apiKeyStringSíClave de API de tu cuenta.
limitNumberNoCantidad de clips (1–100). Por defecto **20**.

Ejemplo de petición

Sección titulada «Ejemplo de petición»
curl --request GET \
  --url 'https://ttv.losperris.dev/api/dashboard/get-clips?channel=ElGamerX&limit=5&apiKey=TU_API_KEY' \
  --header 'Accept: application/json'
curl -i --request GET \
  --url 'https://ttv.losperris.dev/api/dashboard/get-clips?channel=ElGamerX&limit=5&apiKey=TU_API_KEY' \
  --header 'Accept: application/json'
https://ttv.losperris.dev/api/dashboard/get-clips?channel=ElGamerX&limit=5&apiKey=TU_API_KEY

Respuestas

Sección titulada «Respuestas»
	[{"id": "CuriousGlamorousDogeCoolCat-XYZ","url": "https://clips.twitch.tv/CuriousGlamorousDogeCoolCat-XYZ","embed_url": "https://clips.twitch.tv/embed?clip=CuriousGlamorousDogeCoolCat-XYZ","broadcaster_id": "123456","broadcaster_name": "ElGamerX","creator_id": "789012","creator_name": "FanSuperFiel","video_id": "987654321","game_id": "509658","language": "es","title": "Tremendo headshot en vivo","view_count": 452,"created_at": "2023-10-15T22:15:30Z","thumbnail_url": "https://clips-media-assets2.twitch.tv/XYZ-preview-480x272.jpg","duration": 30.5,"vod_offset": 120}]

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Cache-Control: public, s-maxage=10, stale-while-revalidate
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

[
{
  "id": "CuriousGlamorousDogeCoolCat-XYZ",
  "url": "https://clips.twitch.tv/CuriousGlamorousDogeCoolCat-XYZ",
  "embed_url": "https://clips.twitch.tv/embed?clip=CuriousGlamorousDogeCoolCat-XYZ",
  "broadcaster_id": "123456",
  "broadcaster_name": "ElGamerX",
  "creator_id": "789012",
  "creator_name": "FanSuperFiel",
  "video_id": "987654321",
  "game_id": "509658",
  "language": "es",
  "title": "Tremendo headshot en vivo",
  "view_count": 452,
  "created_at": "2023-10-15T22:15:30Z",
  "thumbnail_url": "https://clips-media-assets2.twitch.tv/XYZ-preview-480x272.jpg",
  "duration": 30.5,
  "vod_offset": 120
}
]
	[]

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Cache-Control: public, s-maxage=10, stale-while-revalidate
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

[]
	{"success": false,"error": {"message": "Error de validación","code": "VALIDATION_ERROR","details": [{ "path": "query.limit", "message": "Number must be less than or equal to 100" }]}}

HTTP/1.1 400
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

{
"success": false,
"error": {
  "message": "Error de validación",
  "code": "VALIDATION_ERROR",
  "details": [{ "path": "query.limit", "message": "Number must be less than or equal to 100" }]
}
}
Error de autenticación. Clave API inválida o expirada. Regenerala o pide ayuda a Ponss 🦆
HTTP/1.1 401 Unauthorized
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

Error de autenticación. Clave API inválida o expirada. Regenerala o pide ayuda a Ponss 🦆
	{ "error": "Cuenta suspendida." }

HTTP/1.1 403 Forbidden
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

{ "error": "Cuenta suspendida." }
Límite de peticiones pesadas excedido (max 10/min).
HTTP/1.1 429 Too Many Requests
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

Límite de peticiones pesadas excedido (max 10/min).
	{"success": false,"error": {"message": "Error recuperando clips.","code": "INTERNAL_ERROR"}}

HTTP/1.1 500
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

{
"success": false,
"error": {
  "message": "Error recuperando clips.",
  "code": "INTERNAL_ERROR"
}
}

Campos principales de cada clip: id, url, embed_url, broadcaster_name, creator_name, title, view_count, created_at, thumbnail_url, duration, video_id, vod_offset.

En el panel (Clips) puedes descargar el MP4 (desde el CDN de Twitch, en el navegador), exportar la galería a CSV y abrir el VOD en el offset del clip.