Referencia API

Fillip API REST: Endpoints y Esquemas

Documentacion completa de solicitudes, parametros y respuestas JSON para todos los endpoints de la Fillip Content API v1. Version: v1. Base URL: api.fillipmx.com/v1. Formato: JSON.

POST /ingest

Ingesta un activo de IP licenciado. Fillip valida el tipo de activo contra el alcance de la licencia declarada antes de procesarlo.

Parametros de solicitud

Campo	Tipo	Requerido	Descripcion
`asset_url`	string	Si	URL HTTPS del activo de media (video, imagen, feed JSON)
`asset_type`	enum	Si	`video_clip`, `image`, `stats_feed`
`ip_property_id`	string	Si	Identificador de la propiedad de IP en tu cuenta
`license_scope`	enum	Si	`social_short_form`, `broadcast_highlight`, `editorial_only`
`metadata`	object	No	Campos adicionales: `match_id`, `event_date`, `tags`

Ejemplo de respuesta

{
  "asset_id": "ast_7xK2mP9qR4",
  "status": "processing",
  "asset_type": "video_clip",
  "ip_property_id": "liga-mx-apertura",
  "license_scope": "social_short_form",
  "estimated_seconds": 18,
  "created_at": "2026-07-09T14:20:00Z"
}

POST /generate

Inicia la generacion de contenido a partir de un activo ingestado. Devuelve un job_id para consultar el estado del trabajo.

Parametros de solicitud

Campo	Tipo	Requerido	Descripcion
`asset_id`	string	Si	ID del activo retornado por `/ingest`
`formats`	array	Si	`vertical_9x16`, `square_1x1`, `landscape_16x9`
`language`	enum	Si	`es` (espanol), `pt` (portugues)
`content_types`	array	No	`highlight_clip`, `stat_story`, `fan_poll`, `quiz_card`
`webhook_url`	string	No	URL donde Fillip notificara cuando el trabajo este completo

Ejemplo de respuesta (completa)

{
  "job_id": "job_9mQ3nW7tA1",
  "status": "complete",
  "pieces_generated": 4,
  "content_urls": [
    "https://cdn.fillipmx.com/out/ast_7xK2mP9qR4/v9x16_es.mp4",
    "https://cdn.fillipmx.com/out/ast_7xK2mP9qR4/sq1x1_es.mp4",
    "https://cdn.fillipmx.com/out/ast_7xK2mP9qR4/story_es.jpg",
    "https://cdn.fillipmx.com/out/ast_7xK2mP9qR4/poll_es.jpg"
  ],
  "generated_at": "2026-07-09T14:22:00Z",
  "expires_at": "2026-08-08T14:22:00Z"
}

POST /distribute

Envia contenido generado a uno o mas conectores de canal configurados. Requiere que los conectores esten activos en el dashboard.

Parametros de solicitud

Campo	Tipo	Requerido	Descripcion
`job_id`	string	Si	ID del trabajo de generacion completado
`channels`	array	Si	IDs de conectores: `instagram`, `tiktok`, `twitter`, `whatsapp_channel`
`schedule_at`	ISO 8601	No	Fecha y hora de publicacion programada. Omitir para publicacion inmediata.

Ejemplo de respuesta

{
  "distribution_id": "dst_3pR8kL2mX6",
  "status": "scheduled",
  "channels": ["instagram", "tiktok"],
  "scheduled_at": "2026-07-09T18:00:00Z"
}

GET /analytics

Consulta metricas de engagement para piezas distribuidas. Los datos se actualizan cada hora. Disponible en planes Growth y Enterprise.

Parametros de query

Parametro	Tipo	Descripcion
`ip_property_id`	string	Filtra por propiedad de IP. Omitir para todas las propiedades.
`from`	ISO 8601	Inicio del rango de fechas (UTC).
`to`	ISO 8601	Fin del rango de fechas (UTC). Por defecto: ahora.
`content_type`	enum	Filtra por tipo: `highlight_clip`, `stat_story`, `fan_poll`, `quiz_card`
`limit`	integer	Maximo de resultados (default 50, max 200).

Ejemplo de respuesta

{
  "period": {
    "from": "2026-06-01T00:00:00Z",
    "to": "2026-07-09T23:59:59Z"
  },
  "summary": {
    "pieces_distributed": 142,
    "total_reach": 284000,
    "avg_engagement_rate": 0.038
  },
  "pieces": [
    {
      "content_url": "https://cdn.fillipmx.com/out/...",
      "content_type": "highlight_clip",
      "channel": "instagram",
      "reach": 4200,
      "engagement_rate": 0.052,
      "distributed_at": "2026-06-14T18:00:00Z"
    }
  ]
}

SDKs en Desarrollo

Los SDKs de JavaScript y Python estan en desarrollo activo. Mientras tanto, todos los endpoints estan disponibles hoy mediante solicitudes curl o cualquier cliente HTTP. Para estar entre los primeros en acceder a los SDKs cuando esten listos, registra tu cuenta.

Registrarse para Acceso Anticipado Inicio Rapido