Ir al contenido

Publicaciones

Publica ahora, programa, usa la cola o guarda borradores en una o varias cuentas.

POST/v1/posts

Se publica ahora salvo que envíes scheduledFor, queue: true o draft: true. Cada destino es una cuenta y puede llevar su propio texto, medios y opciones de red (instagram, youtube, tiktok…). Los destinos de TikTok siempre necesitan opciones tiktok.

Cuerpo

  • contentstringobligatorio

    Texto que se publica en los destinos que no llevan el suyo.

    máx. 10.000

  • mediaobject[]

    Imágenes, vídeos o documentos. Súbelos antes con POST /v1/media/upload-url.

    máx. 35 elementos

    media
    • typestringobligatorio

      Valores: image · video · gif · document

    • urlstring (uri)obligatorio
    • altTextstring

      máx. 1000

  • targetsobject[]obligatorio

    máx. 50 elementos

    targets
    • accountIdstringobligatorio

      Una cuenta conectada (GET /v1/accounts).

    • contentstring

      Sustituye el texto del post en esta red.

      máx. 10.000

    • mediaobject[]

      máx. 35 elementos

      media
      • typestringobligatorio

        Valores: image · video · gif · document

      • urlstring (uri)obligatorio
      • altTextstring

        máx. 1000

    • youtubeobject
      youtube
      • titlestring

        Título del vídeo (hasta 100 caracteres).

        máx. 100

      • visibilitystring

        public, unlisted o private.

        Valores: public · unlisted · private

      • madeForKidsboolean

        Marca COPPA. YouTube puede limitar los vídeos que no la indican.

      • categoryIdstring

        Id numérico de categoría de YouTube.

      • playlistIdstring

        Añadirlo a esta lista de reproducción.

        máx. 100

      • tagsstring[]

        Etiquetas (500 caracteres en total).

        máx. 50 elementos

      • firstCommentstring

        Comentario que se publica justo después.

        máx. 10.000

      • thumbnailUrlstring (uri)

        Miniatura personalizada.

      • containsSyntheticMediaboolean

        Contiene contenido realista generado o alterado con IA.

      • notifySubscribersboolean

        false lo sube sin avisar a los suscriptores.

    • tiktokobject
      tiktok
      • privacystringobligatorio

        Quién lo ve: public, friends, followers o private.

        Valores: public · friends · followers · private

      • allowCommentsbooleanobligatorio

        Permitir comentarios.

      • allowDuetboolean

        Permitir dúos.

        Por defecto: false

      • allowStitchboolean

        Permitir stitch.

        Por defecto: false

      • commercialContentstring

        own_brand si promociona tu negocio, paid_partnership si es patrocinado. No con privacidad private.

        Valores: own_brand · paid_partnership

      • autoAddMusicboolean

        Solo fotos: TikTok puede añadir música recomendada.

      • consenttrueobligatorio

        Siempre true: el usuario vio la vista previa y aceptó publicar.

    • instagramobject
      instagram
      • formatstring

        feed, reel o story. Por defecto, las imágenes van al feed y un vídeo es un Reel.

        Valores: feed · reel · story

      • shareToFeedboolean

        Solo Reels: false lo deja fuera de la cuadrícula del perfil.

      • collaboratorsstring[]

        Hasta 3 usuarios de empresa o creador invitados como colaboradores. No en Stories.

        máx. 3 elementos

      • firstCommentstring

        Comentario que se publica justo después. No en Stories.

        máx. 2200

      • coverUrlstring (uri)

        Solo Reels: imagen de portada.

    • facebookobject
      facebook
      • formatstring

        feed, reel o story.

        Valores: feed · reel · story

      • reelTitlestring

        Solo Reels: título aparte del texto.

        máx. 255

      • firstCommentstring

        Comentario que se publica justo después. No en Stories.

        máx. 10.000

    • linkedinobject
      linkedin
      • firstCommentstring

        Comentario que se publica justo después.

        máx. 10.000

      • disableLinkPreviewboolean

        No mostrar la vista previa del enlace.

      • documentTitlestring

        Título de los documentos (PDF).

        máx. 400

    • xobject
      x
      • threadstring[]

        Respuestas del hilo, en orden. El texto del post es el primer tuit.

        máx. 25 elementos

      • replySettingsstring

        Quién puede responder: following, mentionedUsers, subscribers o verified.

        Valores: following · mentionedUsers · subscribers · verified

    • threadsobject
      threads
      • threadstring[]

        Respuestas del hilo, en orden.

        máx. 25 elementos

      • topicTagstring

        Tema de la publicación.

        máx. 50

      • firstCommentstring

        Comentario que se publica justo después.

        máx. 10.000

    • blueskyobject
      bluesky
      • threadstring[]

        Respuestas del hilo, en orden.

        máx. 25 elementos

    • pinterestobject
      pinterest
      • titlestring

        Título del Pin.

        máx. 100

      • linkstring (uri)

        A dónde lleva el Pin.

      • boardIdstring

        Tablero. Por defecto, el elegido al conectar.

        máx. 100

    • googleBusinessobject
      googleBusiness
      • callToActionobject

        Botón de la publicación.

        callToAction
        • typestringobligatorio

          learn_more, book, order, shop, sign_up o call.

          Valores: learn_more · book · order · shop · sign_up · call

        • urlstring (uri)

          A dónde lleva el botón. Obligatorio salvo con call.

    • telegramobject
      telegram
      • parseModestring

        Formato del texto: html o markdown.

        Valores: html · markdown

      • disableLinkPreviewboolean

        No mostrar la vista previa del enlace.

      • silentboolean

        Enviar sin sonido.

      • protectContentboolean

        Impedir reenviarlo o guardarlo.

    • snapchatobject
      snapchat
      • formatstring

        story (desaparece a las 24 h), saved_story (queda en el perfil) o spotlight.

        Valores: story · saved_story · spotlight

    • redditobject
      reddit
      • subredditstring

        Subreddit sin r/.

      • titlestring

        Título del post.

        máx. 300

      • linkstring (uri)

        Lo convierte en un post de enlace.

      • flairIdstring

        Flair del subreddit.

        máx. 100

      • nsfwboolean

        Marcarlo como NSFW.

      • spoilerboolean

        Marcarlo como spoiler.

  • scheduledForstring (date-time)

    Cuándo publicar (ISO 8601 con zona). Sin él se publica ya.

  • timezonestring

    Zona horaria IANA a la que se refiere scheduledFor.

    máx. 64

  • queueboolean

    Tomar el siguiente hueco libre de la cola del perfil.

  • draftboolean

    Guardar sin publicar ni programar.

  • requiresApprovalboolean

    La deja en pending_approval hasta que un propietario o admin la apruebe. Los miembros de un workspace que exige aprobación siempre pasan por aquí.

