Guía básica para la integración de API
Actualizado hoy
La API de Metricool conecta tus propias herramientas y scripts con Metricool para que puedas exportar datos y crear, programar y gestionar publicaciones desde fuera de la aplicación. Esta guía te acompaña desde la obtención del acceso hasta tu primera llamada a la API.
Antes de empezar
La API está disponible en los planes Advanced y Custom. Los planes Free y Starter no incluyen acceso a la API.
Ve a Configuración de cuenta > API.
Copia tu token de acceso a la API.
Abre la documentación oficial de la API desde el icono de información ℹ️ junto al campo del token o directamente en https://app.metricool.com/resources/apidocs/index.html. También tienes disponible una guía en PDF para descargar: API English PDF.
Autentica cada llamada
Todos los endpoints requieren autenticación con tres valores: tu token en el encabezado X-Mc-Auth, además de userId y blogId como parámetros de la solicitud. Las solicitudes con cuerpo también usan Content-Type: application/json.
X-Mc-Auth: YOUR_API_TOKEN
Content-Type: application/jsonuserId identifica tu cuenta de Metricool y blogId identifica la marca. Puedes consultar ambos en la URL del navegador cuando abras una marca en la aplicación:
https://app.metricool.com/evolution/web?blogId=00000&userId=0000000Para listar todas las marcas que gestionas o que se han compartido contigo, llama a https://app.metricool.com/api/admin/simpleProfiles?userId=YOUR_USER_ID. Cada entrada incluye su blogId. Para ver una explicación paso a paso del ID de la cuenta, consulta Cómo encontrar tu ID de usuario de Metricool.
Crea y programa una publicación
Envía una solicitud POST al endpoint del planificador con la fecha de publicación, el texto de la publicación y al menos una red:
POST https://app.metricool.com/api/v2/scheduler/posts?blogId={blogId}&userId={userId}El cuerpo de la solicitud requiere:
publicationDate: la fecha debe ser futura y tener el formato ISO 8601 con una zona horaria, por ejemplo,
Europe/Madrid.text: el contenido de la publicación.
providers: al menos una red, por ejemplo,
{ "network": "facebook" }.
Ejemplo de cuerpo de solicitud:
{
"publicationDate": {
"dateTime": "2025-07-23T10:00:00",
"timezone": "Europe/Madrid"
},
"text": "Hello! This is a scheduled post test.",
"providers": [
{ "network": "facebook" }
]
}Entre los ajustes opcionales se incluyen draft (establece su valor en true para guardar la publicación como borrador en lugar de programarla), autoPublish, firstCommentText y bloques específicos de cada red, como facebookData, instagramData, twitterData, linkedinData, pinterestData, youtubeData, tiktokData, gmbData, threadsData y blueskyData, para opciones propias de cada red, como el tipo de publicación de Facebook o la publicación automática en Instagram. La referencia completa de parámetros está en los archivos Swagger .yaml y .json enlazados desde la documentación de la API.
Publica automáticamente en varias redes
Establece autoPublish en true para publicar sin ningún paso manual. Si no lo haces, las publicaciones de Instagram y TikTok se envían a tu teléfono como una notificación y tendrás que confirmarlas desde la aplicación nativa.
Una sola solicitud puede publicar el mismo video en varias redes a la vez y reutilizar el mismo texto. Solo los campos específicos de cada red necesitan valores distintos, como el tipo de publicación para Instagram y Facebook, el título para YouTube o la opción de privacidad para TikTok:
{
"publicationDate": { "dateTime": "2026-11-21T10:00:00", "timezone": "Europe/Madrid" },
"text": "Caption with #hashtags",
"providers": [
{ "network": "tiktok" },
{ "network": "instagram" },
{ "network": "facebook" },
{ "network": "youtube" }
],
"media": ["https://your-server.com/video.mp4"],
"saveExternalMediaFiles": true,
"autoPublish": true,
"instagramData": { "type": "REEL" },
"facebookData": { "type": "REEL" },
"youtubeData": { "type": "short", "title": "Video title" },
"tiktokData": { "privacyOption": "PUBLIC_TO_EVERYONE" }
}Si media es una lista de URL y saveExternalMediaFiles está establecido en true, Metricool copia el video durante esa misma solicitud, así que no necesitas llamar antes al endpoint normalize para este proceso.
No hay un tiempo de anticipación mínimo entre la solicitud y la fecha de publicación. Metricool comprueba cada minuto si hay publicaciones pendientes, por lo que una publicación programada para la hora actual suele publicarse en unos minutos.
Cada red establece su propio límite diario de publicaciones por cuenta social, no por cuenta de Metricool ni por marca. Consulta Límites diarios de publicación en redes sociales para conocer los límites actuales.
Qué puedes hacer con las publicaciones programadas
Los endpoints del planificador admiten estas acciones. Todas las rutas son relativas a la URL base https://app.metricool.com/api.
Acción | Método y ruta |
|---|---|
Crear una publicación programada |
|
Listar publicaciones programadas entre dos fechas |
|
Obtener una publicación programada por ID |
|
Actualizar una publicación programada |
|
Editar y actualizar campos seleccionados |
|
Eliminar una publicación programada |
|
Enviar varias publicaciones de una marca a revisión en bloque |
|
Aprobar o rechazar una publicación programada |
|
Obtener la configuración de la marca para enviar una publicación a revisión |
|
Obtener las propiedades de las publicaciones de Instagram de una marca |
|
Comprueba el estado de publicación
Llama a GET /v2/scheduler/posts/{id} para comprobar qué ha ocurrido con una publicación programada. Cada red de la publicación devuelve uno de estos estados:
PENDING: programada, todavía no se ha publicado.
PUBLISHING: la publicación está en curso.
PUBLISHED: publicada. El enlace público está en
publicUrl.ERROR: no se pudo publicar. El motivo está en
detailedStatus.AWAITING_CONFIRMATION (solo TikTok): TikTok aceptó la publicación, pero aún no ha confirmado que se haya publicado.
Una publicación programada sin autoPublish también aparece como PUBLISHED cuando llega a tu teléfono para que la confirmes manualmente, aunque publicUrl permanece vacío hasta que termines la publicación desde la aplicación nativa.
Añade contenido multimedia a una publicación programada
Los enlaces al contenido multimedia deben ser públicos y no caducar: se omiten las URL privadas o temporales y la publicación se programa sin contenido multimedia. Para adjuntar contenido multimedia, prepáralo antes de llamar al endpoint del planificador:
Normaliza la URL del contenido multimedia con una solicitud GET para alojar el archivo en los servidores de Metricool cuando sea necesario:
https://app.metricool.com/api/actions/normalize/image/url?url=<URL_OF_YOUR_MEDIA>Incluye el contenido multimedia en tu publicación mediante su
mediaId:
"media": {
"mediaId": "ID_OF_MEDIA"
}Si la solicitud no incluye el identificador del contenido multimedia, la publicación se programa sin él. Consulta el ejemplo práctico completo en Preguntas frecuentes y errores al usar la API.
Limitaciones de publicación
Cada red social restringe mediante su propia API lo que pueden publicar las herramientas de terceros, por lo que no todas las funciones del planificador están disponibles a través de la API de Metricool. Para consultar la lista de acciones de publicación, Inbox e informes no admitidas en cada red, visita Limitaciones de la API por red social.
Los campos específicos de cada red en el cuerpo de la solicitud también varían según la red. Antes de preparar la solicitud, consulta los archivos Swagger .yaml y .json de la documentación de la API para ver los campos disponibles en cada red.
Implementación de la API
Para exportar datos de Metricool mediante nuestra API a otras plataformas, como Excel, Google Sheets, MySQL y otras, sigue estos pasos generales:
Obtén el token de acceso en Configuración de cuenta > API, tal como se ha descrito anteriormente.
Configura el cliente HTTP: usa una herramienta de integración como Postman o un lenguaje de programación (por ejemplo, Python con requests) y configura el encabezado
X-Mc-Authcon tu token.Envía una solicitud GET al endpoint de los datos que quieras (publicaciones, métricas, informes). Todas las llamadas requieren
userIdyblogId. Usa el inspector del navegador para ver las llamadas que realiza Metricool y sus parámetros, tal como se muestra en Cómo obtener un endpoint en Metricool para realizar llamadas a la API.
Da formato a los datos: las respuestas suelen estar en formato JSON, así que asigna los campos a la estructura que espera la plataforma de destino.
Exporta los datos a la plataforma de destino.
Cada plataforma de destino tiene su propio método de integración, pero el proceso general sigue este esquema.
Documentación
Aquí tienes enlaces a la documentación de las API de las plataformas más utilizadas para gestionar datos:
Supervisa el uso y renueva tu token
En Configuración de cuenta > API puedes consultar el uso actual de la API y el historial de los endpoints utilizados. También puedes obtener estadísticas de uso a través de la API con GET /v2/settings/users/{userId}/api-usage-stats, que acepta los parámetros from, to y aggregation, y devuelve las llamadas realizadas por endpoint.
Si necesitas reemplazar tu token, puedes volver a generarlo desde Configuración de cuenta > API. Al generarlo de nuevo, el token anterior deja de ser válido inmediatamente y todas las integraciones que lo usan dejan de funcionar hasta que lo actualices. Consulta Vuelve a generar tu token de conexión a la API.
Recursos adicionales
Artículos relacionados