Queber API

Ejecuta automatizaciones de Queber con REST API

Usa endpoints HTTPS, documentación OpenAPI y credenciales con scopes para crear, programar, editar y supervisar trabajos de automatización en Queber Desktop

Abrir configuracion API Descargar Desktop

MCP REST API

REST API

Conectar un cliente API

Crea una credencial con scopes en el area de miembro, manten Queber Desktop online y llama a los endpoints de la API con un encabezado Authorization Bearer.

Prueba antes de crear

Abre Swagger UI y ejecuta solicitudes contra tu propia cuenta Queber.

Importa el schema OpenAPI

Importa el schema para crear, programar, actualizar, inspeccionar, cancelar y repetir trabajos de Queber desde tus herramientas.

Crea un token API personal

Recomendado para Airtable, Make, n8n, Zapier, scripts, cron y CI.

Manten Queber Desktop online

Las llamadas a la API se ejecutan a traves del desktop relay con sesion iniciada.

Schema y docs

Primero Swagger UI, luego schema cuando lo necesites

Usa Swagger para probar llamadas en el navegador, luego importa el schema OpenAPI JSON en tu cliente o tooling.

Abrir Swagger UI Abrir schema OpenAPI

Autorizacion

Usa un token API personal para automatizaciones simples

Crea un token con scopes en el area de miembro, guardalo como secret en tu herramienta externa y envialo como encabezado Authorization Bearer. OAuth sigue disponible para clientes interactivos y apps alojadas que necesitan consentimiento del usuario.

Tokens API personales OAuth apps avanzadas

Cómo funciona

El cliente REST no habla directamente con tu app local.

El cliente envía una petición HTTPS

Tu cliente llama a un endpoint /actions de la REST API de Queber con un token de API personal o un token de acceso OAuth.

El servidor valida permisos

Queber valida el token, el plan de pago y los scopes que requiere ese endpoint.

Desktop ejecuta localmente

El servidor retransmite el comando a tu app Queber Desktop conectada mediante su conexión segura en segundo plano.

La respuesta vuelve como JSON

El endpoint devuelve una respuesta JSON estructurada con estado, perfiles, trabajos o resultados de automatización.

Herramientas disponibles

Qué puede hacer un cliente autorizado.

Comprobar estado Desktop

Ver si el relay de escritorio está conectado y qué capacidades están disponibles.

Leer perfiles de navegador

Listar perfiles, revisar uno, abrirlo manualmente o cerrar sesiones locales.

Revisar trabajos

Listar trabajos por páginas, leer un trabajo con su resultado, logs y progreso, y editar, cancelar, archivar, eliminar o reintentar trabajos.

Ejecutar automatización soportada

Crear publicaciones en Reddit y revisiones de publicaciones de Reddit, inmediatas o programadas.

El acceso se controla con tokens OAuth, scopes solicitados, verificación del plan de pago y la conexión activa de Queber Desktop. Revoca un cliente si ya no confías en él.

Ejemplo: revisión de publicaciones de Reddit

Sigue tus publicaciones de Reddit después de publicarlas

Un trabajo de revisión abre cada enlace en una pestaña en segundo plano de un perfil de navegador y devuelve lo que muestra la página: si la publicación sigue visible, se eliminó o ya no existe, su puntuación, la proporción de votos positivos, los comentarios y las vistas de tus propias publicaciones. Crea un trabajo y consúltalo hasta que termine.

Crea una revisión

Envía POST /actions/jobs/run con automationType post_read y los enlaces en platformData.reddit.post_read.links: sirven enlaces completos, de old.reddit, redd.it, publicaciones de perfil y enlaces para compartir. Añade una Idempotency-Key; la respuesta es el trabajo con estado pending.

Consulta el trabajo

Llama a GET /actions/jobs/{jobId} cada pocos segundos hasta que el estado sea completed o failed. Los enlaces se revisan uno tras otro con una pausa humana, así que una lista más larga tarda más.

Lee los resultados

resultData.reddit.post_read.items tiene un elemento por enlace con estado ok, removed, not_found o failed, y summary los cuenta. Una publicación eliminada guarda el mensaje de Reddit en removalMessage; un valor que Reddit no mostró es null y warnings explica por qué.

Vistas de tus propias publicaciones

Reddit muestra las vistas solo al autor, así que llegan solo para las publicaciones del perfil que revisa, redondeadas como las muestra Reddit, por ejemplo 5.2K. Cada revisión de tu propia publicación suma una vista en Reddit.