Respuesta 201

data
  • idstringobligatorio
  • contentstringobligatorio
  • mediaobject[]obligatorio
    media
    • typestringobligatorio

      Valores: image · video · gif · document

    • urlstring (uri)obligatorio
    • altTextstring

      máx. 1000

  • targetsobject[]obligatorio
    targets
    • accountIdstringobligatorio
    • platformstringobligatorio
    • contentstring
    • mediaobject[]
      media
      • typestringobligatorio

        Valores: image · video · gif · document

      • urlstring (uri)obligatorio
      • altTextstring

        máx. 1000

    • statusstringobligatorio

      Valores: pending · published · failed · removed

    • urlstring (uri)

      La publicación en la red, una vez publicada.

    • errorstring
  • statusstringobligatorio

    Valores: draft · pending_approval · scheduled · publishing · published · partial · failed · cancelled

  • scheduledForstring (date-time)
  • approvalobject

    Aparece cuando la publicación ha pasado por revisión.

    approval
    • requestedBystring

      Quién la envió a revisión; no aparece si fue una API key.

    • requestedAtstring (date-time)obligatorio
    • queueboolean

      Al aprobarla, entra en la cola del perfil.

    • decisionstring

      Valores: approved · rejected

    • decidedBystring
    • decidedAtstring (date-time)
    • notestring

      Por qué se rechazó.

  • recyclingobject

    Aparece cuando se activa el reciclado.

    recycling
    • activebooleanobligatorio
    • everyintegerobligatorio

      máx. 9.007.199.254.740.991

    • unitstringobligatorio

      Valores: week · month

    • startAtstring (date-time)
    • maxCopiesinteger

      máx. 9.007.199.254.740.991

    • untilstring (date-time)
    • variationsstring[]
    • timezonestring
    • copiesintegerobligatorio

      Copias creadas hasta ahora.

      máx. 9.007.199.254.740.991

    • nextAtstring (date-time)

      Cuándo sale la siguiente copia; no aparece cuando se ha parado.

    • lastCopyIdstring

      La última copia, que es una publicación propia.

  • recycledFromstring

    En una copia reciclada: la publicación original.

  • createdAtstring (date-time)obligatorio
  • updatedAtstring (date-time)obligatorio
Ventana de terminal
curl -X POST "https://api.usecrier.com/v1/posts" \
-H "Authorization: Bearer $CRIER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Our autumn collection is here 🍂",
"media": [
{
"type": "image",
"url": "https://cdn.acme.com/autumn.jpg"
}
],
"targets": [
{
"accountId": "acc_3k9x2m"
},
{
"accountId": "acc_9z8y7x",
"youtube": {
"title": "Autumn collection"
}
}
],
"scheduledFor": "2026-10-30T09:00:00+01:00"
}'
GET/v1/posts

Las más recientes primero.

Parámetros

  • limitinteger

    máx. 100

Respuesta 200

data []
  • idstringobligatorio
  • contentstringobligatorio
  • mediaobject[]obligatorio
    media
    • typestringobligatorio

      Valores: image · video · gif · document

    • urlstring (uri)obligatorio
    • altTextstring

      máx. 1000

  • targetsobject[]obligatorio
    targets
    • accountIdstringobligatorio
    • platformstringobligatorio
    • contentstring
    • mediaobject[]
      media
      • typestringobligatorio

        Valores: image · video · gif · document

      • urlstring (uri)obligatorio
      • altTextstring

        máx. 1000

    • statusstringobligatorio

      Valores: pending · published · failed · removed

    • urlstring (uri)

      La publicación en la red, una vez publicada.

    • errorstring
  • statusstringobligatorio

    Valores: draft · pending_approval · scheduled · publishing · published · partial · failed · cancelled

  • scheduledForstring (date-time)
  • approvalobject

    Aparece cuando la publicación ha pasado por revisión.

    approval
    • requestedBystring

      Quién la envió a revisión; no aparece si fue una API key.

    • requestedAtstring (date-time)obligatorio
    • queueboolean

      Al aprobarla, entra en la cola del perfil.

    • decisionstring

      Valores: approved · rejected

    • decidedBystring
    • decidedAtstring (date-time)
    • notestring

      Por qué se rechazó.

  • recyclingobject

    Aparece cuando se activa el reciclado.

    recycling
    • activebooleanobligatorio
    • everyintegerobligatorio

      máx. 9.007.199.254.740.991

    • unitstringobligatorio

      Valores: week · month

    • startAtstring (date-time)
    • maxCopiesinteger

      máx. 9.007.199.254.740.991

    • untilstring (date-time)
    • variationsstring[]
    • timezonestring
    • copiesintegerobligatorio

      Copias creadas hasta ahora.

      máx. 9.007.199.254.740.991

    • nextAtstring (date-time)

      Cuándo sale la siguiente copia; no aparece cuando se ha parado.

    • lastCopyIdstring

      La última copia, que es una publicación propia.

  • recycledFromstring

    En una copia reciclada: la publicación original.

  • createdAtstring (date-time)obligatorio
  • updatedAtstring (date-time)obligatorio
