> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sorsa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Casos de uso

A Sorsa oferece acesso somente de leitura a dados públicos do X (antigo Twitter): publicações, perfis, redes de seguidores, métricas de engajamento, comunidades e mais. Use este mapa para encontrar os endpoints e guias adequados.

## Escuta social e monitoramento de marcas

Acompanhe conversas sobre sua marca, produto ou setor em tempo real. Identifique sentimento negativo, meça o impacto de campanhas e entenda a percepção pública.

* `/search-tweets`: busque palavras-chave, hashtags ou frases em publicações públicas.
* `/mentions`: monitore marcações de uma conta com filtros de engajamento.
* `/list-tweets`: monitore várias contas por listas do X.

**Guias:** [Busca de publicações](https://docs.sorsa.io/pt-BR/search-tweets) | [Menções](https://docs.sorsa.io/pt-BR/search-mentions) | [Monitoramento em tempo real](https://docs.sorsa.io/pt-BR/real-time-monitoring) | [Operadores](https://docs.sorsa.io/pt-BR/search-operators)

## Inteligência competitiva

Compare perfis, estratégias de conteúdo, composição da audiência e o que as pessoas dizem sobre concorrentes.

* `/info` e `/info-batch`: retratos dos perfis, com seguidores, publicações e bio.
* `/user-tweets`: timelines para analisar temas e publicações de melhor desempenho.
* `/mentions`: opiniões sobre um concorrente, filtradas por engajamento.
* `/followers` e `/verified-followers`: análise de seguidores.
* `/score`: influência no ecossistema cripto/Web3.

**Guias:** [Análise de concorrentes](https://docs.sorsa.io/pt-BR/Competitor-Analysis) | [Seguidores](https://docs.sorsa.io/pt-BR/followers-and-following) | [Sorsa Score](https://docs.sorsa.io/pt-BR/sorsa-score-and-crypto-analytics)

## Geração de leads e descoberta de audiência

Encontre clientes, parceiros ou membros de comunidades por perfis, seguidores de contas relevantes, comunidades temáticas e conversas sobre problemas que seu produto resolve.

* `/search-users`: palavras-chave na bio, cargos, interesses e nichos.
* `/followers`: seguidores de concorrentes ou líderes do setor.
* `/community-members`: membros de comunidades temáticas.
* `/search-tweets`: pessoas que discutem temas relevantes.

**Guias:** [Descoberta do público-alvo](https://docs.sorsa.io/pt-BR/target-audiences-Discovery) | [Seguidores](https://docs.sorsa.io/pt-BR/followers-and-following) | [Listas e comunidades](https://docs.sorsa.io/pt-BR/lists-and-communities)

## Campanhas de marketing e sorteios

Verifique se cada participante concluiu as ações exigidas antes de distribuir recompensas.

* `/check-follow`: seguiu sua conta?
* `/check-retweet`: repostou a publicação?
* `/check-comment`: comentou?
* `/check-quoted`: citou?
* `/check-community-member`: entrou na comunidade?

**Guia:** [Verificação de campanhas](https://docs.sorsa.io/pt-BR/Marketing-Campaign-Verification)

## Pesquisa histórica e coleta de dados

Consulte publicações públicas desde 2006 para analisar eventos, montar conjuntos de treinamento, estudar a evolução de conversas ou auditar o histórico de uma marca.

* `/search-tweets` com `since:` e `until:`: busca em um período histórico.
* `/user-tweets`: paginação da timeline completa.
* `/tweet-info-bulk`: atualize uma lista de IDs com dados de engajamento atuais.

**Guias:** [Dados históricos](https://docs.sorsa.io/pt-BR/historical-data) | [Operadores de busca](https://docs.sorsa.io/pt-BR/search-operators)

## Monitoramento em tempo real e alertas

Detecte novas publicações por conta ou palavra-chave e encaminhe alertas a Slack, Discord, bancos de dados ou webhooks.

* `/list-tweets`: até 5.000 contas em uma lista, com uma chamada por ciclo.
* `/user-tweets`: uma conta prioritária.
* `/search-tweets` com `order: "latest"`: palavras-chave ou hashtags.
* `/mentions`: novas @menções.

**Guia:** [Monitoramento em tempo real](https://docs.sorsa.io/pt-BR/real-time-monitoring)

## Análise de publicações

Analise quem respondeu, citou ou repostou e o que foi dito. Meça alcance, identifique comentaristas relevantes e compare o desempenho.

* `/tweet-info` e `/tweet-info-bulk`: métricas completas individuais ou em lote.
* `/comments`: respostas.
* `/quotes`: citações.
* `/retweeters`: usuários que repostaram.
* `/article`: conteúdo completo de artigos longos do X.

**Guias:** [Engajamento](https://docs.sorsa.io/pt-BR/tweet-engagement) | [Artigos do X](https://docs.sorsa.io/pt-BR/x-articles)

## Localização e demografia da audiência

Mapeie seguidores por país para segmentar anúncios, avaliar influenciadores ou pesquisar novos mercados.

* `/followers`: lista de seguidores.
* `/about`: país associado a cada conta.

**Guia:** [Localização da audiência](https://docs.sorsa.io/pt-BR/Audience-Geography)

## Análises de cripto e Web3

Avalie a influência de contas cripto pelo sistema da Sorsa, que mede reconhecimento por influenciadores, projetos e fundos. Acompanhe tendências de pontuação, projetos emergentes e crescimento inorgânico.

* `/score` e `/score-changes`: pontuação e variações semanais/mensais.
* `/followers-stats`: categorias de seguidores.
* `/top-followers` e `/top-following`: top 20 por pontuação.
* `/new-followers-7d` e `/new-following-7d`: novas conexões entre contas cripto.

**Guia:** [Sorsa Score e análises de cripto](https://docs.sorsa.io/pt-BR/sorsa-score-and-crypto-analytics)

## Dados para treinamento de IA e LLMs

Colete publicações para ajuste fino de modelos, classificação de sentimento ou pipelines RAG. As respostas JSON podem ser integradas diretamente aos fluxos de aprendizado de máquina.

* `/search-tweets`: temas, idiomas e períodos.
* `/user-tweets`: timelines para montar o corpus.
* `/comments` e `/quotes`: conversas, perguntas e respostas e debates.

**Guias:** [Busca](https://docs.sorsa.io/pt-BR/search-tweets) | [Dados históricos](https://docs.sorsa.io/pt-BR/historical-data) | [Otimização](https://docs.sorsa.io/pt-BR/optimizing-api-usage)

## Desenvolvimento de SaaS e plataformas de análise

Crie ferramentas, painéis ou plataformas de monitoramento sobre os dados da Sorsa. A cobrança uniforme por chamada e o limite de 20 req/s permitem atender vários usuários com uma chave. Todos os endpoints estão disponíveis em todos os planos; veja a [referência](https://docs.sorsa.io/pt-BR/api-reference-guide).

**Guias:** [Otimização](https://docs.sorsa.io/pt-BR/optimizing-api-usage) | [Preços](https://docs.sorsa.io/pt-BR/pricing) | [Limites](https://docs.sorsa.io/pt-BR/rate-limits)

## Encontre o endpoint

| Preciso de...                              | Endpoint                   | Guia                                                                                                 |
| :----------------------------------------- | :------------------------- | :--------------------------------------------------------------------------------------------------- |
| Publicações com uma palavra-chave          | `/search-tweets`           | [Busca de publicações](https://docs.sorsa.io/pt-BR/search-tweets)                                    |
| Menções a uma conta                        | `/mentions`                | [Monitoramento de menções](https://docs.sorsa.io/pt-BR/search-mentions)                              |
| Dados de perfil de um usuário              | `/info` ou `/info-batch`   | [Guia de referência da API](https://docs.sorsa.io/pt-BR/api-reference-guide)                         |
| Seguidores de uma conta                    | `/followers`               | [Seguidores e contas seguidas](https://docs.sorsa.io/pt-BR/followers-and-following)                  |
| Contas que um usuário segue                | `/follows`                 | [Seguidores e contas seguidas](https://docs.sorsa.io/pt-BR/followers-and-following)                  |
| Histórico de publicações de um usuário     | `/user-tweets`             | [Dados históricos](https://docs.sorsa.io/pt-BR/historical-data)                                      |
| Respostas a uma publicação                 | `/comments`                | [Engajamento com publicações](https://docs.sorsa.io/pt-BR/tweet-engagement)                          |
| Citações de uma publicação                 | `/quotes`                  | [Engajamento com publicações](https://docs.sorsa.io/pt-BR/tweet-engagement)                          |
| Quem repostou uma publicação               | `/retweeters`              | [Engajamento com publicações](https://docs.sorsa.io/pt-BR/tweet-engagement)                          |
| Métricas completas de uma publicação       | `/tweet-info`              | [Engajamento com publicações](https://docs.sorsa.io/pt-BR/tweet-engagement)                          |
| Métricas de 100 publicações de uma vez     | `/tweet-info-bulk`         | [Otimização do uso da API](https://docs.sorsa.io/pt-BR/optimizing-api-usage)                         |
| Publicações de uma lista do X              | `/list-tweets`             | [Listas e comunidades](https://docs.sorsa.io/pt-BR/lists-and-communities)                            |
| Membros de uma lista do X                  | `/list-members`            | [Listas e comunidades](https://docs.sorsa.io/pt-BR/lists-and-communities)                            |
| Membros de uma comunidade                  | `/community-members`       | [Listas e comunidades](https://docs.sorsa.io/pt-BR/lists-and-communities)                            |
| Publicações de uma comunidade              | `/community-tweets`        | [Listas e comunidades](https://docs.sorsa.io/pt-BR/lists-and-communities)                            |
| Se um usuário segue uma conta              | `/check-follow`            | [Verificação de campanhas de marketing](https://docs.sorsa.io/pt-BR/Marketing-Campaign-Verification) |
| Se um usuário repostou                     | `/check-retweet`           | [Verificação de campanhas de marketing](https://docs.sorsa.io/pt-BR/Marketing-Campaign-Verification) |
| Se um usuário comentou                     | `/check-comment`           | [Verificação de campanhas de marketing](https://docs.sorsa.io/pt-BR/Marketing-Campaign-Verification) |
| Se um usuário citou                        | `/check-quoted`            | [Verificação de campanhas de marketing](https://docs.sorsa.io/pt-BR/Marketing-Campaign-Verification) |
| Participação em uma comunidade             | `/check-community-member`  | [Verificação de campanhas de marketing](https://docs.sorsa.io/pt-BR/Marketing-Campaign-Verification) |
| País de uma conta                          | `/about`                   | [Localização da audiência](https://docs.sorsa.io/pt-BR/Audience-Geography)                           |
| Sorsa Score (influência em cripto)         | `/score`                   | [Sorsa Score e análises de cripto](https://docs.sorsa.io/pt-BR/sorsa-score-and-crypto-analytics)     |
| Nome de usuário para ID                    | `/username-to-id`          | [Conversão de IDs](https://docs.sorsa.io/pt-BR/ID-Conversion)                                        |
| ID para nome de usuário                    | `/id-to-username`          | [Conversão de IDs](https://docs.sorsa.io/pt-BR/ID-Conversion)                                        |
| URL de perfil para ID                      | `/link-to-id`              | [Conversão de IDs](https://docs.sorsa.io/pt-BR/ID-Conversion)                                        |
| Consumo da chave de API                    | `/key-usage-info`          | [Preços](https://docs.sorsa.io/pt-BR/pricing)                                                        |
| Conteúdo de um artigo do X                 | `/article`                 | [Artigos do X](https://docs.sorsa.io/pt-BR/x-articles)                                               |
| Usuários com uma palavra-chave na bio      | `/search-users`            | [Descoberta do público-alvo](https://docs.sorsa.io/pt-BR/target-audiences-Discovery)                 |
| Seguidores verificados de uma conta        | `/verified-followers`      | [Seguidores e contas seguidas](https://docs.sorsa.io/pt-BR/followers-and-following)                  |
| Seguidores de uma lista do X               | `/list-followers`          | [Listas e comunidades](https://docs.sorsa.io/pt-BR/lists-and-communities)                            |
| Busca de publicações em uma comunidade     | `/community-search-tweets` | [Listas e comunidades](https://docs.sorsa.io/pt-BR/lists-and-communities)                            |
| Seguidores por categoria                   | `/followers-stats`         | [Sorsa Score e análises de cripto](https://docs.sorsa.io/pt-BR/sorsa-score-and-crypto-analytics)     |
| Evolução da pontuação                      | `/score-changes`           | [Sorsa Score e análises de cripto](https://docs.sorsa.io/pt-BR/sorsa-score-and-crypto-analytics)     |
| Principais seguidores por Sorsa Score      | `/top-followers`           | [Sorsa Score e análises de cripto](https://docs.sorsa.io/pt-BR/sorsa-score-and-crypto-analytics)     |
| Principais contas seguidas por Sorsa Score | `/top-following`           | [Sorsa Score e análises de cripto](https://docs.sorsa.io/pt-BR/sorsa-score-and-crypto-analytics)     |
| Novos seguidores nos últimos 7 dias        | `/new-followers-7d`        | [Sorsa Score e análises de cripto](https://docs.sorsa.io/pt-BR/sorsa-score-and-crypto-analytics)     |
| Novas contas seguidas nos últimos 7 dias   | `/new-following-7d`        | [Sorsa Score e análises de cripto](https://docs.sorsa.io/pt-BR/sorsa-score-and-crypto-analytics)     |

## Não sabe por onde começar?

1. **Obtenha sua chave** pelo [início rápido](https://docs.sorsa.io/pt-BR/quickstart). Cada conta inclui 100 requisições gratuitas, sem cartão e sem validade.
2. **Teste uma busca:** execute no terminal para ver dados em segundos.

```bash theme={null}
curl -X POST https://api.sorsa.io/v3/search-tweets \
  -H "ApiKey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "your topic here", "order": "popular"}'
```

3. **Explore sem código** no [API Playground](https://api.sorsa.io/playground).
4. **Escolha um guia** acima para seu caso de uso.
5. **Estime os custos** na página de [preços](https://docs.sorsa.io/pt-BR/pricing).