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
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
/fetch-popular-communities Buscar Comunidades Populares
Parâmetros
| Nome | Tipo | Localização | Obrigatório | Descrição |
|---|---|---|---|---|
| topicId | string | query | Sim | ID do Tópico |
| 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/fetch-popular-communities?topicId=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
/jobs-search Busca de Vagas
Parâmetros
| Nome | Tipo | Localização | Obrigatório | Descrição |
|---|---|---|---|---|
| employment_type | string | query | Sim | Tipo de Emprego |
| job_location_id | string | query | Sim | ID da Localização da Vaga |
| job_location_type | string | query | Sim | Tipo de Localização da Vaga |
| keyword | string | query | Sim | Palavra-chave |
| seniority_level | string | query | Sim | Nível de Senioridade |
| 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-search?employment_type=VALUE&job_location_id=VALUE&job_location_type=VALUE&keyword=VALUE&seniority_level=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 Pesquisa
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/search?query=VALUE&type=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
/trends Tendências
Parâmetros
| Nome | Tipo | Localização | Obrigatório | Descrição |
|---|---|---|---|---|
| woeid | string | query | Sim | Woeid |
| 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/trends?woeid=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID" Respostas
200 Sucesso
GET
/trends-locations Localizações de Tendências
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/trends-locations" -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