El trabajo falla solo si no se pudo revisar ningún enlace; un enlace que falla recibe el estado failed y la revisión continúa. Una ejecución se cobra cuando revisó al menos una publicación, y tu plan fija cuántos enlaces admite una ejecución.

POST https://mcp.queber.app/actions/jobs/run
Authorization: Bearer <token>
Idempotency-Key: post-read-2026-08-12-01

{
  "profileId": "3f1a2b4c-5d6e-4f70-8a91-b2c3d4e5f607",
  "platform": "reddit",
  "automationType": "post_read",
  "platformData": { "reddit": { "post_read": { "links": [
    "https://www.reddit.com/r/SideProject/comments/1abc234/queber_desktop_116_queue_view/",
    "https://old.reddit.com/r/webdev/comments/1abd345/how_do_you_schedule_reddit_posts/",
    "https://redd.it/1abe456"
  ] } } }
}

HTTP/1.1 201 Created
{ "job": { "id": "e2d4f6a8-1b3c-4d5e-8f70-9a1b2c3d4e5f", "automationType": "post_read", "status": "pending", … } }

GET https://mcp.queber.app/actions/jobs/e2d4f6a8-1b3c-4d5e-8f70-9a1b2c3d4e5f
Authorization: Bearer <token>

HTTP/1.1 200 OK
{ "job": { "status": "completed", "resultData": { "reddit": { "post_read": {
  "items": [
    { "url": "https://www.reddit.com/r/SideProject/comments/1abc234/", "status": "ok", "readAs": "author",
      "score": 13, "upvoteRatio": 0.93, "comments": 8, "views": 5200, "shares": 4, "reposts": 1,
      "topCountries": [{ "country": "US", "name": "United States", "percent": 41.2 }, …], "authorRank": 2,
      "warnings": [{ "field": "views", "code": "rounded", "message": "Reddit shows views rounded: 5.2K views" }], … },
    { "url": "https://www.reddit.com/r/webdev/comments/1abd345/", "status": "ok", "readAs": "other",
      "score": 1001, "upvoteRatio": 0.96, "comments": 5348, "views": null,
      "warnings": [{ "field": "views", "code": "author_only", "message": "Reddit shows views only to the post author" }], … },
    { "url": "https://www.reddit.com/comments/1abe456/", "status": "removed", "readAs": "author",
      "removalMessage": "Sorry, this post has been removed by the moderators of r/example.", … }
  ],
  "summary": { "total": 3, "read": 3, "removed": 1, "notFound": 0, "failed": 0 }
} } }, … } }

Ejemplo: comentario en Reddit

Comenta y responde en Reddit

Una tarea de comentario deja un comentario en una publicación o como respuesta a uno de sus comentarios, en una pestaña en segundo plano de un perfil de navegador. Revisa la publicación gratis, elige dónde responder, crea la tarea y consúltala hasta que termine.

Revisa la publicación

Envía POST /actions/reddit/comments/check con profileId y link. Abre la publicación con ese perfil, gratis y fuera de la cola, y devuelve blocked (por qué no se puede comentar, o null), los archivos que admite el cuadro de comentario y hasta 300 comentarios en thread. Puede tardar hasta 3 minutos si el perfil tiene que arrancar.

Elige dónde responder

Pasa un id de comentario de thread como replyToCommentId, u omítelo para comentar la publicación. Cada comentario de thread trae su autor, así que responder a un usuario concreto es filtrar por author. Un enlace a un comentario en link funciona igual que su id.

Crea el comentario

Envía POST /actions/jobs/run con automationType comment y platformData.reddit.comment: link, body (texto o HTML) y como máximo una imagen, GIF o vídeo de importMedia. Añade un Idempotency-Key; la respuesta es la tarea con estado pending.

Lee el resultado

Consulta la tarea hasta que termine. resultUrl es la página del nuevo comentario, y resultData.reddit.comment guarda su id, el comentario al que responde y alreadyPosted si una ejecución anterior ya lo había dejado y no se envió nada más. Una tarea fallida indica el motivo, como rate_limited con los minutos que Reddit pide esperar.

La revisión es gratis. Un comentario se cobra cuando Reddit lo muestra; una ejecución fallida y una que encuentra el mismo comentario ya publicado no cuestan nada. El mismo Idempotency-Key nunca crea una segunda tarea.

POST https://mcp.queber.app/actions/reddit/comments/check
Authorization: Bearer <token>

