Referência completa: todos os endpoints da Sorsa

Todos os endpoints usam https://api.sorsa.io/v3 e autenticação pelo cabeçalho ApiKey. Cada chamada consome uma requisição da cota. Contas novas incluem 100 requisições gratuitas, sem cartão. A aba Endpoints inclui a referência interativa em português, com parâmetros, esquemas e exemplos. Você também pode testar pelo API Playground.

Dados de usuários

Perfis, seguidores, contas seguidas e metadados.

Endpoint	Método	Descrição	Referência
`/info`	GET	Perfil completo de uma conta: bio, contadores, verificação e avatar. Aceita `username`, `user_id` ou `user_link`.	Referência
`/info-batch`	GET	Perfis de até 100 contas por chamada. Aceita `usernames[]` ou `user_ids[]`.	Referência
`/about`	GET	Metadados: país, quantidade e data de mudanças de nome, status e início do X Premium (Blue), origem e conta afiliada.	Referência
`/followers`	GET	Seguidores paginados com perfis completos. Até 200 usuários por página.	Referência
`/follows`	GET	Contas seguidas paginadas com perfis completos. Até 200 usuários por página.	Referência
`/verified-followers`	GET	Lista paginada apenas de seguidores verificados.	Referência

Guias: Seguidores | Localização da audiência | Concorrentes

Publicações

Conteúdo, métricas, respostas, citações, repostagens, artigos e tendências.

Endpoint	Método	Descrição	Referência
`/tweet-info`	POST	Dados completos de uma publicação: texto, métricas e autor. Corpo: `tweet_link`.	Referência
`/tweet-info-bulk`	POST	Dados de até 100 publicações. Corpo: `tweet_links[]`.	Referência
`/user-tweets`	POST	Timeline paginada de um usuário. Corpo: `user_link`, `username` ou `user_id`.	Referência
`/comments`	POST	Respostas a uma publicação. Corpo: `tweet_link`; `order_by` opcional: `Relevance`, `Recency`, `Likes`.	Referência
`/quotes`	POST	Citações de uma publicação. Corpo: `tweet_link`.	Referência
`/retweeters`	POST	Usuários que repostaram; retorna perfis, não publicações. Corpo: `tweet_link`.	Referência
`/article`	POST	Conteúdo completo de um artigo do X. Corpo: `tweet_link`.	Referência
`/trends`	GET	Tendências por localização. Consulta: `woeid` (Where On Earth IDentifier).	Referência

Guias: Busca | Engajamento | Artigos | Dados históricos

Busca

Publicações, menções, perfis e informações sobre Spaces.

Endpoint	Método	Descrição	Referência
`/search-tweets`	POST	Busca com os operadores do X. Corpo: `query`, `order`, `next_cursor`.	Referência
`/mentions`	POST	Menções a uma conta com filtros de data e engajamento. Corpo: `query`, `order`, `min_likes`, `min_retweets`, `min_replies`, `since_date`, `until_date`.	Referência
`/search-users`	POST	Busca em bios, nomes públicos e nomes de usuário. Corpo: `query`.	Referência
`/spaces`	GET	Dados de um Space: metadados, criador, participantes, configurações e métricas. Consulta: `id` ou `link`.	Referência

Guias: Busca de publicações | Menções | Operadores | Público-alvo

Verificação

Confira ações de usuários em campanhas e sorteios: seguir, repostar, comentar, citar e participar de comunidades.

Endpoint	Método	Descrição	Referência
`/check-follow`	POST	Verifica se `user_2` segue `user_1` (conta seguida). Corpo: um identificador para cada lado (`username_1`/`user_id_1`/`user_link_1` e `username_2`/`user_id_2`/`user_link_2`).	Referência
`/check-comment`	GET	Verifica um comentário e retorna a publicação se encontrada. Consulta: `tweet_link` + `username`/`user_id`/`user_link`.	Referência
`/check-retweet`	POST	Verifica se um usuário repostou. Examina até 100 repostagens por requisição. Corpo: `tweet_link` + identificador do usuário.	Referência
`/check-quoted`	POST	Verifica citação ou repostagem. Retorna `status`: `quoted`, `retweet` ou `not_found`. Corpo: `tweet_link` + identificador do usuário.	Referência
`/check-community-member`	POST	Verifica participação em uma comunidade. Corpo: `community_id` + identificador do usuário.	Referência
`/check-shadowban`	GET	Verificações de visibilidade com resultados `clean`, `banned` ou `unknown`. Consulta: `username`. Confira a idade do cache em `checked_at`.	Referência

