> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # API de X > Opciones para publicar usando la API de X ## X BYO API Keys A partir del 31 de marzo de 2026, todas las operaciones de X/Twitter requerirán tus propias credenciales de API. Después de vincular tu cuenta de X vía OAuth, incluye estos 2 headers en cada solicitud dirigida a X: | Header | Valor | | ----------------------------- | ----------------------------------- | | `X-Twitter-OAuth1-Api-Key` | Tu API Key (Consumer Key) | | `X-Twitter-OAuth1-Api-Secret` | Tu API Key Secret (Consumer Secret) | ¿Aún no la has vinculado? Consulta la [Guía de configuración de X BYO Key](/dashboard/connect-social-accounts/x-twitter-byo-keys) para conectar tu cuenta de X. Ayrshare ya no impone sus propios rate limits mensuales o diarios de X/Twitter. Como las solicitudes a X usan tus propias credenciales (BYO), tu uso se rige únicamente por los límites de tu propia X Developer App. Consulta la [documentación de rate limits de la API de X](https://developer.x.com/en/docs/x-api/rate-limits) para más detalles. ## Publicar en X (Twitter) JSON para una publicación básica con un enlace y una imagen usando la API de X, anteriormente conocida como la API de Twitter: ```json X Post theme={"system"} { "post": "The best Tweet ever #best https://www.twitter.com", // empty string is allowed "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], "platforms": ["twitter"] } ``` ## Opciones de X Puedes establecer opciones adicionales para una publicación usando el parámetro `twitterOptions`. ```json X Options theme={"system"} { "twitterOptions": { "altText": ["This is my best pic", "😃 here is the next one"], "blockCountries": ["US", "CA"], // or "allowCountries": ["GB", "IE"] "longPost": true, "longVideo": true, "poll": { "duration": 5, // required. Number in minutes "options": ["yes", "maybe", "no"] // required }, "quoteTweetId": "651601430669664256", "replySettings": "mentioned", "subscribersOnly": true, "thumbNail": "https://img.ayrshare.com/012/gb.jpg", // Video Metadata "videoTitle": "My Product Demo", "videoDescription": "A short walkthrough of our latest release.", // Subtitles / Captions for Videos "subTitleUrl": "https://img.ayrshare.com/012/captions.srt", "subTitleLanguage": "en", "subTitleName": "English", // Thread Options "thread": true, "threadNumber": true, "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], } } ``` Las opciones de X son campos opcionales que se pueden usar para controlar la publicación. Texto alternativo de las imágenes para ayudar con la accesibilidad y los lectores de pantalla. Máximo 1000 caracteres por alt text. Consulta [Alt Text](/apis/post/social-networks/x-twitter#alt-text) para más información. Restringe los medios a países específicos bloqueando ciertas regiones. Usa [códigos de país](/iso-codes/country). No se puede usar con `allowCountries`. Consulta [Restricciones geográficas](/apis/post/social-networks/x-twitter#geo-restrictions) para más información. Restringe los medios a países específicos permitiendo ciertas regiones. Usa [códigos de país](/iso-codes/country). No se puede usar con `blockCountries`. Consulta [Restricciones geográficas](/apis/post/social-networks/x-twitter#geo-restrictions) para más información. Habilita la publicación de posts más largos, de hasta 25 000 caracteres, para usuarios Premium. Consulta [Long Post](/apis/post/social-networks/x-twitter#long-post) para más información. Permite publicar videos de más de 2 minutos y 20 segundos para cuentas aprobadas. Consulta [Long Video](/apis/post/social-networks/x-twitter#long-video) para más información. Realiza encuestas con opciones y duración personalizadas. Campos obligatorios: `duration` (número en minutos), `options` (arreglo de strings). Consulta [Encuestas](/apis/post/social-networks/x-twitter#polls) para más información. Cita otro tweet especificando el Tweet ID. Consulta [Quote Tweet](/apis/post/social-networks/x-twitter#quote-tweet) para más información. Controla quién puede responder a la publicación. Valores: `following`, `mentioned`, `subscribers` o `verified`. Consulta [Reply Settings](/apis/post/social-networks/x-twitter#reply-settings) para más información. Hace que la publicación sea visible solo para los suscriptores. Consulta [Subscribers Only](/apis/post/social-networks/x-twitter#subscribers-only) para más información. Añade subtítulos/captions a los videos usando archivos SRT. Debe ser una URL válida de archivo SRT terminada en `.srt`. Consulta [Subtítulos/captions para videos](/apis/post/social-networks/x-twitter#subtitles-captions-for-videos) para más información. El idioma de los subtítulos. Debe ser un [código de idioma](/iso-codes/language) válido. El nombre de la pista de subtítulos. Máximo 150 caracteres. Establece una miniatura (imagen de portada) para videos. Debe ser una URL a un archivo de imagen JPEG, PNG, BMP o WebP. Consulta [Miniatura de video](/apis/post/social-networks/x-twitter#video-thumbnail) para más información y las [Directrices de medios de X](/media-guidelines/x_twitter#video-thumbnail) para los requisitos de la imagen. Establece el título de un video. Se corresponde con el campo title en X Media Studio. Consulta [Metadatos de video](/apis/post/social-networks/x-twitter#video-metadata) para más información. Establece la descripción de un video. Se corresponde con el campo description en X Media Studio. Consulta [Metadatos de video](/apis/post/social-networks/x-twitter#video-metadata) para más información. Divide publicaciones largas en series de threads conectados con numeración y medios opcionales. Consulta [Threads](/apis/post/social-networks/x-twitter#thread) para más información. Añade automáticamente números al final de cada thread con el formato 1/n. Requiere `thread: true`. Añade objetos de medios a los threads. Se agregará un objeto de medio a cada thread en orden. Usa `null` para omitir el medio de un thread específico. Usa objetos con varias URLs para incluir varios medios en un mismo thread. ## Alt Text Añade texto alternativo, también conocido como alt text, a la imagen de un Tweet. El alt text de X es una función de accesibilidad utilizada para brindar información adicional al usuario y para lectores de pantalla. Usa `altText` dentro del objeto `twitterOptions`. ```json X Alt Text theme={"system"} { "twitterOptions": { "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts } } ``` Cada alt text debe corresponder a una imagen del arreglo `mediaUrls`. El alt text se aplicará a cada imagen en orden. El alt text no se puede aplicar a videos. Si se incluye un video en `mediaUrls` con `altText`, el video no se publicará. El alt text debe tener 1000 caracteres o menos. ## Restricciones geográficas Puedes restringir los medios de X, como una imagen o video, a países específicos usando los parámetros `blockCountries` y `allowCountries` con [códigos de país](/iso-codes/country). La publicación seguirá apareciendo en todos los países, pero el medio no estará disponible en los países especificados. ```json Block Countries theme={"system"} { "twitterOptions": { "blockCountries": ["US", "CA"] } } ``` ```json Allow Countries theme={"system"} { "twitterOptions": { "allowCountries": ["GB", "IE"] } } ``` Solo debes usar uno de los parámetros `blockCountries` o `allowCountries` a la vez. Si se usan ambos parámetros o un país no es compatible con X, las restricciones geográficas se ignorarán. ## Long Post Los usuarios con cuentas Premium de X, como Premium o Premium Plus, tienen la capacidad de publicar posts más largos de hasta 25 000 caracteres. Ayrshare habilita automáticamente las publicaciones long form para usuarios con cuentas Premium de X. Si el usuario cambia su estado de X Premium, espera 24 horas para que se refleje en Ayrshare. Puedes comprobar el estado de la suscripción Premium de un usuario con los endpoints [/user](/apis/user/overview) o [/analytics](/apis/analytics/social). También puedes forzar que se acepte una publicación long form con el parámetro `longPost` del body. Puedes hacerlo incluyendo el siguiente JSON en tu solicitud: ```json X Long Post theme={"system"} { "twitterOptions": { "longPost": true } } ``` Sin embargo, si un usuario sin cuenta Premium intenta publicar un tweet largo, el sistema devolverá un error `code: 111`. ## Long Video *Requiere Business Plan o Enterprise Plan.* X requiere que los videos tengan una [duración máxima](/media-guidelines/x_twitter#video) de 2 minutos y 20 segundos. Sin embargo, si X te ha aprobado para subir videos más largos, por ejemplo si la cuenta de X del usuario es Premium o está en el [Amplify Partner Program](https://media.twitter.com/en/articles/products/2018/in-stream-video-ads-for-publishers), puedes publicar videos de más de 10 minutos de duración. Verifica que la cuenta de X de tu usuario sea Premium o esté en el [Amplify Partner Program](https://media.twitter.com/en/articles/products/2018/in-stream-video-ads-for-publishers) antes de usar el parámetro `longVideo`. Si la cuenta de X del usuario no está autorizada para publicar videos largos, el sistema devolverá un error. Usa el parámetro `longVideo` en twitterOptions al publicar un video largo: ```json X Long Video theme={"system"} { "twitterOptions": { "longVideo": true } } ``` ## Menciones Menciona otro handle de X añadiendo `@handle` en el texto de la publicación. Por ejemplo: ```json X Mention theme={"system"} { "post": "The best social media API @Ayrshare ever!", "platforms": ["twitter"] } ``` Consulta las [reglas importantes](/testing/post-verification#mentions) sobre menciones. ## Encuestas Realiza una encuesta de X con el parámetro `poll` de `twitterOptions`. ```json X Poll theme={"system"} { "twitterOptions": { "poll": { "duration": 5, // required. Number in minutes "options": ["yes", "maybe", "no"] // required } } } ``` ## Quote Tweet Puedes citar otro Tweet especificando el Tweet ID de bajo nivel. El ID se puede obtener desde la respuesta de [`/post`](/apis/post/post) en el campo `postIds`, mediante [get history](/apis/history/get-history) o directamente desde la URL del Tweet: [https://twitter.com/Ayrshare/status/**1651601430669664256**](https://twitter.com/Ayrshare/status/1651601430669664256) ```json X Quote Tweet theme={"system"} { "twitterOptions": { "quoteTweetId": "651601430669664256" // low-level Tweet Id } } ``` ## Reply Settings Puedes configurar los ajustes de respuesta de una publicación para permitir respuestas solo de ciertos tipos de usuarios. ```json X Reply Settings theme={"system"} { "twitterOptions": { "replySettings": "mentioned" } } ``` El parámetro `replySettings` puede tener uno de los siguientes valores: ## Subscribers Only Puedes hacer que una publicación sea visible solo para los suscriptores usando el parámetro `subscribersOnly`. ```json X Subscribers Only theme={"system"} { "twitterOptions": { "subscribersOnly": true } } ``` ## Subtítulos/captions para videos Puedes añadir subtítulos de X, también conocidos como captions de X, a los videos incluyendo un [archivo SRT](https://en.wikipedia.org/wiki/SubRip). Usa el campo `subTitleUrl` dentro del objeto `twitterOptions` para especificar la URL a tu archivo SRT. ```json X Subtitles theme={"system"} { "twitterOptions": { "subTitleUrl": "https://img.ayrshare.com/012/captions.srt", "subTitleLanguage": "en", "subTitleName": "English" } } ``` ## Miniatura de video Establece una miniatura (imagen de portada) para videos de Twitter/X. La miniatura se muestra antes de que el video se reproduzca y ayuda a los usuarios a entender el contenido del video. Usa `thumbNail` dentro del objeto `twitterOptions`. ```json Twitter/X Video Thumbnail theme={"system"} { "twitterOptions": { "thumbNail": "https://img.ayrshare.com/012/gb.jpg" } } ``` ## Metadatos de video Establece un título y una descripción para un video publicado en X. Estos se corresponden con los campos title y description en X Media Studio. Usa los campos `videoTitle` y `videoDescription` dentro del objeto `twitterOptions`. ```json X Video Metadata theme={"system"} { "twitterOptions": { "videoTitle": "My Product Demo", "videoDescription": "A short walkthrough of our latest release." } } ``` ## Monetización de video (Pro Media) Ayrshare admite la monetización de videos de X (Twitter) para cuentas elegibles a través del programa Pro Media de X. Es una capacidad de acceso limitado — [contáctanos](mailto:support@ayrshare.com) si te gustaría tener acceso. ## Thread Un X Thread, también conocido como tweetstorm, es una serie conectada de publicaciones en X (antes Twitter) que te permite compartir ideas más largas más allá del límite de caracteres de una sola publicación, apareciendo como una narrativa continua cuando se ven juntas. X Thread ### Publicar un Thread Un X Thread se puede publicar mediante la API. Un thread es una publicación dividida en un conjunto de threads de respuesta y asociados en X con una línea. Puedes dividir la publicación automáticamente o especificar los [thread breaks](/apis/post/social-networks/x-twitter#thread-breaks) en el texto de la publicación. ```json X Thread theme={"system"} { "twitterOptions": { "thread": true, // required for TweetStorm "threadNumber": true, // optional to add numbers to each thread "mediaUrls": ["https://site.com/image1.png", "https://site.com/image2.png", ...] // optional one media object is added to a thread in order } } ``` Si la publicación se envía como X Thread, las analíticas de publicación devueltas serán un arreglo de Tweets, `"twitter": []`. Consulta [Post Analytics 200 Response](/apis/analytics/post) para más información. #### Medios del thread ##### Omitir medio Omite el medio del thread usando `null` en el arreglo. Por ejemplo: `["https://site.com/image1.png", null, "https://site.com/image2.png"]` Esto colocará image1 en el primer Tweet, ningún imagen en el segundo Tweet e image2 en el tercer Tweet. ##### Múltiples medios Se pueden añadir varios objetos de medios a un Tweet dentro de un Thread agregando un objeto `{}` con las URLs de los medios en el arreglo `mediaUrls`. Se pueden usar cualquier clave única. Por ejemplo: ```json X Thread with Multiple Media URLs theme={"system"} { "twitterOptions": { "thread": true, "threadNumber": true, "mediaUrls": [ "https://img.ayrshare.com/random/photo-1.jpg", { "1": "https://img.ayrshare.com/random/photo-2.jpg", "2": "https://img.ayrshare.com/random/photo-3.jpg" }, "https://img.ayrshare.com/random/photo-4.jpg" ] } } ``` En este ejemplo, el primer Tweet contendrá photo-1.jpg, el segundo Tweet photo-2.jpg y photo-3.jpg, y el tercer Tweet photo-4.jpg. #### Cortes del thread Ayrshare divide automáticamente el texto de la publicación en tweets de longitud adecuada (> 280 caracteres). Al crear threads, damos prioridad a mantener oraciones completas en una sola publicación cuando es posible. Si una oración no cabe, dividimos entre oraciones. Para oraciones muy largas, dividimos entre palabras. En casos raros en los que una palabra sea demasiado larga, dividimos la palabra en sí. También puedes añadir manualmente párrafos con `\n\n` al texto de la publicación para indicar que se debe crear un thread único. Si tienes `\n\n` en el texto de la publicación, no dividiremos automáticamente la publicación en threads. Por ejemplo: ```json Example X Thread theme={"system"} { "post": "This is tweet 1\n\nThis is tweet 2.", "platforms": ["twitter"], "twitterOptions": { "thread": true } } ``` resultará en dos Tweets en el thread. Si quieres añadir párrafos pero no dividir en Tweets, usa `\u2063\n\u2063\n` ```json X Thread with Paragraphs theme={"system"} { "post": "This is paragraph 1\u2063\n\u2063\nThis is paragraph 2.", "platforms": ["twitter"], "twitterOptions": { "thread": true } } ``` resultará en un solo Tweet con dos párrafos, ya que la publicación tiene menos de 280 caracteres. ### Eliminar un thread Para eliminar un Tweet Storm, llama al [endpoint /post delete](/apis/post/delete-post) con el ID de la publicación de nivel superior devuelto en la respuesta. Todos los threads se eliminarán. ## Límites de caracteres Consulta [Límites de caracteres de X/Twitter](/help-center/technical-support/character_limits#x%2Ftwitter-character-limits) para más información. ## Compatibilidad de video en X Algunos programas de video crean archivos MP4 que no son compatibles con X. Por ejemplo, versiones de Camtasia anteriores a 2019.0.9 crean archivos MP4 que X rechaza. Además, tener más de una pista de audio suele causar problemas. Si recibes el siguiente mensaje al publicar, indica que el video no es compatible con Twitter y necesita ser reencodificado. `"file is currently unsupported"` Revisa la compatibilidad de tu software de video. Por ejemplo, Adobe Media Encoder tiene un preset de exportación para Twitter 1080p Full HD. Adobe Media Encoder Consulta aquí más [ejemplos de la API de X](https://www.ayrshare.com/twitter-api-how-to-post-and-get-analytics-with-the-twitter-api#twitter-api-examples). ## Subscribers Only Puedes hacer que una publicación sea visible solo para los suscriptores usando el parámetro `subscribersOnly`. ```json X Subscribers Only theme={"system"} { "twitterOptions": { "subscribersOnly": true } } ``` ## Reply Settings Puedes configurar los ajustes de respuesta de una publicación para permitir respuestas solo de ciertos tipos de usuarios. ```json X Reply Settings theme={"system"} { "twitterOptions": { "replySettings": "mentioned" } } ``` El parámetro `replySettings` puede tener uno de los siguientes valores: