API de mediosAPI

Sube una vez, publica en cualquier lugar

Envía un archivo a la biblioteca de medios y recibe un id. Adjunta ese id a todas las publicaciones que quieras y FoPost lo convierte y lo entrega en el formato que pide cada red. El almacenamiento es privado y limitado al espacio de trabajo.

Consigue tu clave de APILee la documentación
POST /v1/media/upload
curl -X POST "https://api.fopost.com/v1/media/upload?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY" \
  -F "[email protected]"

{
  "data": [
    {
      "id": "e5a1c9d4-...",
      "type": "image",
      "name": "launch.png",
      "url": "https://.../launch.png",
      "preview_url": "https://api.fopost.com/v1/media/e5a1c9d4-.../file",
      "size": 412883
    }
  ]
}

Carga multipart

Imágenes y vídeos de hasta 50 MB, validados por contenido y no solo por extensión.

Reutiliza por id

Una carga, todas las publicaciones que quieras. El archivo nunca se envía dos veces.

Privado por defecto

Los archivos están en almacenamiento privado y solo se sirven a los miembros del espacio de trabajo.

Cargar

Una sola entrada, comprobada al llegar

Todos los archivos siguen el mismo camino: lista de tipos MIME permitidos, comprobación de los bytes reales, tamaño máximo y el almacenamiento gratuito de tu cuenta. Lo que recibes es una fila de la biblioteca con su tipo y tamaño, lista para adjuntar.

Leer la referencia de medios
Adjuntar a una publicación
curl -X POST https://api.fopost.com/v1/posts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "content": [{ "text": "Launch day.", "media": [{ "type": "image", "name": "launch.png", "url": "https://.../launch.png" }] }],
    "accounts": ["4a71d80b-..."]
  }'

Imágenes

PNG, JPEG, GIF y WebP, con tipo y tamaño leídos al subirlos.

Vídeo

MP4 y MOV, con duración y tamaño comprobados según cada red al publicar.

Validados

El contenido real del archivo debe coincidir con su tipo, o la carga se rechaza.

Entregar

El formato correcto para cada red, sin que hagas nada

Las redes no se ponen de acuerdo en relaciones de aspecto, tamaños y códecs. Al publicar, cada adaptador toma el original guardado y sube lo que esa plataforma acepta, así un solo recurso de la biblioteca sirve igual para un carrusel, un hilo y un feed de vídeos cortos.

Ver cómo funciona la entrega
Imágenes de marca organizadas en la biblioteca de medios compartida

Reglas por red

Los límites de tamaño y formato los aplica el adaptador, no tú.

Medios ordenados

El orden en el bloque de contenido es el orden del carrusel.

Errores claros

Un archivo que una red no admite hace fallar esa entrega indicando el motivo, no toda la publicación.

Gestiona

Explora, obtén y reutiliza la biblioteca

Lista la biblioteca con filtros, obtén cualquier recurso con un endpoint de archivos que comprueba la pertenencia al espacio de trabajo en cada solicitud y nunca caduca, y usa el mismo id en todas las publicaciones que quieras. Los recursos de marca, las importaciones y las imágenes generadas llegan a la misma biblioteca.

Empieza a construir
GET /v1/media
curl "https://api.fopost.com/v1/media?workspace_id=9b2f6c1e-...&type=image" \
  -H "X-API-Key: $API_KEY"

# Fetch the file itself
curl -L "https://api.fopost.com/v1/media/e5a1c9d4-.../file" \
  -H "X-API-Key: $API_KEY" -o launch.png

Lista y filtra

Por tipo, origen o rol de marca, con paginación.

URL de archivo estable

/v1/media/:id/file always works for members; no signed links to refresh.

Limitado al espacio de trabajo

Una clave ve la biblioteca de un espacio de trabajo y nada más.

Preguntas sobre API de medios, respondidas

¿Cuál es el límite de tamaño?

50 MB por archivo. Cada red tiene sus propios máximos, que se comprueban al entregar la publicación a esa red.

¿Qué formatos se aceptan?

Los formatos habituales de imagen (PNG, JPEG, GIF, WebP) y vídeo (MP4, MOV). La carga comprueba los bytes reales del archivo, así que un archivo renombrado se rechaza.

¿Puedo adjuntar un id de medio a más de una publicación?

Sí. Para eso sirve la biblioteca. Sube una vez y usa el id en cualquier publicación del espacio de trabajo.

¿Los archivos subidos son públicos?

No. El almacenamiento es privado. El endpoint de archivos comprueba la pertenencia al espacio de trabajo en cada solicitud, y las redes reciben un enlace de corta duración solo al publicar.

¿Cuenta para alguna cuota?

Sí, todas las cuentas incluyen un almacenamiento gratuito, y lo que lo supere se mide por GB al mes con una tarjeta registrada. Cada carga, importación e imagen generada cuenta de la misma forma.

¿Puedo importar desde una URL o una herramienta de diseño?

Sí, las importaciones llegan a la misma biblioteca y llevan una referencia a su origen, así que puedes volver a traer un diseño actualizado en su lugar en vez de subir un archivo nuevo.

Empieza hoy a construir con la API de medios

Empezar es gratis y la API completa está incluida. Crea una clave y haz tu primera llamada en minutos.

Consigue tu clave de API