{
  "profileId": "3f1a2b4c-5d6e-4f70-8a91-b2c3d4e5f607",
  "link": "https://www.reddit.com/r/SideProject/comments/1abc234/queber_desktop_116_queue_view/"
}

HTTP/1.1 200 OK
{ "ok": true, "check": {
  "post": { "postId": "1abc234", "community": "r/SideProject", "comments": 8, … },
  "blocked": null,
  "media": { "images": true, "animatedImages": true, "videos": false, "maxMedia": 1 },
  "thread": { "loaded": 8, "complete": true, "comments": [
    { "id": "ohd7k2m", "author": "quiet_reader", "body": "Does it keep the profile logged in?", … },
    …
  ] }
} }

POST https://mcp.queber.app/actions/jobs/run
Authorization: Bearer <token>
Idempotency-Key: comment-2026-08-12-01

{
  "profileId": "3f1a2b4c-5d6e-4f70-8a91-b2c3d4e5f607",
  "platform": "reddit",
  "automationType": "comment",
  "platformData": { "reddit": { "comment": {
    "link": "https://www.reddit.com/r/SideProject/comments/1abc234/queber_desktop_116_queue_view/",
    "replyToCommentId": "ohd7k2m",
    "body": "Yes, every profile keeps its own session."
  } } }
}

HTTP/1.1 201 Created
{ "job": { "id": "b7c9d1e3-5f7a-4b9c-8d1e-3f5a7b9c1d2e", "automationType": "comment", "status": "pending", … } }

GET https://mcp.queber.app/actions/jobs/b7c9d1e3-5f7a-4b9c-8d1e-3f5a7b9c1d2e
→ { "job": { "status": "completed", "resultUrl": "https://www.reddit.com/r/SideProject/comments/1abc234/comment/ohe2p4q/",
  "resultData": { "reddit": { "comment": {
    "commentId": "ohe2p4q", "parentId": "ohd7k2m",
    "repliedTo": { "commentId": "ohd7k2m", "author": "quiet_reader" }, …
  } } }, … } }

Fiabilidad

Reintentos y cortes de conexión

Queber Desktop funciona en tu ordenador, así que una solicitud puede encontrarse con un portátil en reposo, un cambio de red o una respuesta lenta. Con estas reglas, un reintento nunca publica dos veces.

Una Idempotency-Key por trabajo

Envía la cabecera Idempotency-Key, por ejemplo un UUID, en cada solicitud que crea o cambia algo. Repetir la solicitud con la misma clave devuelve el primer resultado en lugar de publicar dos veces, así que tras un timeout o un 503 reintenta con la misma clave. Usa una clave nueva para cada trabajo y cada solicitud modificada, nunca una sola clave para todo un lote.

Espera Retry-After

Las respuestas 429 y 503 incluyen la cabecera Retry-After y retryAfterSeconds en el cuerpo del error cuando se conoce la espera. Espera ese tiempo y repite la misma solicitud con la misma clave. error.retryable indica si la misma solicitud puede funcionar más tarde; tras desktop_offline primero hay que abrir la app.

Comprueba relayState antes de un lote

Llama a GET /actions/status antes de enviar un lote. connected: envíalo. reconnecting: la app se desconectó y volverá pronto, espera retryAfterSeconds. offline: abre Queber Desktop e inicia sesión. conflict: cierra todas las apps de escritorio antiguas menos una.

Elige cuánto esperar

Mientras la app se reconecta, una solicitud espera hasta 25 segundos y luego responde 503 desktop_reconnecting. La cabecera X-Queber-Desktop-Wait-Ms, de 0 a 60000, cambia esa espera; el timeout de tu cliente HTTP debe superar la espera más 30 segundos (150 para importar medios).

POST https://mcp.queber.app/actions/jobs/schedule
Authorization: Bearer <token>
Idempotency-Key: post-2026-08-13-r-webdev-01
X-Queber-Desktop-Wait-Ms: 20000

{ "profileId": "3f1a2b4c-5d6e-4f70-8a91-b2c3d4e5f607", "platform": "reddit", … }

HTTP/1.1 503 Service Unavailable
Retry-After: 12

{
  "error": {
    "code": "desktop_reconnecting",
    "message": "Queber Desktop lost its connection and is reconnecting. Retry the request shortly; you do not need to restart the app.",
    "retryable": true,
    "retryAfterSeconds": 12
  }
}

Need help?

Questions about the REST API integration

If token setup, schema import, API calls or desktop execution does not work as expected, contact Queber support or write to us on Telegram.

Queber support

Telegram REST API docs