Ventana de terminal
curl "https://api.usecrier.com/v1/posts?limit=20" \
-H "Authorization: Bearer $CRIER_API_KEY"
POST/v1/posts/import

Una publicación por fila, hasta 50 filas. Columnas: content, accounts (ids separados por |) o group, schedule_time, timezone, queue, draft, media_urls y las de cada red (mira la guía de importación). Envía antes dryRun: true para comprobar las filas sin publicar.

Cuerpo

  • csvstringobligatorio

    El texto del CSV, con la fila de cabecera primero.

    máx. 1.000.000

  • dryRunboolean

    Comprobar cada fila sin publicar.

Respuesta 200

data
  • totalintegerobligatorio

    máx. 9.007.199.254.740.991

  • validintegerobligatorio

    máx. 9.007.199.254.740.991

  • invalidintegerobligatorio

    máx. 9.007.199.254.740.991

  • dryRunbooleanobligatorio
  • unknownColumnsstring[]obligatorio

    Columnas que no se usaron.

  • rowsobject[]obligatorio
    rows
    • rowintegerobligatorio

      Empieza en 1, sin contar la cabecera.

      máx. 9.007.199.254.740.991

    • okbooleanobligatorio
    • postIdstring
    • errorstring
Ventana de terminal
curl -X POST "https://api.usecrier.com/v1/posts/import" \
-H "Authorization: Bearer $CRIER_API_KEY"
PATCH/v1/posts/{id}

Borradores, programadas, con error y canceladas. Los campos que no envíes se mantienen; targets sustituye la lista entera. draft: false publica un borrador ahora, en scheduledFor o en la cola.

Parámetros

  • idstringobligatorio

Cuerpo

  • contentstring

    Texto que se publica en los destinos que no llevan el suyo.

    máx. 10.000

  • mediaobject[]

    Imágenes, vídeos o documentos. Súbelos antes con POST /v1/media/upload-url.

    máx. 35 elementos

    media
    • typestringobligatorio

      Valores: image · video · gif · document

    • urlstring (uri)obligatorio
    • altTextstring

      máx. 1000

  • targetsobject[]

    máx. 50 elementos

    targets
    • accountIdstringobligatorio

      Una cuenta conectada (GET /v1/accounts).

    • contentstring

      Sustituye el texto del post en esta red.

      máx. 10.000

    • mediaobject[]

      máx. 35 elementos

      media
      • typestringobligatorio

        Valores: image · video · gif · document

      • urlstring (uri)obligatorio
      • altTextstring

        máx. 1000

    • youtubeobject
      youtube
      • titlestring

        Título del vídeo (hasta 100 caracteres).

        máx. 100

      • visibilitystring

        public, unlisted o private.

        Valores: public · unlisted · private

      • madeForKidsboolean

        Marca COPPA. YouTube puede limitar los vídeos que no la indican.

      • categoryIdstring

        Id numérico de categoría de YouTube.

      • playlistIdstring

        Añadirlo a esta lista de reproducción.

        máx. 100

      • tagsstring[]

        Etiquetas (500 caracteres en total).

        máx. 50 elementos

      • firstCommentstring

        Comentario que se publica justo después.

        máx. 10.000

      • thumbnailUrlstring (uri)

        Miniatura personalizada.

      • containsSyntheticMediaboolean

        Contiene contenido realista generado o alterado con IA.

      • notifySubscribersboolean

        false lo sube sin avisar a los suscriptores.

    • tiktokobject
      tiktok
      • privacystringobligatorio

        Quién lo ve: public, friends, followers o private.

        Valores: public · friends · followers · private

      • allowCommentsbooleanobligatorio

        Permitir comentarios.

      • allowDuetboolean

        Permitir dúos.

        Por defecto: false

      • allowStitchboolean

        Permitir stitch.

        Por defecto: false

      • commercialContentstring

        own_brand si promociona tu negocio, paid_partnership si es patrocinado. No con privacidad private.

        Valores: own_brand · paid_partnership

      • autoAddMusicboolean

        Solo fotos: TikTok puede añadir música recomendada.

      • consenttrueobligatorio

        Siempre true: el usuario vio la vista previa y aceptó publicar.

    • instagramobject
      instagram
      • formatstring

        feed, reel o story. Por defecto, las imágenes van al feed y un vídeo es un Reel.

        Valores: feed · reel · story

      • shareToFeedboolean

        Solo Reels: false lo deja fuera de la cuadrícula del perfil.

      • collaboratorsstring[]

        Hasta 3 usuarios de empresa o creador invitados como colaboradores. No en Stories.

        máx. 3 elementos

      • firstCommentstring

        Comentario que se publica justo después. No en Stories.

        máx. 2200

      • coverUrlstring (uri)

        Solo Reels: imagen de portada.

    • facebookobject
      facebook
      • formatstring

        feed, reel o story.

        Valores: feed · reel · story

      • reelTitlestring

        Solo Reels: título aparte del texto.

        máx. 255

      • firstCommentstring

        Comentario que se publica justo después. No en Stories.

        máx. 10.000

    • linkedinobject
      linkedin
      • firstCommentstring

        Comentario que se publica justo después.

        máx. 10.000

      • disableLinkPreviewboolean

        No mostrar la vista previa del enlace.

      • documentTitlestring

        Título de los documentos (PDF).

        máx. 400

    • xobject
      x
      • threadstring[]

        Respuestas del hilo, en orden. El texto del post es el primer tuit.

        máx. 25 elementos

      • replySettingsstring

        Quién puede responder: following, mentionedUsers, subscribers o verified.

        Valores: following · mentionedUsers · subscribers · verified

    • threadsobject
      threads
      • threadstring[]

        Respuestas del hilo, en orden.

        máx. 25 elementos

      • topicTagstring

        Tema de la publicación.

        máx. 50

      • firstCommentstring

        Comentario que se publica justo después.

        máx. 10.000

    • blueskyobject
      bluesky
      • threadstring[]

        Respuestas del hilo, en orden.

        máx. 25 elementos

    • pinterestobject
      pinterest
      • titlestring

        Título del Pin.

        máx. 100

      • linkstring (uri)

        A dónde lleva el Pin.

      • boardIdstring

        Tablero. Por defecto, el elegido al conectar.

        máx. 100

    • googleBusinessobject
      googleBusiness
      • callToActionobject

        Botón de la publicación.

        callToAction
        • typestringobligatorio

          learn_more, book, order, shop, sign_up o call.

          Valores: learn_more · book · order · shop · sign_up · call

        • urlstring (uri)

          A dónde lleva el botón. Obligatorio salvo con call.

    • telegramobject
      telegram
      • parseModestring

        Formato del texto: html o markdown.

        Valores: html · markdown

      • disableLinkPreviewboolean

        No mostrar la vista previa del enlace.

      • silentboolean

        Enviar sin sonido.

      • protectContentboolean

        Impedir reenviarlo o guardarlo.

    • snapchatobject
      snapchat
      • formatstring

        story (desaparece a las 24 h), saved_story (queda en el perfil) o spotlight.

        Valores: story · saved_story · spotlight

    • redditobject
      reddit
      • subredditstring

        Subreddit sin r/.

      • titlestring

        Título del post.

        máx. 300

      • linkstring (uri)

        Lo convierte en un post de enlace.

      • flairIdstring

        Flair del subreddit.

        máx. 100

      • nsfwboolean

        Marcarlo como NSFW.

      • spoilerboolean

        Marcarlo como spoiler.

  • scheduledForstring (date-time)

    Cuándo publicar (ISO 8601 con zona). Sin él se publica ya.

  • timezonestring

    Zona horaria IANA a la que se refiere scheduledFor.

    máx. 64

  • queueboolean

    Tomar el siguiente hueco libre de la cola del perfil.

  • draftboolean

    Guardar sin publicar ni programar.

  • requiresApprovalboolean

    La deja en pending_approval hasta que un propietario o admin la apruebe. Los miembros de un workspace que exige aprobación siempre pasan por aquí.

