API

X (Twitter) API

X alcança cerca de 600 milhões de usuários mensais através de postagens curtas, comentários ao vivo, vídeos e conversas sobre notícias de última hora, tornando-se importante para comunicações em tempo real, visibilidade na mídia e resposta a reputação.

Referência da API Versão: 1.0.0 38 Pontos finais Autenticação
X

URL base

https://api.pressmonitor.com

Autenticação

Todas as requisições usam autenticação por token Bearer. Adicione o cabeçalho Authorization a cada chamada.

Authorization: Bearer YOUR_API_KEY
x-subscription-id: YOUR_SUB_ID
GET /autocomplete

Autocompletar

Parâmetros

Nome Tipo Localização Obrigatório Descrição
value string query Sim Valor
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/autocomplete?value=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /comments

Comentários

Parâmetros

Nome Tipo Localização Obrigatório Descrição
pid string query Sim Pid
ranking_mode string query Sim Modo de Ranking
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/comments?pid=VALUE&ranking_mode=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /community-topics

Tópicos da Comunidade

Parâmetros

Nome Tipo Localização Obrigatório Descrição
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/community-topics" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /community-tweets

Tweets da Comunidade

Parâmetros

Nome Tipo Localização Obrigatório Descrição
communityId string query Sim ID da Comunidade
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/community-tweets?communityId=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /followers

Seguidores

Parâmetros

Nome Tipo Localização Obrigatório Descrição
user string query Sim ID numérico do usuário (não nome de usuário). Use o endpoint 'user' para consultar o ID a partir do nome de usuário
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/followers?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /followers-ids

IDs dos Seguidores

Parâmetros

Nome Tipo Localização Obrigatório Descrição
username string query Sim Nome de usuário (screen name sem o símbolo @, ex: 'elonmusk')
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/followers-ids?username=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /followings

Seguindo

Parâmetros

Nome Tipo Localização Obrigatório Descrição
user string query Sim ID numérico do usuário (não nome de usuário). Use o endpoint 'user' para consultar o ID a partir do nome de usuário
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/followings?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /followings-ids

IDs dos Seguidos

Parâmetros

Nome Tipo Localização Obrigatório Descrição
username string query Sim Nome de usuário (screen name sem o símbolo @, ex: 'elonmusk')
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/followings-ids?username=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /get-users

Obter Usuários

Parâmetros

Nome Tipo Localização Obrigatório Descrição
users string query Sim Usuários
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/get-users?users=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /group-tweets

Agrupar Tweets

Parâmetros

Nome Tipo Localização Obrigatório Descrição
communityId string query Sim ID da Comunidade
rankingMode string query Sim Modo de Ranking
searchType string query Sim Tipo de Pesquisa
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/group-tweets?communityId=VALUE&rankingMode=VALUE&searchType=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /highlights

Destaques

Parâmetros

Nome Tipo Localização Obrigatório Descrição
user string query Sim ID numérico do usuário (não nome de usuário). Use o endpoint 'user' para consultar o ID a partir do nome de usuário
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/highlights?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /jobs-details

Detalhes de Vagas

Parâmetros

Nome Tipo Localização Obrigatório Descrição
jobId string query Sim ID da Vaga
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/jobs-details?jobId=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /jobs-locations-suggest

Sugestão de Localizações para Vagas

Parâmetros

Nome Tipo Localização Obrigatório Descrição
query string query Sim Consulta de pesquisa
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/jobs-locations-suggest?query=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /likes

Curtidas

Parâmetros

Nome Tipo Localização Obrigatório Descrição
pid string query Sim Pid
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/likes?pid=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /list-details

Detalhes da Lista

Parâmetros

Nome Tipo Localização Obrigatório Descrição
listId string query Sim ID da Lista
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/list-details?listId=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /list-timeline

Linha do Tempo da Lista

Parâmetros

Nome Tipo Localização Obrigatório Descrição
listId string query Sim ID da Lista
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/list-timeline?listId=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /list-tweets