Guia: Verificação de campanhas

Comunidades

Membros, publicações e busca dentro de comunidades do X.

Endpoint	Método	Descrição	Referência
`/community-tweets`	POST	Publicações de uma comunidade. Corpo: `community_id`, `order` (`popular` ou `latest`).	Referência
`/community-search-tweets`	POST	Busca em uma comunidade. Corpo: `community_link`, `query`, `order`.	Referência
`/community-members`	POST	Membros de uma comunidade com perfis. Corpo: `community_link`.	Referência

Guia: Listas e comunidades

Listas

Perfis de membros, seguidores da lista e feed combinado.

Endpoint	Método	Descrição	Referência
`/list-members`	GET	Perfis das contas de uma lista. Consulta: `list_id`.	Referência
`/list-followers`	GET	Perfis de quem segue uma lista. Consulta: `list_link`.	Referência
`/list-tweets`	GET	Publicações recentes dos membros de uma lista. Consulta: `list_id`.	Referência

Guias: Listas e comunidades | Monitoramento em tempo real

Sorsa Score e análises de cripto

Pontuação de influência, categorias de seguidores e novas conexões entre contas cripto na base da Sorsa. Aceitam username, user_id ou user_link.

Endpoint	Método	Descrição	Referência
`/score`	GET	Sorsa Score atual, métrica de influência em cripto.	Referência
`/score-changes`	GET	Variação da pontuação na última semana e no último mês.	Referência
`/followers-stats`	GET	Seguidores por categoria: influenciadores, projetos e fundos de venture capital.	Referência
`/top-followers`	GET	20 principais seguidores por Sorsa Score; cada item inclui a pontuação.	Referência
`/top-following`	GET	20 principais contas seguidas por Sorsa Score.	Referência
`/new-followers-7d`	GET	Contas cripto que passaram a seguir o usuário nos últimos 7 dias.	Referência
`/new-following-7d`	GET	Contas cripto que o usuário começou a seguir nos últimos 7 dias.	Referência

Guia: Sorsa Score e análises de cripto

Utilitários técnicos

Conversão de IDs e consulta do consumo da chave.

Endpoint	Método	Descrição	Referência
`/username-to-id/{user_handle}`	GET	Converte nome de usuário em ID permanente.	Referência
`/id-to-username/{user_id}`	GET	Converte ID em nome de usuário atual.	Referência
`/link-to-id`	GET	Extrai ID de uma URL de perfil. Consulta: `link`.	Referência
`/key-usage-info`	GET	Consumo atual, cota restante e vencimento do saldo. Sem parâmetros.	Referência

Guias: Conversão de IDs | Preços

Modelos de dados

Os principais objetos estão abaixo. Consulte variantes, tipos e casos especiais em formato de resposta.

Objeto User

Retornado por /info, /info-batch, seguidores, contas seguidas e busca de usuários, e incluído em cada publicação como user. Alguns endpoints cripto acrescentam followerDate; /followers e /follows usam User padrão.

Campo	Tipo	Descrição
`id`	string	ID permanente (Snowflake)
`username`	string	Nome de usuário atual, sem @
`display_name`	string	Nome público do perfil
`description`	string	Bio da conta
`location`	string	Localização informada pelo usuário (texto livre)
`created_at`	string	Data e hora de criação
`followers_count`	integer	Quantidade de seguidores
`followings_count`	integer	Quantidade de contas seguidas
`favourites_count`	integer	Total de curtidas dadas pela conta
`tweets_count`	integer	Total de publicações
`media_count`	integer	Total de itens de mídia publicados
`verified`	boolean	Status de verificação (selo azul, dourado ou cinza)
`protected`	boolean	Se a conta é privada
`can_dm`	boolean	Se mensagens diretas estão abertas
`possibly_sensitive`	boolean	Se a conta tem marcação de conteúdo sensível
`profile_image_url`	string	URL do avatar
`profile_background_image_url`	string	URL do banner
`bio_urls`	string[]	URLs da bio
`pinned_tweet_ids`	string[]	IDs de publicações fixadas