Respuesta 200

data
  • idstringobligatorio
  • contentstringobligatorio
  • mediaobject[]obligatorio
    media
    • typestringobligatorio

      Valores: image · video · gif · document

    • urlstring (uri)obligatorio
    • altTextstring

      máx. 1000

  • targetsobject[]obligatorio
    targets
    • accountIdstringobligatorio
    • platformstringobligatorio
    • contentstring
    • mediaobject[]
      media
      • typestringobligatorio

        Valores: image · video · gif · document

      • urlstring (uri)obligatorio
      • altTextstring

        máx. 1000

    • statusstringobligatorio

      Valores: pending · published · failed · removed

    • urlstring (uri)

      La publicación en la red, una vez publicada.

    • errorstring
  • statusstringobligatorio

    Valores: draft · pending_approval · scheduled · publishing · published · partial · failed · cancelled

  • scheduledForstring (date-time)
  • approvalobject

    Aparece cuando la publicación ha pasado por revisión.

    approval
    • requestedBystring

      Quién la envió a revisión; no aparece si fue una API key.

    • requestedAtstring (date-time)obligatorio
    • queueboolean

      Al aprobarla, entra en la cola del perfil.

    • decisionstring

      Valores: approved · rejected

    • decidedBystring
    • decidedAtstring (date-time)
    • notestring

      Por qué se rechazó.

  • recyclingobject

    Aparece cuando se activa el reciclado.

    recycling
    • activebooleanobligatorio
    • everyintegerobligatorio

      máx. 9.007.199.254.740.991

    • unitstringobligatorio

      Valores: week · month

    • startAtstring (date-time)
    • maxCopiesinteger

      máx. 9.007.199.254.740.991

    • untilstring (date-time)
    • variationsstring[]
    • timezonestring
    • copiesintegerobligatorio

      Copias creadas hasta ahora.

      máx. 9.007.199.254.740.991

    • nextAtstring (date-time)

      Cuándo sale la siguiente copia; no aparece cuando se ha parado.

    • lastCopyIdstring

      La última copia, que es una publicación propia.

  • recycledFromstring

    En una copia reciclada: la publicación original.

  • createdAtstring (date-time)obligatorio
  • updatedAtstring (date-time)obligatorio
Ventana de terminal
curl -X PATCH "https://api.usecrier.com/v1/posts/pst_7q1w0e" \
-H "Authorization: Bearer $CRIER_API_KEY"
GET/v1/posts/{id}

Parámetros

  • idstringobligatorio

Respuesta 200

data
  • idstringobligatorio
  • contentstringobligatorio
  • mediaobject[]obligatorio
    media
    • typestringobligatorio

      Valores: image · video · gif · document

    • urlstring (uri)obligatorio
    • altTextstring

      máx. 1000

  • targetsobject[]obligatorio
    targets
    • accountIdstringobligatorio
    • platformstringobligatorio
    • contentstring
    • mediaobject[]
      media
      • typestringobligatorio

        Valores: image · video · gif · document

      • urlstring (uri)obligatorio
      • altTextstring

        máx. 1000

    • statusstringobligatorio

      Valores: pending · published · failed · removed

    • urlstring (uri)

      La publicación en la red, una vez publicada.

    • errorstring
  • statusstringobligatorio

    Valores: draft · pending_approval · scheduled · publishing · published · partial · failed · cancelled

  • scheduledForstring (date-time)
  • approvalobject

    Aparece cuando la publicación ha pasado por revisión.

    approval
    • requestedBystring

      Quién la envió a revisión; no aparece si fue una API key.

    • requestedAtstring (date-time)obligatorio
    • queueboolean

      Al aprobarla, entra en la cola del perfil.

    • decisionstring

      Valores: approved · rejected

    • decidedBystring
    • decidedAtstring (date-time)
    • notestring

      Por qué se rechazó.

  • recyclingobject

    Aparece cuando se activa el reciclado.

    recycling
    • activebooleanobligatorio
    • everyintegerobligatorio

      máx. 9.007.199.254.740.991

    • unitstringobligatorio

      Valores: week · month

    • startAtstring (date-time)
    • maxCopiesinteger

      máx. 9.007.199.254.740.991

    • untilstring (date-time)
    • variationsstring[]
    • timezonestring
    • copiesintegerobligatorio

      Copias creadas hasta ahora.

      máx. 9.007.199.254.740.991

    • nextAtstring (date-time)

      Cuándo sale la siguiente copia; no aparece cuando se ha parado.

    • lastCopyIdstring

      La última copia, que es una publicación propia.

  • recycledFromstring

    En una copia reciclada: la publicación original.

  • createdAtstring (date-time)obligatorio
  • updatedAtstring (date-time)obligatorio
