GitHub
Repositorios, issues, releases y actividad de cualquier cuenta pública de GitHub.
Ver la documentaciónPara qué sirve
Qué problema resuelve
GitHub no es solo una web para ver código: su API REST deja que tu web, tu script o tu agente lean y gestionen repositorios, issues, releases, pull requests y actividad pública (y, con permiso, también lo privado de tu cuenta).
Sirve para automatizar: listar repos de un usuario, crear issues, publicar un release o sincronizar estado sin entrar a mano en github.com.
En la práctica
Qué puedes hacer con ella
- Listar los repositorios públicos de una persona o de una organización.
- Leer issues, pull requests y releases para mostrar estado en otra herramienta.
- Crear o actualizar issues y comentarios con un token (si tienes permiso).
- Consultar cuántas peticiones te quedan con las cabeceras x-ratelimit-*.
- Automatizar CI o bots que reaccionen a eventos del repo (junto con webhooks).
- Trabajar sin token en datos públicos, o con token para más cuota y acciones privadas.
¿Es gratis?
Gratis con límites por hora
La API REST de GitHub es gratuita. Sin autenticar (solo datos públicos) tienes 60 peticiones por hora por IP. Con personal access token, OAuth o GitHub App el límite primario habitual es 5.000 peticiones/hora (hasta 15.000 en contextos de GitHub Enterprise Cloud). Hay límites secundarios antiabuso.
Comprobado el 2026-08-02. Fuente: página oficial de precios o límites
Qué cuenta como una «llamada» o un «request» aquí
En GitHub un request es cada petición HTTP a api.github.com (por ejemplo GET /users/octocat/repos). No son tokens de IA ni créditos de búsqueda: es «una llamada = una respuesta HTTP».
El contador primario se reinicia cada hora. Las cabeceras x-ratelimit-remaining y x-ratelimit-reset te dicen cuánto te queda. Algunos endpoints (p. ej. búsqueda) tienen cupos más estrictos aparte.
Límites y cuotas (API REST)
| Límite | Cuota | Qué significa en la práctica |
|---|---|---|
| Sin autenticar (datos públicos) | 60 / hora por IP | Cada visita a la API desde tu IP cuenta 1. Ideal solo para pruebas sueltas. |
| Autenticado (PAT / OAuth / App) | 5.000 / hora | Con token personal o app autorizada sube el cupo horario. Enterprise Cloud puede llegar a 15.000. |
| GitHub Actions (GITHUB_TOKEN) | 1.000 / hora por repo | En workflows el token del repo tiene su propio techo (más alto en Enterprise Cloud). |
| Límites secundarios | Variables | Demasiadas peticiones concurrentes o a un endpoint puede devolver 403/429 aunque quede cupo primario. |
Coste de usar la API
| Plan | Precio | Para quién | Qué incluye (resumen) |
|---|---|---|---|
| API REST | $0 por request | Cualquiera con acceso a GitHub. | Uso de la API dentro de los rate limits; no hay factura por llamada. |
| Planes de producto GitHub | Free / Team / Enterprise | Repos privados, SSO, etc. | La API sigue sin cobro por request; cambian funciones del producto. |
Uso permitido, comercial y licencia
| Pregunta | Respuesta clara |
|---|---|
| ¿Es software libre la API? | No. GitHub es un servicio comercial. La API forma parte del producto y tiene términos propios. |
| ¿Puedo usarla en un negocio? | Sí, dentro de los Terms of Service y el uso aceptable. No abuses de la API. |
| ¿Hace falta cuenta? | Para datos públicos no es obligatoria (60 req/h). Para más cuota o privados: cuenta + token. |
| ¿Dónde creo el token? | Settings → Developer settings → Personal access tokens (o una GitHub App). Nunca lo publiques. |
Cómo empezar
Listar los repositorios públicos de un usuario.
No hace falta pagar. Para la prueba bastan datos públicos; un token opcional sube la cuota.
Dirección base de las imágenes: https://api.github.com
- 01
Paso 1
Abre la documentación REST: https://docs.github.com/en/rest
- 02
Paso 2
Llama a https://api.github.com/users/octocat/repos con Accept: application/vnd.github+json. Verás un JSON con repos de ejemplo.
- 03
Paso 3
Opcional: crea un personal access token en https://github.com/settings/tokens y envíalo como Authorization: Bearer TU_TOKEN para pasar de 60 a 5.000 peticiones/hora.
- 04
Paso 4
Mira las cabeceras x-ratelimit-remaining y x-ratelimit-reset.
- 05
Paso 5
Si recibes 403 o 429 por rate limit, espera al reset. Detalle: https://docs.github.com/en/rest/using-the-rest-api/rate-limits-for-the-rest-api
Con tu agente
Prompt para integrar la API
Prompt para que tu agente lo deje listo
Pega esto en Cursor, Claude Code, Codex u otro agente de código:
Integra la API REST de GitHub. Docs: https://docs.github.com/en/rest . Límites: https://docs.github.com/en/rest/using-the-rest-api/rate-limits-for-the-rest-api . Base: https://api.github.com . No inventes tokens ni repositorios: pide usuario u organización, credenciales y operación. Usa Accept: application/vnd.github+json y respeta x-ratelimit-*. Sin autenticación son 60 req/h y con token 5.000 req/h. ¿Qué endpoint implementamos primero?Detalle técnico
Acceso, HTTPS y CORS
- 01
Acceso · OAuth
Requiere flujo OAuth: el usuario autoriza tu aplicación antes de leer sus datos.
- 02
HTTPS · Sí
Sirve sobre TLS, así que vale para producción y para páginas ya en HTTPS.
- 03
CORS · Sí
Permite llamarla directamente desde el navegador sin proxy intermedio.