Tweets da Lista

Parâmetros

Nome Tipo Localização Obrigatório Descrição
list_id string query Sim ID da Lista
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/list-tweets?list_id=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /org-affiliates

Afiliados da Organização

Parâmetros

Nome Tipo Localização Obrigatório Descrição
user string query Sim ID numérico do usuário (não nome de usuário). Use o endpoint 'user' para consultar o ID a partir do nome de usuário
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/org-affiliates?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /quotes

Citações

Parâmetros

Nome Tipo Localização Obrigatório Descrição
pid string query Sim Pid
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/quotes?pid=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /retweets

Retweets

Parâmetros

Nome Tipo Localização Obrigatório Descrição
pid string query Sim Pid
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/retweets?pid=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /search-community

Buscar Comunidade

Parâmetros

Nome Tipo Localização Obrigatório Descrição
query string query Sim Consulta de pesquisa
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/search-community?query=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /search-lists

Buscar Listas

Parâmetros

Nome Tipo Localização Obrigatório Descrição
query string query Sim Consulta de pesquisa
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/search-lists?query=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /searchold

Pesquisar antigo

Parâmetros

Nome Tipo Localização Obrigatório Descrição
query string query Sim Consulta de pesquisa
type string query Sim Tipo
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/searchold?query=VALUE&type=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /spaces

Spaces

Parâmetros

Nome Tipo Localização Obrigatório Descrição
id string query Sim ID
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/spaces?id=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /tweet

Tweet

Parâmetros

Nome Tipo Localização Obrigatório Descrição
pid string query Sim Pid
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/tweet?pid=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /tweet-by-ids

Tweet por IDs

Parâmetros

Nome Tipo Localização Obrigatório Descrição
tweetIDs string query Sim IDs dos Tweets
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/tweet-by-ids?tweetIDs=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /user

Usuário

Parâmetros

Nome Tipo Localização Obrigatório Descrição
username string query Sim Nome de usuário (screen name sem o símbolo @, ex: 'elonmusk')
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/user?username=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /user-likes

Curtidas do Usuário

Parâmetros

Nome Tipo Localização Obrigatório Descrição
user string query Sim ID numérico do usuário (não nome de usuário). Use o endpoint 'user' para consultar o ID a partir do nome de usuário
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/user-likes?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /user-media

Mídia do Usuário

Parâmetros

Nome Tipo Localização Obrigatório Descrição
cusor string query Sim Cursor
user string query Sim ID numérico do usuário (não nome de usuário). Use o endpoint 'user' para consultar o ID a partir do nome de usuário
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/user-media?cusor=VALUE&user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /user-replies

Respostas do Usuário

Parâmetros

Nome Tipo Localização Obrigatório Descrição
user string query Sim ID numérico do usuário (não nome de usuário). Use o endpoint 'user' para consultar o ID a partir do nome de usuário
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/user-replies?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /user-replies-v2

Respostas do Usuário V2

Parâmetros

Nome Tipo Localização Obrigatório Descrição
user string query Sim ID numérico do usuário (não nome de usuário). Use o endpoint 'user' para consultar o ID a partir do nome de usuário
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/user-replies-v2?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /user-tweets

Tweets do Usuário

Parâmetros

Nome Tipo Localização Obrigatório Descrição
user string query Sim ID numérico do usuário (não nome de usuário). Use o endpoint 'user' para consultar o ID a partir do nome de usuário
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/user-tweets?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso
GET /verified-followers

Seguidores Verificados

Parâmetros

Nome Tipo Localização Obrigatório Descrição
user string query Sim ID numérico do usuário (não nome de usuário). Use o endpoint 'user' para consultar o ID a partir do nome de usuário
count integer query Não Número de resultados a retornar
cursor integer query Não Cursor de paginação para a próxima página

Exemplos de Código

curl -X GET "https://api.pressmonitor.com/verified-followers?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Respostas

200 Sucesso