Ventana de terminal
curl "https://api.usecrier.com/v1/posts/pst_7q1w0e" \
-H "Authorization: Bearer $CRIER_API_KEY"
DELETE/v1/posts/{id}

La borra de Crier. Si sigue publicada, retírala antes.

Parámetros

  • idstringobligatorio

Respuesta 204

Sin contenido

Ventana de terminal
curl -X DELETE "https://api.usecrier.com/v1/posts/pst_7q1w0e" \
-H "Authorization: Bearer $CRIER_API_KEY"

Editar el texto de una publicación publicada

Sección titulada «Editar el texto de una publicación publicada»
POST/v1/posts/{id}/edit

En X (cuentas Premium, durante la primera hora), Facebook, LinkedIn, YouTube, Pinterest, Google Business, Telegram, Discord y Reddit. Las imágenes y vídeos no cambian.

Parámetros

  • idstringobligatorio

Cuerpo

  • contentstringobligatorio

    El nuevo texto de la publicación.

    máx. 10.000

  • accountIdstring

    Editar solo la copia de esta cuenta; si no, todas las publicadas.

Respuesta 200

data
  • idstringobligatorio
  • contentstringobligatorio
  • mediaobject[]obligatorio
    media
    • typestringobligatorio

      Valores: image · video · gif · document

    • urlstring (uri)obligatorio
    • altTextstring

      máx. 1000

  • targetsobject[]obligatorio
    targets
    • accountIdstringobligatorio
    • platformstringobligatorio
    • contentstring
    • mediaobject[]
      media
      • typestringobligatorio

        Valores: image · video · gif · document

      • urlstring (uri)obligatorio
      • altTextstring

        máx. 1000

    • statusstringobligatorio

      Valores: pending · published · failed · removed

    • urlstring (uri)

      La publicación en la red, una vez publicada.

    • errorstring
  • statusstringobligatorio

    Valores: draft · pending_approval · scheduled · publishing · published · partial · failed · cancelled

  • scheduledForstring (date-time)
  • approvalobject

    Aparece cuando la publicación ha pasado por revisión.

    approval
    • requestedBystring

      Quién la envió a revisión; no aparece si fue una API key.

    • requestedAtstring (date-time)obligatorio
    • queueboolean

      Al aprobarla, entra en la cola del perfil.

    • decisionstring

      Valores: approved · rejected

    • decidedBystring
    • decidedAtstring (date-time)
    • notestring

      Por qué se rechazó.

  • recyclingobject

    Aparece cuando se activa el reciclado.

    recycling
    • activebooleanobligatorio
    • everyintegerobligatorio

      máx. 9.007.199.254.740.991

    • unitstringobligatorio

      Valores: week · month

    • startAtstring (date-time)
    • maxCopiesinteger

      máx. 9.007.199.254.740.991

    • untilstring (date-time)
    • variationsstring[]
    • timezonestring
    • copiesintegerobligatorio

      Copias creadas hasta ahora.

      máx. 9.007.199.254.740.991

    • nextAtstring (date-time)

      Cuándo sale la siguiente copia; no aparece cuando se ha parado.

    • lastCopyIdstring

      La última copia, que es una publicación propia.

  • recycledFromstring

    En una copia reciclada: la publicación original.

  • createdAtstring (date-time)obligatorio
  • updatedAtstring (date-time)obligatorio
Ventana de terminal
curl -X POST "https://api.usecrier.com/v1/posts/pst_7q1w0e/edit" \
-H "Authorization: Bearer $CRIER_API_KEY"
GET/v1/posts/{id}/metrics

Impresiones, alcance, reproducciones, me gusta, comentarios, compartidos, guardados y clics, en total y por cuenta. Cada red da las suyas.

Parámetros

  • idstringobligatorio

Respuesta 200

data
  • totalobjectobligatorio
    total
    • impressionsintegerobligatorio

      máx. 9.007.199.254.740.991

    • reachintegerobligatorio

      máx. 9.007.199.254.740.991

    • viewsintegerobligatorio

      máx. 9.007.199.254.740.991

    • likesintegerobligatorio

      máx. 9.007.199.254.740.991

    • commentsintegerobligatorio

      máx. 9.007.199.254.740.991

    • sharesintegerobligatorio

      máx. 9.007.199.254.740.991

    • savesintegerobligatorio

      máx. 9.007.199.254.740.991

    • clicksintegerobligatorio

      máx. 9.007.199.254.740.991

    • engagementRatenumberobligatorio

      Porcentaje: interacciones sobre impresiones (o alcance).

  • targetsobject[]obligatorio
    targets
    • accountIdstringobligatorio
    • platformstringobligatorio
    • metricsobjectobligatorio
      metrics
      • impressionsintegerobligatorio

        máx. 9.007.199.254.740.991

      • reachintegerobligatorio

        máx. 9.007.199.254.740.991

      • viewsintegerobligatorio

        máx. 9.007.199.254.740.991

      • likesintegerobligatorio

        máx. 9.007.199.254.740.991

      • commentsintegerobligatorio

        máx. 9.007.199.254.740.991

      • sharesintegerobligatorio

        máx. 9.007.199.254.740.991

      • savesintegerobligatorio

        máx. 9.007.199.254.740.991

      • clicksintegerobligatorio

        máx. 9.007.199.254.740.991

      • engagementRatenumberobligatorio

        Porcentaje: interacciones sobre impresiones (o alcance).

  • updatedAtstring (date-time)