Objeto Tweet

Retornado por /tweet-info, /search-tweets, /user-tweets, /comments, /quotes, /mentions, /list-tweets e endpoints de publicações de comunidades.

Campo	Tipo	Descrição
`id`	string	ID permanente (Snowflake)
`full_text`	string	Texto completo da publicação
`created_at`	string	Data e hora de criação
`lang`	string	Código do idioma detectado, como en, ja ou es
`likes_count`	integer	Total de curtidas
`retweet_count`	integer	Total de repostagens
`reply_count`	integer	Total de respostas
`quote_count`	integer	Total de citações
`bookmark_count`	integer	Total de salvamentos
`view_count`	integer	Total de visualizações
`conversation_id_str`	string	ID da publicação inicial da conversa
`in_reply_to_tweet_id`	string	ID da publicação respondida
`in_reply_to_username`	string	Nome de usuário da conta respondida
`is_reply`	boolean	Se a publicação é uma resposta
`is_quote_status`	boolean	Se a publicação cita outra
`is_replies_limited`	boolean	Se o autor restringiu as respostas
`made_with_ai`	boolean	Marcação de conteúdo criado com IA
`paid_partnership`	boolean	Parceria paga (conteúdo de marca)
`user`	User	Perfil completo do autor
`entities`	TweetEntity[]	Mídias e links anexados
`quoted_status`	Tweet	Publicação citada (objeto completo e recursivo)
`retweeted_status`	Tweet	Publicação original repostada (objeto completo e recursivo)

Objeto TweetEntity

Campo	Tipo	Descrição
`type`	string	Tipo de entidade: `photo`, `video` ou `url`
`link`	string	Link direto (URL t.co)
`preview`	string	URL da imagem de prévia ou miniatura

Padrões comuns

Autenticação: toda requisição exige ApiKey. Veja autenticação. Paginação: envie o next_cursor anterior e pare quando estiver ausente ou nulo. Consultas em lote e listas cripto como /top-followers não usam cursor. Veja paginação. Erros: retornam { "message": "..." } com códigos 400, 401, 403, 404, 429 ou 500. Veja códigos de erro. Limite: 20 requisições por segundo nos planos padrão. Veja limites. Entradas: a maioria dos endpoints de usuários aceita username, user_id ou user_link. Envie exatamente um identificador.

Próximos passos

Início rápido: primeira chamada.
Formato de resposta: tipos, nulos e esquemas.
Operadores de busca: consultas avançadas.
Otimização: lotes, deduplicação e cache.

Primeiros passos

Conceitos básicos

Guias práticos

Suporte e recursos

Guia de referência da API

Referência completa: todos os endpoints da Sorsa

Dados de usuários

Publicações

Busca

Verificação

Comunidades

Listas

Sorsa Score e análises de cripto

Utilitários técnicos

Modelos de dados

Objeto User

Objeto Tweet

Objeto TweetEntity

Padrões comuns

Próximos passos

​Referência completa: todos os endpoints da Sorsa

​Dados de usuários

​Publicações

​Busca

​Verificação

​Comunidades

​Listas

​Sorsa Score e análises de cripto

​Utilitários técnicos

​Modelos de dados

​Objeto User

​Objeto Tweet

​Objeto TweetEntity

​Padrões comuns

​Próximos passos

Referência completa: todos os endpoints da Sorsa

Dados de usuários

Publicações

Busca

Verificação

Comunidades

Listas

Sorsa Score e análises de cripto

Utilitários técnicos

Modelos de dados

Objeto User

Objeto Tweet

Objeto TweetEntity

Padrões comuns

Próximos passos