Plan Enterprise

API publica v1

Integra las herramientas de TikToLive (Viral Score, ideas de contenido, forecast de ganancias, analisis de competidores, tendencias y Spark Ads) en tus propios sistemas. Las respuestas son JSON y usan la misma logica que la plataforma, incluidos los Academy Points y el progreso de retos.

Autenticacion

Crea una API key en Ajustes → API Keys (requiere Enterprise activo, maximo 5 keys activas). La key completa se muestra una sola vez: guardala en un gestor de secretos. Enviala en cada request:

curl https://tiktolive.com/api/v1/me \
  -H "Authorization: Bearer tkl_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Solo cabecera Authorization: la API ignora cookies de sesion.
Si tu suscripcion Enterprise vence o se cancela, todas tus keys responden 403 hasta renovar.
Nunca expongas la key en codigo de navegador o apps moviles; usala solo desde tu servidor.
Idioma: envia Accept-Language: en para recibir los textos de la IA, los disclaimers y los mensajes de error en ingles; cualquier otro valor (o sin cabecera) responde en espanol. Los campos code no cambian.

Limites

60 solicitudes por minuto por key y 1000 solicitudes por dia por cuenta (compartidas entre keys). GET /api/v1/me no consume cuota diaria.

X-RateLimit-Limit / -Remaining / -Reset	Ventana por minuto de la key (Reset en epoch segundos).
X-RateLimit-Daily-Limit / -Remaining / -Reset	Cuota diaria de la cuenta, compartida por todas sus keys.
Retry-After	Solo en 429: segundos a esperar antes de reintentar.
X-Cache	HIT / MISS / MISS-ENGINE: si el resultado vino de cache.

Endpoints

Base URL: https://tiktolive.com. Los POST reciben Content-Type: application/json.

GET/api/v1/me

Tu cuenta y cuota

Devuelve el plan, el fin del periodo de la suscripcion y la cuota restante. No consume cuota diaria.

Respuesta 200

{
  "plan": "ENTERPRISE",
  "subscription": { "status": "ACTIVE", "currentPeriodEnd": "2026-10-24T00:00:00.000Z" },
  "apiKey": { "id": "clx..." },
  "rateLimit": {
    "perMinute": { "limit": 60, "remaining": 59, "resetAt": "..." },
    "daily": { "limit": 1000, "remaining": 987, "resetAt": "..." }
  }
}

POST/api/v1/viral-score

Viral Score

Analiza un video publico de TikTok y devuelve un puntaje 0-100 con recomendaciones. Cache 6h; agrega ?force=1 para recalcular.

+25 AP por analisis nuevo

Body

{ "url": "https://www.tiktok.com/@usuario/video/1234567890" }

Respuesta 200

{ "score": 78, "breakdown": { ... }, "recommendations": [ ... ] }

POST/api/v1/content-ideas

Content Idea Engine

Genera ideas de contenido. tone: educativo | humor | storytelling | controversial. count: 1-10 (default 5).

+10 AP por generacion

Body

{ "niche": "fitness", "tone": "humor", "count": 3 }

Respuesta 200

{ "ideas": [ { "titulo": "...", "hook": "...", "estructura": "...", "cta": "...", "hashtags": ["#fit"] } ] }

POST/api/v1/earnings-forecast

Earnings Forecaster

Proyeccion de ganancias a 30/60/90 dias en USD (escenarios low/mid/high). Incluye campo disclaimer.

Cuenta para el reto semanal (0 AP)

Body

{ "views": 50000, "niche": "entretenimiento", "growthRate": 0.1 }

Respuesta 200

{
  "projections": {
    "days30": { "low": 120, "mid": 240, "high": 450 },
    "days60": { ... }, "days90": { ... }
  },
  "disclaimer": "Estimacion basada en promedios de mercado..."
}

POST/api/v1/competitor

Competitor Analyzer

Analiza un perfil publico de TikTok. source: "ai" o "estimate" (sin IA). Cache 24h. Incluye disclaimer.

Cuenta para el reto semanal (0 AP)

Body

{ "username": "@creador" }

Respuesta 200

{ "username": "creador", "source": "ai", ..., "disclaimer": "..." }

POST/api/v1/trends

Trend Radar

Tendencias actuales para un nicho. Cache 1h.

Cuenta para el reto semanal (0 AP)

Body

{ "niche": "cocina" }

Respuesta 200

{ "trends": [ { "title": "...", ... } ] }

POST/api/v1/spark-ads

Spark Ads Simulator

Simula una campana. objective: alcance | conversion | seguidores. budget en USD. ?force=1 recalcula la capa IA.

Cuenta para el reto semanal (0 AP)

Body

{ "budget": 100, "niche": "moda", "objective": "alcance" }

Respuesta 200

{
  "estimatedImpressions": { "min": 16667, "max": 50000 },
  "estimatedCPM": { "min": 2, "max": 6 },
  "projectedCTR": 0.015,
  "estimatedClicks": { "min": 250, "max": 750 },
  "disclaimer": "Esta es una simulacion...",
  "ai": { ... }
}

Errores

Todos los errores devuelven { error: { code, message } }.

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0

{ "error": { "code": "RATE_LIMITED", "message": "Demasiadas solicitudes. Espera un momento." } }

HTTP	code	Cuando
400	VALIDATION_ERROR	Body invalido (el mensaje indica el campo).
401	UNAUTHORIZED	Falta la cabecera Authorization: Bearer.
401	INVALID_API_KEY	Key mal formada o inexistente.
401	API_KEY_REVOKED	La key fue revocada (por ti o por soporte).
403	PLAN_REQUIRED	La cuenta ya no tiene Enterprise activo (vencido o cancelado).
403	ACCOUNT_SUSPENDED	La cuenta esta suspendida.
429	RATE_LIMITED	Superaste 60 solicitudes/minuto con esta key. Respeta Retry-After.
429	QUOTA_EXCEEDED	Superaste la cuota diaria de la cuenta (1000/dia).
502	UPSTREAM_ERROR	El proveedor de IA fallo. Reintenta con backoff.
503	AI_NOT_CONFIGURED	La herramienta de IA no esta disponible temporalmente.
503	SERVICE_UNAVAILABLE	Base de datos o rate limiter no disponibles.

Las cifras de ganancias, alcance o crecimiento son estimaciones basadas en promedios de mercado y no constituyen promesas de ingresos. TikToLive no esta afiliado a TikTok ni a ByteDance.

Cargando TikToLive