Ventana de terminal
curl "https://api.usecrier.com/v1/posts/pst_7q1w0e/metrics" \
-H "Authorization: Bearer $CRIER_API_KEY"

Cancelar una publicación programada, un borrador o una pendiente de aprobación

Sección titulada «Cancelar una publicación programada, un borrador o una pendiente de aprobación»
POST/v1/posts/{id}/cancel

Parámetros

  • idstringobligatorio

Respuesta 200

data
  • idstringobligatorio
  • contentstringobligatorio
  • mediaobject[]obligatorio
    media
    • typestringobligatorio

      Valores: image · video · gif · document

    • urlstring (uri)obligatorio
    • altTextstring

      máx. 1000

  • targetsobject[]obligatorio
    targets
    • accountIdstringobligatorio
    • platformstringobligatorio
    • contentstring
    • mediaobject[]
      media
      • typestringobligatorio

        Valores: image · video · gif · document

      • urlstring (uri)obligatorio
      • altTextstring

        máx. 1000

    • statusstringobligatorio

      Valores: pending · published · failed · removed

    • urlstring (uri)

      La publicación en la red, una vez publicada.

    • errorstring
  • statusstringobligatorio

    Valores: draft · pending_approval · scheduled · publishing · published · partial · failed · cancelled

  • scheduledForstring (date-time)
  • approvalobject

    Aparece cuando la publicación ha pasado por revisión.

    approval
    • requestedBystring

      Quién la envió a revisión; no aparece si fue una API key.

    • requestedAtstring (date-time)obligatorio
    • queueboolean

      Al aprobarla, entra en la cola del perfil.

    • decisionstring

      Valores: approved · rejected

    • decidedBystring
    • decidedAtstring (date-time)
    • notestring

      Por qué se rechazó.

  • recyclingobject

    Aparece cuando se activa el reciclado.

    recycling
    • activebooleanobligatorio
    • everyintegerobligatorio

      máx. 9.007.199.254.740.991

    • unitstringobligatorio

      Valores: week · month

    • startAtstring (date-time)
    • maxCopiesinteger

      máx. 9.007.199.254.740.991

    • untilstring (date-time)
    • variationsstring[]
    • timezonestring
    • copiesintegerobligatorio

      Copias creadas hasta ahora.

      máx. 9.007.199.254.740.991

    • nextAtstring (date-time)

      Cuándo sale la siguiente copia; no aparece cuando se ha parado.

    • lastCopyIdstring

      La última copia, que es una publicación propia.

  • recycledFromstring

    En una copia reciclada: la publicación original.

  • createdAtstring (date-time)obligatorio
  • updatedAtstring (date-time)obligatorio
Ventana de terminal
curl -X POST "https://api.usecrier.com/v1/posts/pst_7q1w0e/cancel" \
-H "Authorization: Bearer $CRIER_API_KEY"
POST/v1/posts/{id}/review

Solo para publicaciones en pending_approval, por propietarios, admins o una API key. Aprobar la programa para su fecha, la mete en la cola si la pidió o la publica ya si su fecha pasó. Rechazar la devuelve a borrador con la nota y envía post.rejected.

Parámetros

  • idstringobligatorio

Cuerpo

  • decisionstringobligatorio

    approve la programa (o la publica ya si su fecha pasó); reject la devuelve a borrador.

    Valores: approve · reject

  • notestring

    El motivo, para quien la escribió. Se muestra con el borrador tras un rechazo.

    máx. 1000

Respuesta 200

data
  • idstringobligatorio
  • contentstringobligatorio
  • mediaobject[]obligatorio
    media
    • typestringobligatorio

      Valores: image · video · gif · document

    • urlstring (uri)obligatorio
    • altTextstring

      máx. 1000

  • targetsobject[]obligatorio
    targets
    • accountIdstringobligatorio
    • platformstringobligatorio
    • contentstring
    • mediaobject[]
      media
      • typestringobligatorio

        Valores: image · video · gif · document

      • urlstring (uri)obligatorio
      • altTextstring

        máx. 1000

    • statusstringobligatorio

      Valores: pending · published · failed · removed

    • urlstring (uri)

      La publicación en la red, una vez publicada.

    • errorstring
  • statusstringobligatorio

    Valores: draft · pending_approval · scheduled · publishing · published · partial · failed · cancelled

  • scheduledForstring (date-time)
  • approvalobject

    Aparece cuando la publicación ha pasado por revisión.

    approval
    • requestedBystring

      Quién la envió a revisión; no aparece si fue una API key.

    • requestedAtstring (date-time)obligatorio
    • queueboolean

      Al aprobarla, entra en la cola del perfil.

    • decisionstring

      Valores: approved · rejected

    • decidedBystring
    • decidedAtstring (date-time)
    • notestring

      Por qué se rechazó.

  • recyclingobject

    Aparece cuando se activa el reciclado.

    recycling
    • activebooleanobligatorio
    • everyintegerobligatorio

      máx. 9.007.199.254.740.991

    • unitstringobligatorio

      Valores: week · month

    • startAtstring (date-time)
    • maxCopiesinteger

      máx. 9.007.199.254.740.991

    • untilstring (date-time)
    • variationsstring[]
    • timezonestring
    • copiesintegerobligatorio

      Copias creadas hasta ahora.

      máx. 9.007.199.254.740.991

    • nextAtstring (date-time)

      Cuándo sale la siguiente copia; no aparece cuando se ha parado.

    • lastCopyIdstring

      La última copia, que es una publicación propia.

  • recycledFromstring

    En una copia reciclada: la publicación original.

  • createdAtstring (date-time)obligatorio
  • updatedAtstring (date-time)obligatorio
