API de chollos de vuelo
Integra el feed de error fares + chollos verificados de TripCazador en tu producto. REST · JSON · auth Bearer · free tier disponible.
Quick start
# Request
curl -H "Authorization: Bearer TC-XXXX-XXXX" \
"https://tripcazador.com/api/v1/deals?origin=MAD&limit=20"
# Response
{
"deals": [
{
"id": "deal_abc123",
"type": "flight",
"origin": "MAD",
"destination": "TYO",
"city_to": "Tokio",
"price_eur": 469,
"savings_pct": 60,
"airline": "Korean Air",
"date_out": "2026-09-15",
"date_ret": "2026-09-29",
"booking_url": "https://skyscanner.es/...",
"hot_until": "2026-09-13T10:00:00Z"
}
],
"count": 20,
"generated_at": "2026-05-21T14:32:00Z",
"attribution": "Data by TripCazador.com"
}Para conseguir tu API key gratis, envía email a partners@tripcazador.com con asunto “Free API key request” y te respondemos en 24h.
Pricing
Free
Para probar la API o blog personal
- ✓100 requests / día
- ✓Deals últimas 24h
- ✓Sin filtros avanzados
- ✓Attribution requerida en UI
Starter
Para blogs travel medios + agencias pequeñas
- ✓1.000 requests / día
- ✓Deals últimos 7 días
- ✓Filtros origin/destination/region
- ✓Soporte email 48h
- ✓SLA 99% uptime
Pro
Para metabuscadores y agencias media-grandes
- ✓10.000 requests / día
- ✓Deals últimos 30 días
- ✓Filtros completos + sorting
- ✓Webhooks push real-time
- ✓Soporte email 24h
- ✓SLA 99.5% uptime
- ✓Custom rate limit
Enterprise
Para OTAs, aerolíneas, ERPs corporativos
- ✓100.000+ requests / día
- ✓Full data history
- ✓Dedicated webhook channel
- ✓Slack channel dedicado
- ✓SLA 99.9% uptime + uptime credits
- ✓Custom integraciones
- ✓Account manager
Endpoints disponibles
| Método | Endpoint | Descripción | Tier mín |
|---|---|---|---|
| GET | /api/v1/deals | Feed de chollos con filtros | Free |
| GET | /api/v1/deals/{id} | Detalle de deal específico | Free |
| GET | /api/v1/regions | Estadísticas por región | Starter |
| POST | /api/v1/webhooks/register | Suscribir webhook push deals | Pro |
FAQ
¿Qué formato de respuesta usa la API?
REST + JSON. Auth vía Bearer token (formato TC-XXXX-XXXX). Endpoint base: https://tripcazador.com/api/v1/deals. Documentación OpenAPI en https://tripcazador.com/api/v1/openapi.json (próximamente).
¿Puedo cancelar en cualquier momento?
Sí. Sin permanencia. Cancela desde Stripe billing portal o respondiendo a tu email de facturación. Acceso continúa hasta fin de periodo facturado.
¿Hay límite por second además de daily?
Rate limit secundario: 10 req/s en Free, 100 req/s en Starter, 500 req/s en Pro, 2k req/s en Enterprise. Bursts cortos aceptados (1.5×).
¿Cómo recibo updates de nuevos deals en tiempo real?
Plan Pro+: te damos un webhook URL que enviamos POST cada vez que detectamos un error fare nuevo. Signed con HMAC, payload similar al endpoint GET.
¿Puedo cachear los deals en mi backend?
Sí, hasta 5 min de cache (TTL recomendado). Más tiempo y los precios pueden estar desactualizados — Cache-Control header te lo recuerda.
¿Hay SDK o librería oficial?
Aún no — la API es lo suficientemente simple para integrar con fetch/curl. Si necesitas SDK Python/Node/PHP avísanos y priorizamos.
¿Listo para empezar?
Envíanos email y te enviamos tu API key en 24h laborables. Free tier sin tarjeta. Plans paid via Stripe Checkout estándar.