Da a los agentes datos públicos de TikTok, Instagram y YouTube a través de Skills

En resumen: este cookbook está dirigido a lectores en fase de implementación que necesitan registros de TikTok, Instagram y YouTube para investigación de creadores o social listening sin construir tres integraciones.

UnifAPI expone datos públicos de TikTok, Instagram y YouTube a través de una superficie MCP y HTTP compartida, con un precio de créditos de $0,001. Esta guía enmarca los primitivos comunes, la paginación y el cálculo de costes para que un agente pueda ejecutar Skills de investigación de creadores y social listening sin una GUI a medida.

La mayoría de los flujos de trabajo de datos públicos de cara al consumidor —monitorización de marca, investigación de creadores, análisis de lanzamiento de producto, detección de tendencias— acaban convergiendo en las mismas tres plataformas: TikTok para el vídeo corto, Instagram para el social visual, YouTube para el formato largo. Construir un feed estable a partir de las tres ha significado históricamente tres contratos con proveedores y tres envelopes distintos. Con UnifAPI es un único servidor MCP y una sola forma para todas.

Qué endpoints necesitas en realidad

Para la mayoría de los flujos de trabajo de agentes, tres primitivos bastan por plataforma: buscar por keyword o hashtag, obtener una sola publicación o vídeo por ID, y listar las publicaciones recientes de un creador. Cualquier otra cosa —comentarios, publicaciones relacionadas, contexto de seguidores— es detalle de apoyo al que el agente puede expandirse una vez que tiene el conjunto principal en mano.

En UnifAPI, esos se mapean a: TikTok — /tiktok/search, /tiktok/videos/{id}, /tiktok/users/{id}/videos. YouTube — /youtube/search, /youtube/videos/{video_id}, /youtube/channels/{channel_id}/videos. Instagram — /instagram/search, /instagram/posts/{shortcode}, /instagram/users/{username}/posts. La nomenclatura está alineada intencionadamente entre plataformas, de modo que el prompt del agente que aprendió una aprendió las tres.

La forma unificada de la solicitud

Cada endpoint HTTP acepta la misma cabecera Authorization: Bearer <key> y devuelve el mismo envelope exterior: { request_id, data, pagination?, billing }. Los campos dentro de data son específicos de cada plataforma (un vídeo de TikTok tiene una lista de hashtags, un vídeo de YouTube tiene metadatos de canal), pero la forma que lo rodea es consistente.

Esa uniformidad importa más de lo que parece. Significa que el bucle de uso de herramientas de tu agente tiene una sola política de reintentos, un solo gestor de paginación, un solo envelope de error, no tres. El conocimiento específico de la plataforma se queda dentro del campo data, donde el modelo puede verlo.

Paginación en tres plataformas

Cada plataforma pagina de forma distinta —TikTok usa un token de cursor, YouTube usa pageToken, Instagram usa end_cursor—. UnifAPI normaliza esas señales en un único objeto { cursor, has_more }. El bucle de tu agente lee el cursor, lo pasa de vuelta como el parámetro de consulta cursor en la siguiente llamada y se detiene cuando has_more pasa a false.

El tamaño de página por defecto es de 20 registros en todas las plataformas. El tope es 50. Para la mayoría de las ejecuciones de agentes, una página basta: el modelo rara vez necesita más que los 20 primeros resultados para tomar una decisión.

Estimar el coste por ejecución de agente

El coste es registros × $0,001. Una ejecución de «monitorizar las menciones de nuestra marca en TikTok esta semana» que extrae 20 resultados de búsqueda y luego se expande para obtener 5 vídeos individuales para sus transcripciones son 25 registros: $0,025. Una ejecución de «investigación de creador sobre esta cuenta» que extrae 50 publicaciones recientes y 10 detalles de vídeos son 60 registros: $0,06.

Una regla aproximada que nos ha servido bien: presupuesta $0,05 por ejecución de agente para flujos de trabajo de investigación típicos, $0,20 para análisis en profundidad. Solo el bono único de 2000 créditos de la primera recarga cubre aproximadamente cuarenta ejecuciones ligeras.

Juntándolo todo

Un agente de extremo a extremo de «encuentra qué es tendencia sobre nosotros esta semana en las tres plataformas» se ve así: llama en paralelo a /tiktok/search, /instagram/search y /youtube/search con la keyword de la marca; recoge los 10 primeros de cada una; para los 3 primeros de cada plataforma, expándete a /tiktok/videos/{id}, /instagram/posts/{shortcode} o /youtube/videos/{video_id} para la transcripción o el pie de foto completos; pasa el conjunto al modelo con un prompt de resumen.

Coste total: 30 registros de búsqueda + 9 consultas de detalle = 45 créditos, $0,045: cada una de las tres consultas de publicaciones de Instagram cobra el mínimo de 3 créditos por llamada publicado en el contrato OpenAPI. Número total de integraciones: una. Ese es el argumento: empieza por una Skill, conecta el servidor MCP en https://mcp.unifapi.com e inicia sesión solo cuando OAuth sea necesario para las llamadas de herramientas y los créditos del espacio de trabajo.

Qué leer a continuación

Ejecuta un agente de precios de KOL con MCP - usa estas plataformas como enriquecimiento de precios de creadores.

Envelope de respuesta unificado - explica cómo las respuestas multiplataforma se mantienen comparables.

Catálogo de API - lista las operaciones de plataforma en vivo.