Ventana de terminal
curl -X POST "https://api.usecrier.com/v1/posts/pst_7q1w0e/review" \
-H "Authorization: Bearer $CRIER_API_KEY"
PUT/v1/posts/{id}/recycling

La vuelve a publicar cada every semanas o meses como una publicación nueva (recycledFrom apunta a la original), hasta maxCopies o until. Las copias no van a YouTube ni a TikTok, y cada cuenta puede tener hasta 10 publicaciones reciclándose. Enviarlo otra vez cambia la regla y mantiene la cuenta de copias.

Parámetros

  • idstringobligatorio

Cuerpo

  • everyintegerobligatorio

    Cuántas unidades entre copia y copia.

    máx. 52

  • unitstringobligatorio

    week (semana) o month (mes).

    Valores: week · month

  • startAtstring (date-time)

    Cuándo sale la primera copia. Por defecto, un intervalo después de la fecha de la publicación; si es antigua, la siguiente fecha de esa serie, a la misma hora.

  • maxCopiesinteger

    Parar tras este número de copias.

    máx. 100

  • untilstring (date-time)

    Parar después de esta fecha.

  • variationsstring[]

    Textos que se usan por turnos en lugar del de la publicación. El texto propio de un destino sigue mandando. Recomendado en X y Pinterest, que penalizan las repeticiones.

    mín. 2máx. 20 elementos

  • timezonestring

    Zona horaria IANA (por ejemplo Europe/Madrid) en la que se cuenta el intervalo, para que las copias mantengan su hora local cuando cambia la hora. UTC por defecto.

    máx. 64

Respuesta 200

data
  • idstringobligatorio
  • contentstringobligatorio
  • mediaobject[]obligatorio
    media
    • typestringobligatorio

      Valores: image · video · gif · document

    • urlstring (uri)obligatorio
    • altTextstring

      máx. 1000

  • targetsobject[]obligatorio
    targets
    • accountIdstringobligatorio
    • platformstringobligatorio
    • contentstring
    • mediaobject[]
      media
      • typestringobligatorio

        Valores: image · video · gif · document

      • urlstring (uri)obligatorio
      • altTextstring

        máx. 1000

    • statusstringobligatorio

      Valores: pending · published · failed · removed

    • urlstring (uri)

      La publicación en la red, una vez publicada.

    • errorstring
  • statusstringobligatorio

    Valores: draft · pending_approval · scheduled · publishing · published · partial · failed · cancelled

  • scheduledForstring (date-time)
  • approvalobject

    Aparece cuando la publicación ha pasado por revisión.

    approval
    • requestedBystring

      Quién la envió a revisión; no aparece si fue una API key.

    • requestedAtstring (date-time)obligatorio
    • queueboolean

      Al aprobarla, entra en la cola del perfil.

    • decisionstring

      Valores: approved · rejected

    • decidedBystring
    • decidedAtstring (date-time)
    • notestring

      Por qué se rechazó.

  • recyclingobject

    Aparece cuando se activa el reciclado.

    recycling
    • activebooleanobligatorio
    • everyintegerobligatorio

      máx. 9.007.199.254.740.991

    • unitstringobligatorio

      Valores: week · month

    • startAtstring (date-time)
    • maxCopiesinteger

      máx. 9.007.199.254.740.991

    • untilstring (date-time)
    • variationsstring[]
    • timezonestring
    • copiesintegerobligatorio

      Copias creadas hasta ahora.

      máx. 9.007.199.254.740.991

    • nextAtstring (date-time)

      Cuándo sale la siguiente copia; no aparece cuando se ha parado.

    • lastCopyIdstring

      La última copia, que es una publicación propia.

  • recycledFromstring

    En una copia reciclada: la publicación original.

  • createdAtstring (date-time)obligatorio
  • updatedAtstring (date-time)obligatorio
Ventana de terminal
curl -X PUT "https://api.usecrier.com/v1/posts/pst_7q1w0e/recycling" \
-H "Authorization: Bearer $CRIER_API_KEY"
DELETE/v1/posts/{id}/recycling

Las copias ya creadas se quedan como están.

Parámetros

  • idstringobligatorio

Respuesta 200

data
  • idstringobligatorio
  • contentstringobligatorio
  • mediaobject[]obligatorio
    media
    • typestringobligatorio

      Valores: image · video · gif · document

    • urlstring (uri)obligatorio
    • altTextstring

      máx. 1000

  • targetsobject[]obligatorio
    targets
    • accountIdstringobligatorio
    • platformstringobligatorio
    • contentstring
    • mediaobject[]
      media
      • typestringobligatorio

        Valores: image · video · gif · document

      • urlstring (uri)obligatorio
      • altTextstring

        máx. 1000

    • statusstringobligatorio

      Valores: pending · published · failed · removed

    • urlstring (uri)

      La publicación en la red, una vez publicada.

    • errorstring
  • statusstringobligatorio

    Valores: draft · pending_approval · scheduled · publishing · published · partial · failed · cancelled

  • scheduledForstring (date-time)
  • approvalobject

    Aparece cuando la publicación ha pasado por revisión.

    approval
    • requestedBystring

      Quién la envió a revisión; no aparece si fue una API key.

    • requestedAtstring (date-time)obligatorio
    • queueboolean

      Al aprobarla, entra en la cola del perfil.

    • decisionstring

      Valores: approved · rejected

    • decidedBystring
    • decidedAtstring (date-time)
    • notestring

      Por qué se rechazó.

  • recyclingobject

    Aparece cuando se activa el reciclado.

    recycling
    • activebooleanobligatorio
    • everyintegerobligatorio

      máx. 9.007.199.254.740.991

    • unitstringobligatorio

      Valores: week · month

    • startAtstring (date-time)
    • maxCopiesinteger

      máx. 9.007.199.254.740.991

    • untilstring (date-time)
    • variationsstring[]
    • timezonestring
    • copiesintegerobligatorio

      Copias creadas hasta ahora.

      máx. 9.007.199.254.740.991

    • nextAtstring (date-time)

      Cuándo sale la siguiente copia; no aparece cuando se ha parado.

    • lastCopyIdstring

      La última copia, que es una publicación propia.

  • recycledFromstring

    En una copia reciclada: la publicación original.

  • createdAtstring (date-time)obligatorio
  • updatedAtstring (date-time)obligatorio
