Comparando os endpoints de timelines da X API
Os endpoints da v2 reverse chronological timeline, user Posts timeline e user mention timeline substituem os endpoints v1.1 statuses/home_timeline, v1.1 statuses/user_timeline e v1.1 statuses/mentions_timeline, respectivamente. Se você tem código, apps ou ferramentas que usam uma versão mais antiga deste endpoint e está considerando migrar para o endpoint mais novo da X API v2, este guia é para você. Para um guia de migração mais aprofundado, consulte Migração do Standard v1.1 para X API v2. Esta página contém três tabelas de comparação:- Home timeline em ordem cronológica reversa
- Timeline de Posts do usuário
- Timeline de menções do usuário
Home timeline em ordem cronológica reversa
As tabelas a seguir comparam os endpoints de home timeline do standard v1.1 e da X API v2:| Descrição | Standard v1.1 | X API v2 |
| Documentação | Referência da API | Referência da API |
| Métodos HTTP suportados | GET | GET |
| Domínio do host | https://api.x.com | https://api.x.com |
| Caminhos do endpoint | /1.1/statuses/home_timeline.json | /2/users/:id/timelines/reverse_chronological |
| Parâmetros obrigatórios | user_id ou screen_name | ID de usuário definido como parâmetro de caminho :id |
| Autenticação | OAuth 1.0a User Context | OAuth 1.0a User Context OAuth 2.0 Authorization Code Flow com PKCE |
| Rate limits de requisição | 15 requisições por 15 minutos com OAuth 1.0a User Context Limite de requisições: 100.000 em um período de 24 horas. | 180 requisições por janela de 15 minutos |
| Posts padrão por resposta | 15 | 100 |
| Máximo de Posts por resposta | 800 | Este endpoint retorna todos os Posts criados em uma timeline nos últimos 7 dias, bem como os 800 mais recentes, independentemente da data de criação. |
| Fornece histórico de edições de Post | ✔ | ✔ |
| Posts históricos disponíveis | Os 800 Posts mais recentes, incluindo Retweets | Os 3.200 Posts mais recentes, incluindo Retweets |
| Opções de navegação na timeline | since_id (exclusivo) usado para polling de atualizaçãomax_id (inclusivo) | start_timeend_time since_id(exclusivo) usado para polling de atualização until_id (exclusivo) |
| Parâmetros opcionais para refinamento de resultados | countexclude_repliesinclude_rtstrim_usertweet_modesince_idmax_id | max_resultsexclude(retweets,replies)tweet.fieldsuser.fieldsplace.fieldsmedia.fieldspoll.fieldsexpansionsstart_timeend_timesince_iduntil_id |
| Suporta solicitar e receber annotations | N/A | Se annotations forem incluídas em tweet.fields, os resultados serão anotados com dados de annotation inferidos com base no texto do Post, como ‘Music Genre’ e ‘Folk Music’ ou ‘Musician’ e ‘Dolly Parton’ |
| Suporta solicitar e receber metrics específicas de Post | N/A | Se annotations forem incluídas em tweet.fields, os resultados serão anotados com public_metrics por Post incluindo retweet_count, reply_count, quote_count, like_count, impression_count e bookmark_count, non_public_metrics incluindo impression_count, user_profile_clicks, url_link_clicks e engagements.Métricas de mídia adicionais como view_count e métricas de playback de vídeo. Métricas organic_metrics e promoted_metrics adicionais disponíveis com User Context para Posts promovidos. |
| Suporta solicitar e receber conversation_id | N/A | Retorna um field conversation_id em que o valor representa o primeiro Post publicado em um thread de reply para ajudar você a acompanhar conversas. |
| Formato JSON do Post | Formato de dados Standard v1.1 | Formato X API v2 (determinado pelos parâmetros de requisição fields e expansions, não compatível com versões anteriores do v1.1) Para saber mais sobre como migrar do formato Standard v1.1 para o formato X API v2, visite nosso guia de migração de formatos de dados. |
| Ordem dos resultados | Cronológica reversa | Cronológica reversa |
| Paginação de resultados | N/A, deve usar navegação por ID de Post | Os resultados podem ser revisados avançando ou retrocedendo usando um pagination_token |
| Requer o uso de credenciais de um App de desenvolvedor associado a um Project | ✔ |
Timeline de Posts do usuário
As tabelas a seguir comparam os endpoints de user Post timeline do standard v1.1 e da X API v2:| Descrição | Standard v1.1 | X API v2 |
| Documentação | Referência da API | Referência da API |
| Métodos HTTP suportados | GET | GET |
| Domínio do host | https://api.x.com | https://api.x.com |
| Caminhos do endpoint | /1.1/statuses/user_timeline.json | /2/users/:id/tweets |
| Parâmetros obrigatórios | user_id ou screen_name | ID de usuário definido como parâmetro de caminho :id |
| Autenticação | OAuth 1.0a User Context OAuth 2.0 App-Only | OAuth 1.0a User Context OAuth 2.0 App-Only OAuth 2.0 Authorization Code com PKCE |
| Rate limits de requisição | 900 requisições por 15 min com OAuth 1.0a User Context 1500 requisições por 15 min com OAuth 2.0 App-Only Limite de requisições: 100.000 em um período de 24 horas. | 900 requisições por janela de 15 minutos com OAuth 1.0a User Context 1500 requisições por janela de 15 minutos com OAuth 2.0 App-Only |
| Posts padrão por resposta | 15 | 10 |
| Máximo de Posts por resposta | 200 | 100 |
| Posts históricos disponíveis | Os 3.200 Posts mais recentes, incluindo Retweets | Os 3.200 Posts mais recentes, incluindo Retweets |
| Opções de navegação na timeline | since_id (exclusivo) usado para polling de atualização max_id (inclusivo) | start_time end_time since_id (exclusivo) usado para polling de atualização until_id (exclusivo) |
| Parâmetros opcionais para refinamento de resultados | count exclude_replies include_rts trim_user tweet_mode since_id max_id | max_results exclude(retweets,replies) tweet.fields user.fields place.fields media.fields poll.fields expansions start_time end_time since_id until_id |
| Suporta solicitar e receber annotations | N/A | Retorna resultados de Post com dados de annotation inferidos com base no texto do Post, como ‘Music Genre’ e ‘Folk Music’ ou ‘Musician’ e ‘Dolly Parton’ |
| Suporta solicitar e receber metrics específicas de Post | N/A | Retorna resultados de Post com public_metrics disponíveis por Post, incluindo retweet_count, reply_count, quote_count e like_count. Disponível com OAuth1.0a User Context: non_public_metrics adicionais, incluindo impression_count, user_profile_clicks, url_link_clicks. Métricas de mídia adicionais como view_count e métricas de playback de vídeo. organic_metrics e promoted_metrics adicionais disponíveis com OAuth 1.0a User Context para Posts promovidos. |
| Suporta solicitar e receber conversation_id | N/A | Retorna um field conversation_id em que o valor representa o primeiro Post publicado em um thread de reply para ajudar você a acompanhar conversas. |
| Formato JSON do Post | Formato de dados Standard v1.1 | Formato X API v2 (determinado pelos parâmetros de requisição fields e expansions, não compatível com versões anteriores do v1.1) Para saber mais sobre como migrar do formato Standard v1.1 para o formato X API v2, visite nosso guia de migração de formatos de dados. |
| Ordem dos resultados | Cronológica reversa | Cronológica reversa |
| Paginação de resultados | N/A, deve usar navegação por ID de Post | Os resultados podem ser revisados avançando ou retrocedendo usando um pagination_token |
| Requer o uso de credenciais de um App de desenvolvedor associado a um Project | ✔ | |
| Fornece histórico de edições de Post | ✔ | ✔ |
Timeline de menções do usuário
As tabelas a seguir comparam os endpoints de user mention timeline do standard v1.1 e da X API v2| Descrição | Standard v1.1 | X API v2 |
| Documentação | Referência da API | Referência da API |
| Métodos HTTP suportados | GET | GET |
| Domínio do host | https://api.x.com | https://api.x.com |
| Caminhos do endpoint | /1.1/statuses/mentions_timeline.json | /2/users/:id/mentions |
| Parâmetros obrigatórios | sem parâmetros obrigatórios | ID de usuário definido como parâmetro de caminho :id |
| Autenticação | OAuth 1.0a User Context | OAuth 1.0a User Context OAuth 2.0 App-Only OAuth 2.0 Authorization Code com PKCE |
| Rate limits padrão de requisição | 75 requisições por 15 min com OAuth 1.0a User Context Limite de 100.000 requisições em um período de 24 horas. | 180 requisições por janela de 15 minutos com OAuth 1.0a User Context 450 requisições por janela de 15 minutos com OAuth 2.0 App-Only |
| Posts padrão por resposta | 15 | 10 |
| Máximo de Posts por resposta | 200 | 100 |
| Posts históricos disponíveis | Os 800 Posts mais recentes | Os 800 Posts mais recentes |
| Opções de navegação na timeline | since_id (exclusivo) usado para polling de atualização max_id (inclusivo) | start_time end_time since_id (exclusivo) usado para polling de atualização until_id (exclusivo) |
| Parâmetros opcionais para refinamento de resultados | count trim_user include_entities tweet_mode since_id max_id | max_results tweet.fields user.fields place.fields media.fields poll.fields expansions start_time end_time since_id until_id |
| Suporta solicitar e receber annotations | N/A | Retorna resultados de Posts com dados de annotation inferidos com base no texto do Post, como ‘Music Genre’ e ‘Folk Music’ ou ‘Musician’ e ‘Dolly Parton’ |
| Suporta solicitar e receber metrics específicas de Post | N/A | Retorna resultados de Post com public_metrics disponíveis por Post, incluindo retweet_count, reply_count, quote_count e like_count. Disponível com OAuth 1.0a User Context: non_public_metrics adicionais, incluindo impression_count, user_profile_clicks, url_link_clicks. Métricas de mídia adicionais como view_count e métricas de playback de vídeo. organic_metrics e promoted_metrics adicionais disponíveis com OAuth 1.0a User Context para Posts promovidos |