Editar Posts

Posts no X podem ser editados dentro de 30 minutos após a publicação, até 5 vezes. A API do X fornece acesso completo ao histórico de edições e aos metadados.

Regras de edição

Regra	Detalhes
Janela de tempo	30 minutos a partir do post original
Limite de edições	Máximo de 5 edições
Comportamento de ID	Cada edição cria um novo ID de post
Exclusão	Excluir qualquer versão exclui a cadeia inteira

O que não pode ser editado

Alguns tipos de post não são editáveis:

Posts promovidos (anúncios)
Posts com enquetes
Respostas a outros (não self-thread)
Reposts (Quote posts podem ser editados)
Posts de Communities
Posts colaborativos
Posts agendados

Dados de edição nas respostas

Fields padrão

Todas as respostas de post incluem edit_history_tweet_ids por padrão:

{
  "data": {
    "id": "1234567891",
    "text": "Updated text (edited)",
    "edit_history_tweet_ids": ["1234567890", "1234567891"]
  }
}

ID único = nunca editado
Múltiplos IDs = histórico de edições (mais antigo primeiro)

Edit controls

Solicite edit_controls para o status de edição:

curl "https://api.x.com/2/tweets/1234567891?tweet.fields=edit_controls" \
  -H "Authorization: Bearer $TOKEN"

Exemplo de resposta

{
  "data": {
    "id": "1234567891",
    "text": "Updated text (edited)",
    "edit_history_tweet_ids": ["1234567890", "1234567891"],
    "edit_controls": {
      "is_edit_eligible": true,
      "editable_until": "2024-01-15T12:30:00.000Z",
      "edits_remaining": 3
    }
  }
}

Field	Descrição
`is_edit_eligible`	Se o post pode ser editado
`editable_until`	Timestamp de quando a janela de edição fecha
`edits_remaining`	Número de edições restantes (0-5)

Obtendo o histórico de edições

Use a expansion edit_history_tweet_ids para obter os objetos de post completos de todas as versões:

curl "https://api.x.com/2/tweets/1234567891?\
tweet.fields=edit_controls&\
expansions=edit_history_tweet_ids" \
  -H "Authorization: Bearer $TOKEN"

Exemplo de resposta

{
  "data": {
    "id": "1234567891",
    "text": "Updated text (edited)",
    "edit_history_tweet_ids": ["1234567890", "1234567891"],
    "edit_controls": {
      "is_edit_eligible": true,
      "editable_until": "2024-01-15T12:30:00.000Z",
      "edits_remaining": 3
    }
  },
  "includes": {
    "tweets": [{
      "id": "1234567890",
      "text": "Original text (with typo)",
      "edit_history_tweet_ids": ["1234567890", "1234567891"],
      "edit_controls": {
        "is_edit_eligible": true,
        "editable_until": "2024-01-15T12:30:00.000Z",
        "edits_remaining": 3
      }
    }]
  }
}

Qual versão é retornada?

Por padrão, a API retorna a versão mais recente de um post editado. Para obter uma versão específica, solicite-a diretamente pelo ID do post:

# Get original version
curl "https://api.x.com/2/tweets/1234567890" -H "Authorization: Bearer $TOKEN"

# Get edited version  
curl "https://api.x.com/2/tweets/1234567891" -H "Authorization: Bearer $TOKEN"

Métricas para posts editados

Cada versão de um post editado tem suas próprias métricas de engajamento. As métricas são atribuídas à versão que estava visível quando o engajamento ocorreu.

Disponibilidade

Os metadados de edição estão disponíveis:

Para todos os posts criados desde 29 de setembro de 2022
Em todos os endpoints v2 que retornam posts
Incluindo search, timelines, stream e lookup

Posts criados antes dessa data não têm metadados de edição.

Casos de uso

Rastrear mudanças
Exibir indicador de edição
Obter conteúdo original

Monitore posts em busca de edições e registre as diferenças:

def check_for_edits(post):
    history = post.get("edit_history_tweet_ids", [])
    if len(history) > 1:
        print(f"Post {post['id']} has been edited {len(history) - 1} times")

Exiba um selo de “edited” na sua UI:

const isEdited = post.edit_history_tweet_ids?.length > 1;
if (isEdited) {
  showEditedBadge();
}

Recupere a versão original de um post editado:

original_id = post["edit_history_tweet_ids"][0]
original = api.get_tweet(original_id)

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Editar Posts

Regras de edição

O que não pode ser editado

Dados de edição nas respostas

Fields padrão

Edit controls

Obtendo o histórico de edições

Qual versão é retornada?

Métricas para posts editados

Disponibilidade

Casos de uso

Próximos passos

Consulta de posts

Dicionário de dados

​Regras de edição

​O que não pode ser editado

​Dados de edição nas respostas

​Fields padrão

​Edit controls

​Obtendo o histórico de edições

​Qual versão é retornada?

​Métricas para posts editados

​Disponibilidade

​Casos de uso

​Próximos passos

Consulta de posts

Dicionário de dados

Regras de edição

O que não pode ser editado

Dados de edição nas respostas

Fields padrão

Edit controls

Obtendo o histórico de edições

Qual versão é retornada?

Métricas para posts editados

Disponibilidade

Casos de uso

Próximos passos