Ventana de terminal
curl -X DELETE "https://api.usecrier.com/v1/posts/pst_7q1w0e/recycling" \
-H "Authorization: Bearer $CRIER_API_KEY"
POST/v1/posts/{id}/retry

Parámetros

  • idstringobligatorio

Respuesta 200

data
  • idstringobligatorio
  • contentstringobligatorio
  • mediaobject[]obligatorio
    media
    • typestringobligatorio

      Valores: image · video · gif · document

    • urlstring (uri)obligatorio
    • altTextstring

      máx. 1000

  • targetsobject[]obligatorio
    targets
    • accountIdstringobligatorio
    • platformstringobligatorio
    • contentstring
    • mediaobject[]
      media
      • typestringobligatorio

        Valores: image · video · gif · document

      • urlstring (uri)obligatorio
      • altTextstring

        máx. 1000

    • statusstringobligatorio

      Valores: pending · published · failed · removed

    • urlstring (uri)

      La publicación en la red, una vez publicada.

    • errorstring
  • statusstringobligatorio

    Valores: draft · pending_approval · scheduled · publishing · published · partial · failed · cancelled

  • scheduledForstring (date-time)
  • approvalobject

    Aparece cuando la publicación ha pasado por revisión.

    approval
    • requestedBystring

      Quién la envió a revisión; no aparece si fue una API key.

    • requestedAtstring (date-time)obligatorio
    • queueboolean

      Al aprobarla, entra en la cola del perfil.

    • decisionstring

      Valores: approved · rejected

    • decidedBystring
    • decidedAtstring (date-time)
    • notestring

      Por qué se rechazó.

  • recyclingobject

    Aparece cuando se activa el reciclado.

    recycling
    • activebooleanobligatorio
    • everyintegerobligatorio

      máx. 9.007.199.254.740.991

    • unitstringobligatorio

      Valores: week · month

    • startAtstring (date-time)
    • maxCopiesinteger

      máx. 9.007.199.254.740.991

    • untilstring (date-time)
    • variationsstring[]
    • timezonestring
    • copiesintegerobligatorio

      Copias creadas hasta ahora.

      máx. 9.007.199.254.740.991

    • nextAtstring (date-time)

      Cuándo sale la siguiente copia; no aparece cuando se ha parado.

    • lastCopyIdstring

      La última copia, que es una publicación propia.

  • recycledFromstring

    En una copia reciclada: la publicación original.

  • createdAtstring (date-time)obligatorio
  • updatedAtstring (date-time)obligatorio
Ventana de terminal
curl -X POST "https://api.usecrier.com/v1/posts/pst_7q1w0e/retry" \
-H "Authorization: Bearer $CRIER_API_KEY"
POST/v1/posts/{id}/unpublish

De todas las redes o solo de accountId.

Parámetros

  • idstringobligatorio

Cuerpo

  • accountIdstring

Respuesta 200

data
  • idstringobligatorio
  • contentstringobligatorio
  • mediaobject[]obligatorio
    media
    • typestringobligatorio

      Valores: image · video · gif · document

    • urlstring (uri)obligatorio
    • altTextstring

      máx. 1000

  • targetsobject[]obligatorio
    targets
    • accountIdstringobligatorio
    • platformstringobligatorio
    • contentstring
    • mediaobject[]
      media
      • typestringobligatorio

        Valores: image · video · gif · document

      • urlstring (uri)obligatorio
      • altTextstring

        máx. 1000

    • statusstringobligatorio

      Valores: pending · published · failed · removed

    • urlstring (uri)

      La publicación en la red, una vez publicada.

    • errorstring
  • statusstringobligatorio

    Valores: draft · pending_approval · scheduled · publishing · published · partial · failed · cancelled

  • scheduledForstring (date-time)
  • approvalobject

    Aparece cuando la publicación ha pasado por revisión.

    approval
    • requestedBystring

      Quién la envió a revisión; no aparece si fue una API key.

    • requestedAtstring (date-time)obligatorio
    • queueboolean

      Al aprobarla, entra en la cola del perfil.

    • decisionstring

      Valores: approved · rejected

    • decidedBystring
    • decidedAtstring (date-time)
    • notestring

      Por qué se rechazó.

  • recyclingobject

    Aparece cuando se activa el reciclado.

    recycling
    • activebooleanobligatorio
    • everyintegerobligatorio

      máx. 9.007.199.254.740.991

    • unitstringobligatorio

      Valores: week · month

    • startAtstring (date-time)
    • maxCopiesinteger

      máx. 9.007.199.254.740.991

    • untilstring (date-time)
    • variationsstring[]
    • timezonestring
    • copiesintegerobligatorio

      Copias creadas hasta ahora.

      máx. 9.007.199.254.740.991

    • nextAtstring (date-time)

      Cuándo sale la siguiente copia; no aparece cuando se ha parado.

    • lastCopyIdstring

      La última copia, que es una publicación propia.

  • recycledFromstring

    En una copia reciclada: la publicación original.

  • createdAtstring (date-time)obligatorio
  • updatedAtstring (date-time)obligatorio
Ventana de terminal
curl -X POST "https://api.usecrier.com/v1/posts/pst_7q1w0e/unpublish" \
-H "Authorization: Bearer $CRIER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"accountId": "acc_3k9x2m"
}'

© 2026 Crier by TWOFACES ·usecrier.com ·Panel ·soporte@twofacesco.com