> ## 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 do X > Opções para publicar usando a API do X ## Chaves de API BYO do X A partir de 31 de março de 2026, todas as operações do X/Twitter exigem suas próprias credenciais de API. Após vincular sua conta do X via OAuth, inclua estes 2 cabeçalhos em cada requisição direcionada ao X: | Cabeçalho | Valor | | ----------------------------- | ------------------------------------ | | `X-Twitter-OAuth1-Api-Key` | Sua API Key (Consumer Key) | | `X-Twitter-OAuth1-Api-Secret` | Seu API Key Secret (Consumer Secret) | Ainda não vinculou? Consulte o [Guia de configuração de chaves BYO do X](/dashboard/connect-social-accounts/x-twitter-byo-keys) para conectar sua conta do X. O Ayrshare não impõe mais seus próprios limites de taxa mensais ou diários do X/Twitter. Como as requisições do X usam suas próprias credenciais (BYO), seu uso é regido exclusivamente pelos limites do seu próprio App de Desenvolvedor do X. Consulte a [documentação de limites de taxa da API do X](https://developer.x.com/en/docs/x-api/rate-limits) para mais detalhes. ## Publicando no X (Twitter) JSON para uma publicação básica com link e imagem usando a API do X, anteriormente conhecida como API do 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"] } ``` ## Opções do X Você pode definir opções adicionais para uma publicação usando o 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"], } } ``` As opções do X são campos opcionais que podem ser usados para controlar a publicação. Texto alternativo para imagens para ajudar com acessibilidade e leitores de tela. Máximo de 1.000 caracteres por texto alternativo. Consulte [Texto alternativo](/apis/post/social-networks/x-twitter#alt-text) para mais informações. Restringe a mídia a países específicos bloqueando certas regiões. Use [códigos de país](/iso-codes/country). Não pode ser usado com `allowCountries`. Consulte [Restrições geográficas](/apis/post/social-networks/x-twitter#geo-restrictions) para mais informações. Restringe a mídia a países específicos permitindo certas regiões. Use [códigos de país](/iso-codes/country). Não pode ser usado com `blockCountries`. Consulte [Restrições geográficas](/apis/post/social-networks/x-twitter#geo-restrictions) para mais informações. Habilita a publicação de posts mais longos, com até 25.000 caracteres, para usuários Premium. Consulte [Post longo](/apis/post/social-networks/x-twitter#long-post) para mais informações. Permite a publicação de vídeos com mais de 2 minutos e 20 segundos para contas aprovadas. Consulte [Vídeo longo](/apis/post/social-networks/x-twitter#long-video) para mais informações. Realiza enquetes com opções e duração personalizadas. Campos obrigatórios: `duration` (número em minutos), `options` (array de strings). Consulte [Enquetes](/apis/post/social-networks/x-twitter#polls) para mais informações. Cite outro tweet especificando o ID do Tweet. Consulte [Quote Tweet](/apis/post/social-networks/x-twitter#quote-tweet) para mais informações. Controle quem pode responder à publicação. Valores: `following`, `mentioned`, `subscribers` ou `verified`. Consulte [Configurações de resposta](/apis/post/social-networks/x-twitter#reply-settings) para mais informações. Torna a publicação visível apenas para assinantes. Consulte [Somente assinantes](/apis/post/social-networks/x-twitter#subscribers-only) para mais informações. Adiciona legendas/subtítulos a vídeos usando arquivos SRT. Deve ser uma URL válida de arquivo SRT terminando em `.srt`. Consulte [Legendas / Subtítulos para vídeos](/apis/post/social-networks/x-twitter#subtitles-captions-for-videos) para mais informações. O idioma das legendas. Deve ser um [código de idioma](/iso-codes/language) válido. O nome da trilha de legenda. Máximo de 150 caracteres. Define uma miniatura (imagem de capa) para vídeos. Deve ser uma URL para um arquivo de imagem JPEG, PNG, BMP ou WebP. Consulte [Miniatura de vídeo](/apis/post/social-networks/x-twitter#video-thumbnail) para mais informações e [Diretrizes de mídia do X](/media-guidelines/x_twitter#video-thumbnail) para requisitos de imagem. Define o título de um vídeo. Corresponde ao campo de título no X Media Studio. Consulte [Metadados de vídeo](/apis/post/social-networks/x-twitter#video-metadata) para mais informações. Define a descrição de um vídeo. Corresponde ao campo de descrição no X Media Studio. Consulte [Metadados de vídeo](/apis/post/social-networks/x-twitter#video-metadata) para mais informações. Divide publicações longas em séries de threads conectadas, com numeração e mídia opcionais. Consulte [Threads](/apis/post/social-networks/x-twitter#thread) para mais informações. Adiciona automaticamente números ao final dos threads no formato 1/n. Requer `thread: true`. Adiciona objetos de mídia aos threads. Um objeto de mídia será adicionado a cada thread em ordem. Use `null` para pular a mídia de um thread específico. Use objetos com múltiplas URLs para várias mídias por thread. ## Texto alternativo Adicione texto alternativo, também conhecido como alt text, à imagem de um Tweet. O alt text do X é um recurso de acessibilidade usado para informações adicionais e leitores de tela. Use o `altText` no 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 texto alternativo deve corresponder a uma imagem no array `mediaUrls`. O texto alternativo será aplicado a cada imagem em ordem. O texto alternativo não pode ser aplicado a vídeos. Se um vídeo for incluído em `mediaUrls` com `altText`, o vídeo não será publicado. O texto alternativo deve ter 1.000 caracteres ou menos. ## Restrições geográficas Você pode restringir mídias do X, como uma imagem ou vídeo, a países específicos usando os parâmetros `blockCountries` e `allowCountries` com [códigos de país](/iso-codes/country). A publicação ainda será exibida em todos os países, mas a mídia não estará disponível nos países especificados. ```json Block Countries theme={"system"} { "twitterOptions": { "blockCountries": ["US", "CA"] } } ``` ```json Allow Countries theme={"system"} { "twitterOptions": { "allowCountries": ["GB", "IE"] } } ``` Você deve usar apenas um dos parâmetros `blockCountries` ou `allowCountries` por vez. Se ambos os parâmetros forem usados ou se um país não for suportado pelo X, as restrições geográficas serão ignoradas. ## Post longo Usuários com contas Premium do X, como Premium ou Premium Plus, têm a capacidade de publicar posts mais longos, de até 25.000 caracteres. O Ayrshare permite automaticamente posts em formato longo para usuários com contas Premium do X. Se o usuário alterar seu status Premium no X, aguarde 24 horas para que isso seja refletido no Ayrshare. Você pode verificar o status da assinatura Premium de um usuário com os endpoints [/user](/apis/user/overview) ou [/analytics](/apis/analytics/social). Você também pode forçar a aceitação de um post em formato longo com o parâmetro de corpo `longPost`. Isso pode ser feito incluindo o seguinte JSON em sua requisição: ```json X Long Post theme={"system"} { "twitterOptions": { "longPost": true } } ``` No entanto, se um usuário sem uma conta Premium tentar publicar um tweet longo, o sistema retornará um erro `code: 111`. ## Vídeo longo *Plano Business ou Enterprise necessário.* O X exige que os vídeos tenham uma [duração máxima de vídeo](/media-guidelines/x_twitter#video) de 2 minutos e 20 segundos. No entanto, se você foi aprovado pelo X para enviar vídeos mais longos, como quando a conta do X do usuário é Premium ou está no [Amplify Partner Program](https://media.twitter.com/en/articles/products/2018/in-stream-video-ads-for-publishers), você pode publicar vídeos com mais de 10 minutos de duração. Verifique se a conta do X do seu usuário é Premium ou está no [Amplify Partner Program](https://media.twitter.com/en/articles/products/2018/in-stream-video-ads-for-publishers) antes de usar o parâmetro `longVideo`. Se a conta do X do seu usuário não estiver autorizada a publicar vídeos longos, o sistema retornará um erro. Use o parâmetro `longVideo` do twitterOptions ao publicar um vídeo longo: ```json X Long Video theme={"system"} { "twitterOptions": { "longVideo": true } } ``` ## Menções Mencione outro handle do X adicionando `@handle` ao texto da publicação. Por exemplo: ```json X Mention theme={"system"} { "post": "The best social media API @Ayrshare ever!", "platforms": ["twitter"] } ``` Revise as [regras importantes](/testing/post-verification#mentions) sobre menções. ## Enquetes Realize uma enquete no X com o 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 Você pode citar outro Tweet especificando o ID de baixo nível do Tweet. O ID pode ser obtido pela resposta do [`/post`](/apis/post/post) no campo `postIds`, pelo [get history](/apis/history/get-history) ou diretamente da URL do 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 } } ``` ## Configurações de resposta Você pode definir as configurações de resposta de uma publicação para permitir respostas apenas de certos tipos de usuários. ```json X Reply Settings theme={"system"} { "twitterOptions": { "replySettings": "mentioned" } } ``` O parâmetro `replySettings` pode ter um dos seguintes valores: ## Somente assinantes Você pode definir que uma publicação seja visível apenas para assinantes usando o parâmetro `subscribersOnly`. ```json X Subscribers Only theme={"system"} { "twitterOptions": { "subscribersOnly": true } } ``` ## Legendas / Subtítulos para vídeos Você pode adicionar legendas do X, também conhecidas como captions do X, a vídeos incluindo um [arquivo SRT](https://en.wikipedia.org/wiki/SubRip). Use o campo `subTitleUrl` no objeto `twitterOptions` para especificar a URL do seu arquivo SRT. ```json X Subtitles theme={"system"} { "twitterOptions": { "subTitleUrl": "https://img.ayrshare.com/012/captions.srt", "subTitleLanguage": "en", "subTitleName": "English" } } ``` ## Miniatura de vídeo Defina uma miniatura (imagem de capa) para vídeos do Twitter/X. A miniatura é exibida antes de o vídeo ser reproduzido e ajuda os usuários a entender o conteúdo do vídeo. Use `thumbNail` no objeto `twitterOptions`. ```json Twitter/X Video Thumbnail theme={"system"} { "twitterOptions": { "thumbNail": "https://img.ayrshare.com/012/gb.jpg" } } ``` ## Metadados de vídeo Defina um título e uma descrição para um vídeo publicado no X. Estes correspondem aos campos de título e descrição no X Media Studio. Use os campos `videoTitle` e `videoDescription` no objeto `twitterOptions`. ```json X Video Metadata theme={"system"} { "twitterOptions": { "videoTitle": "My Product Demo", "videoDescription": "A short walkthrough of our latest release." } } ``` ## Monetização de vídeo (Pro Media) O Ayrshare suporta a monetização de vídeos no X (Twitter) para contas elegíveis por meio do programa Pro Media do X. Este é um recurso de acesso limitado — [entre em contato](mailto:support@ayrshare.com) se desejar acesso. ## Thread Um Thread do X, também conhecido como tweetstorm, é uma série conectada de publicações no X (antigamente Twitter) que permite compartilhar ideias mais longas além do limite de caracteres de uma única publicação, aparecendo como uma narrativa contínua quando vistas em conjunto. X Thread ### Publicando um Thread Um Thread do X pode ser publicado via API. Um thread é uma publicação dividida em um conjunto de threads de resposta e associada no X a uma linha. Você pode dividir automaticamente a publicação ou especificar as [quebras de thread](/apis/post/social-networks/x-twitter#thread-breaks) no texto da publicação. ```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 } } ``` Se a publicação for enviada como um Thread do X, as analytics de publicação retornadas serão um array de Tweets, `"twitter": []`. Consulte [Resposta 200 de Analytics de publicação](/apis/analytics/post) para mais informações. #### Mídia de thread ##### Pular mídia Pule a mídia de um thread usando `null` no array. Por exemplo: `["https://site.com/image1.png", null, "https://site.com/image2.png"]` Isso colocará image1 no primeiro Tweet, nenhuma imagem no segundo Tweet e image2 no terceiro Tweet. ##### Múltiplas mídias Múltiplos objetos de mídia podem ser adicionados a um Tweet em um Thread adicionando um objeto `{}` com as URLs de mídia no array `mediaUrls`. Quaisquer chaves de objeto exclusivas podem ser usadas. Por exemplo: ```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" ] } } ``` Neste exemplo, o primeiro Tweet conterá photo-1.jpg, o segundo Tweet photo-2.jpg e photo-3.jpg, e o terceiro Tweet photo-4.jpg. #### Quebras de thread O Ayrshare divide automaticamente o texto da publicação em tweets de comprimento apropriado (> 280 caracteres). Ao criar threads, priorizamos manter frases completas em uma única publicação sempre que possível. Se uma frase não couber, dividimos entre frases. Para frases muito longas, dividimos entre palavras. Em casos raros em que uma palavra é muito longa, dividimos a própria palavra. Você também pode adicionar parágrafos manualmente com `\n\n` ao texto da publicação para indicar que um thread único deve ser criado. Se você tiver `\n\n` no texto da publicação, não dividiremos automaticamente a publicação em threads. Por exemplo: ```json Example X Thread theme={"system"} { "post": "This is tweet 1\n\nThis is tweet 2.", "platforms": ["twitter"], "twitterOptions": { "thread": true } } ``` resultará em dois Tweets no thread. Se você quiser adicionar parágrafos, mas não dividir em Tweets, use `\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á em um Tweet com dois parágrafos, já que a publicação está abaixo de 280 caracteres. ### Excluir um thread Para excluir um Tweet Storm, chame o [endpoint /post delete](/apis/post/delete-post) com o ID de publicação de nível superior retornado na resposta. Todos os threads serão excluídos. ## Limites de caracteres Consulte [Limites de caracteres do X/Twitter](/help-center/technical-support/character_limits#x%2Ftwitter-character-limits) para mais informações. ## Compatibilidade de vídeo do X Alguns softwares de vídeo criam arquivos MP4 que não são compatíveis com o X. Por exemplo, versões do Camtasia anteriores a 2019.0.9 criam arquivos MP4 que o X rejeita. Além disso, mais de uma trilha de áudio frequentemente causa problemas. Se você receber a seguinte mensagem ao publicar, isso indica que o vídeo não é compatível com o Twitter e precisa ser recodificado. `"file is currently unsupported"` Verifique a compatibilidade do seu software de vídeo. Por exemplo, o Adobe Media Encoder tem uma predefinição de exportação para Twitter 1080p Full HD. Adobe Media Encoder Consulte aqui mais [exemplos da API do X](https://www.ayrshare.com/twitter-api-how-to-post-and-get-analytics-with-the-twitter-api#twitter-api-examples). ## Somente assinantes Você pode definir que uma publicação seja visível apenas para assinantes usando o parâmetro `subscribersOnly`. ```json X Subscribers Only theme={"system"} { "twitterOptions": { "subscribersOnly": true } } ``` ## Configurações de resposta Você pode definir as configurações de resposta de uma publicação para permitir respostas apenas de certos tipos de usuários. ```json X Reply Settings theme={"system"} { "twitterOptions": { "replySettings": "mentioned" } } ``` O parâmetro `replySettings` pode ter um dos seguintes valores: