A API do Twitter da TweetScout agora é a Sorsa API v3

#O que aconteceu com a API da TweetScout

A API da TweetScout foi renomeada para Sorsa API em 2025 pela equipe que a mantém na Scouts Labs Inc desde 2022, e a versão da era TweetScout, a v2, foi desativada em 1º de maio de 2026 (abre em uma nova aba). Todo endpoint da v2 agora retorna 410 Gone, e o código que ainda aponta para api.tweetscout.io/v2 chama essa mesma versão desativada.

O produto se dividiu conforme os dois públicos. O app de análise cripto virou o app da Sorsa em sorsa.io (abre em uma nova aba), para onde tweetscout.io e app.tweetscout.io agora redirecionam, e a API para desenvolvedores virou a Sorsa API em api.sorsa.io. O score da TweetScout manteve o método com um novo nome, o Sorsa Score, e os endpoints dele fazem parte da v3. O guia da Sorsa Score API cobre os níveis e como o score é construído.

Buscas por "Tweet Scout" e "Twitter Scout" levam ao mesmo produto. O que mudou para o código foi a versão: a v3 mantém as funções da TweetScout, renomeia alguns caminhos e parâmetros e acrescenta 20 endpoints que a API antiga nunca teve, num total de 45.

#Migre uma chamada da TweetScout para a Sorsa API v3 em quatro passos

Toda chamada da TweetScout migra com as mesmas quatro edições, e a maioria é de uma linha cada. Para uma integração da TweetScout, a Sorsa API v3 é a sucessora direta: 25 caminhos da v3 fazem as funções antigas, a chave continua no header ApiKey e todos os planos rodam a 20 requisições por segundo.

1. Pegue uma chave da v3. Cadastre-se e copie uma chave em API Keys no painel. GET /key-usage-info (abre em uma nova aba) confirma que ela funciona e mostra as requisições restantes, e nunca conta contra elas.

2. Troque a URL base. Substitua https://api.tweetscout.io/v2 ou https://api.sorsa.io/v2 por https://api.sorsa.io/v3 em todo o seu código.

3. Tire handles e IDs do caminho. A TweetScout colocava a conta no caminho (/score/{user_handle}, /info-id/{user_id}). A v3 a recebe como parâmetro de query: username, user_id ou user_link, exatamente um deles.

   curl "https://api.tweetscout.io/v2/score/orbit_dao_watcher" \
     -H "ApiKey: YOUR_API_KEY"
   

   curl -G "https://api.sorsa.io/v3/score" \
     -H "ApiKey: YOUR_API_KEY" \
     --data-urlencode "username=orbit_dao_watcher"
   

4. Renomeie as chaves de paginação e do corpo. cursor vira next_cursor, link vira user_link e user_handle vira username. Em POST /check-follow, project_handle vira username_1 (a conta que deveria ser seguida) e user_handle vira username_2 (a conta que você verifica).

As mesmas edições em um script: a URL base muda uma vez, o handle vai para params, e as listas que na v2 voltavam como um único array agora chegam em páginas, com cursor. O tutorial API do Twitter em Python cobre o resto do básico da v3.

import requests

BASE = "https://api.sorsa.io/v3"  # was https://api.tweetscout.io/v2
HEADERS = {"ApiKey": "YOUR_API_KEY"}


def score(handle):
    # v2: GET /score/{handle}  ->  v3: GET /score?username=
    r = requests.get(f"{BASE}/score", headers=HEADERS,
                     params={"username": handle}, timeout=30)
    r.raise_for_status()
    return r.json()["score"]


def following(handle):
    # v2 returned one array; v3 pages 200 accounts at a time
    users, cursor = [], None
    while True:
        params = {"username": handle}
        if cursor:
            params["next_cursor"] = cursor
        r = requests.get(f"{BASE}/follows", headers=HEADERS,
                         params=params, timeout=30)
        r.raise_for_status()
        page = r.json()
        users += page["users"]
        cursor = page.get("next_cursor")
        if not cursor:
            return users


print(score("orbit_dao_watcher"))
print(len(following("orbit_dao_watcher")))

const BASE = "https://api.sorsa.io/v3"; // was https://api.tweetscout.io/v2
const HEADERS = { ApiKey: "YOUR_API_KEY" };

async function score(handle) {
  const qs = new URLSearchParams({ username: handle });
  const res = await fetch(`${BASE}/score?${qs}`, { headers: HEADERS });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return (await res.json()).score;
}

async function following(handle) {
  const users = [];
  let cursor = "";
  do {
    const qs = new URLSearchParams({ username: handle });
    if (cursor) qs.set("next_cursor", cursor);
    const res = await fetch(`${BASE}/follows?${qs}`, { headers: HEADERS });
    if (!res.ok) throw new Error(`HTTP ${res.status}`);
    const page = await res.json();
    users.push(...page.users);
    cursor = page.next_cursor || "";
  } while (cursor);
  return users;
}

console.log(await score("orbit_dao_watcher"));

Um 401 significa que a chave está errada, um 403 significa que ela está ausente ou sem requisições, e um 429 significa mais de 20 requisições em um segundo, então espere um segundo e envie de novo. Os endpoints de score respondem por contas que estão no banco de dados do Sorsa Score, e a v3 agora informa a data em que cada seguidor passou a seguir, como nesta resposta de GET /top-followers:

{
  "users": [
    {
      "id": "1600000000000000004",
      "username": "lattice_fund_research",
      "display_name": "Lattice Fund Research",
      "followers_count": 48210,
      "followings_count": 612,
      "verified": true,
      "score": 1873,
      "follower_date": "2026-03-14T09:21:07Z"
    }
  ]
}

#O mapa de endpoints da API da TweetScout, da v2 para a v3

Dos 29 endpoints da referência da v2 da era TweetScout, 27 migraram para a v3 e 2 foram desativados. Os 27 caem em 25 caminhos da v3, porque dois pares se fundiram: /info e /info-id viraram um único GET /info, e /score e /score-id viraram um único GET /score.

Cole qualquer chamada antiga do seu código ou dos seus logs no conversor para obter a requisição da v3 e as edições de que ela precisa.

curl -G "https://api.sorsa.io/v3/score" \
  -H "ApiKey: YOUR_API_KEY" \
  --data-urlencode "username=orbit_dao_watcher"

O mapa completo lista cada chamada da v2 nos grupos da referência antiga, com o caminho da v3 que a substitui e a única edição de que ela precisa. As chamadas cujo caminho não mudou ainda precisam da nova URL base.

• GET /info/{user_handle}

  Sorsa API v3

  GET /info

  O que muda

  O handle vai para ?username=

• GET /info-id/{user_id}

  Sorsa API v3

  GET /info

  O que muda

  O ID vai para ?user_id=

• GET /about

  Sorsa API v3

  GET /about

  O que muda

  link vira user_link; username também funciona

• GET /follows

  Sorsa API v3

  GET /follows

  O que muda

  link vira user_link; 200 por página com next_cursor

• GET /handle-to-id/{user_handle}

  Sorsa API v3

  GET /username-to-id/{user_handle}

  O que muda

  Caminho renomeado

• GET /id-to-handle/{user_id}

  Sorsa API v3

  GET /id-to-username/{user_id}

  O que muda

  Caminho renomeado; a resposta ainda contém handle

• POST /user-tweets

  Sorsa API v3

  POST /user-tweets

  O que muda

  link vira user_link, cursor vira next_cursor

• POST /tweet-info

  Sorsa API v3

  POST /tweet-info

  O que muda

  Mesmo corpo; campos do tweet renomeados

• POST /tweet-info-bulk

  Sorsa API v3

  POST /tweet-info-bulk

  O que muda

  Mesmo corpo; resposta envolvida em tweets

• POST /comments

  Sorsa API v3

  POST /comments

  O que muda

  order_by opcional; a chave da resposta comments vira tweets

• POST /search-tweets

  Sorsa API v3

  POST /search-tweets

  O que muda

  Sem mudança

• POST /search-users

  Sorsa API v3

  POST /search-users

  O que muda

  Sem mudança

• GET /list-members

  Sorsa API v3

  GET /list-members

  O que muda

  Acrescenta paginação com next_cursor

• GET /list-tweets

  Sorsa API v3

  GET /list-tweets

  O que muda

  cursor vira next_cursor

• POST /community-tweets

  Sorsa API v3

  POST /community-tweets

  O que muda

  cursor vira next_cursor, order_by vira order

• POST /check-member

  Sorsa API v3

  POST /check-community-member

  O que muda

  Caminho renomeado

• POST /check-follow

  Sorsa API v3

  POST /check-follow

  O que muda

  project_* vira *_1, user_* vira *_2

• POST /check-quoted

  Sorsa API v3

  POST /check-quoted

  O que muda

  user_handle vira username

• POST /check-retweet

  Sorsa API v3

  POST /check-retweet

  O que muda

  user_handle vira username

• GET /check-comment

  Sorsa API v3

  GET /check-comment

  O que muda

  user_handle vira username

• GET /score/{user_handle}

  Sorsa API v3

  GET /score

  O que muda

  O handle vai para ?username=

• GET /score-id/{user_id}

  Sorsa API v3

  GET /score

  O que muda

  O ID vai para ?user_id=

• GET /score-changes

  Sorsa API v3

  GET /score-changes

  O que muda

  user_handle vira username

• GET /followers-stats

  Sorsa API v3

  GET /followers-stats

  O que muda

  user_handle vira username

• GET /top-followers/{user_handle}

  Sorsa API v3

  GET /top-followers

  O que muda

  O handle vai para ?username=; from removido

• GET /top-following/{user_handle}

  Sorsa API v3

  GET /top-following

  O que muda

  O handle vai para ?username=

• GET /new-following-7d

  Sorsa API v3

  GET /new-following-7d

  O que muda

  user_handle vira username

• POST /when-follow

  Sorsa API v3

  Desativado

  O que muda

  POST /check-follow responde sim ou não

• GET /handle-history

  Sorsa API v3

  Desativado

  O que muda

  GET /about retorna a quantidade de mudanças e a última data

As duas linhas desativadas ainda têm um caminho para a mesma resposta, e a seção sobre chamadas sem endpoint equivalente, abaixo, mostra o caminho de cada uma.

#Campos de resposta que mudaram de nome

As respostas da v3 mantêm o formato das respostas da TweetScout, mas 10 nomes de campos mudaram, e as listas que a v2 retornava como arrays soltos agora vêm dentro de um objeto ({"users": [...]} ou {"tweets": [...]}). Os parsers quebram nessas renomeações antes de qualquer outra coisa, então procure primeiro os nomes antigos no seu código.

• screen_name

  Campo da Sorsa API v3

  username

  Onde aparece

  Perfis, autores de tweets, membros de listas

• name

  Campo da Sorsa API v3

  display_name

  Onde aparece

  Perfis, autores de tweets

• friends_count

  Campo da Sorsa API v3

  followings_count

  Onde aparece

  Perfis, autores de tweets

• statuses_count

  Campo da Sorsa API v3

  tweets_count

  Onde aparece

  Autores de tweets

• register_date

  Campo da Sorsa API v3

  created_at

  Onde aparece

  Perfis

• avatar

  Campo da Sorsa API v3

  profile_image_url

  Onde aparece

  Perfis, autores de tweets

• banner

  Campo da Sorsa API v3

  profile_background_image_url

  Onde aparece

  Perfis

• id_str

  Campo da Sorsa API v3

  id

  Onde aparece

  Tweets, autores de tweets

• favorite_count

  Campo da Sorsa API v3

  likes_count

  Onde aparece

  Tweets

• in_reply_to_status_id_str

  Campo da Sorsa API v3

  in_reply_to_tweet_id

  Onde aparece

  Tweets

As chaves em camelCase das listas antigas de top followers (screeName, followersCount, friendsCount, registerDate) passaram a ter os mesmos nomes em snake_case de todos os outros perfis da v3. Os campos que mantiveram o nome incluem full_text, retweet_count, reply_count, quote_count, view_count, bookmark_count e can_dm, e cada perfil da v3 acrescenta location, bio_urls, pinned_tweet_ids e protected.

Bom saber

A data em que o seguidor passou a seguir tem duas grafias na v3: follower_date em GET /top-followers e followerDate em GET /new-followers-7d e GET /new-following-7d. Os IDs são strings em todo lugar, como na v2, então guarde-os como texto no seu banco de dados: IDs Snowflake longos perdem dígitos quando tratados como números em JavaScript.

#Chamadas da TweetScout sem endpoint equivalente na v3

Dois endpoints da v2 foram desativados, e três coisas que as pessoas procuram com o nome TweetScout nunca foram endpoints da API. Cada uma ainda tem um caminho na v3 para a mesma resposta.

• /when-follow retornava a data em que uma conta passou a seguir outra, e apenas para contas que já estavam no banco de dados da TweetScout. Na v3, POST /check-follow (abre em uma nova aba) responde se o follow existe. Para datas, GET /top-followers cobre os 20 seguidores mais fortes de uma conta, e GET /new-followers-7d (abre em uma nova aba) lista as contas cripto que passaram a seguir nos últimos 7 dias.
• /handle-history retornava os handles anteriores de uma conta. GET /about (abre em uma nova aba) retorna username_change_count e last_username_change_at, que o Verificador de histórico de username do Twitter gratuito mostra para qualquer conta.
• "Audience quality" (qualidade da audiência) era a visão do app da TweetScout sobre quem segue uma conta. Na API, ela é GET /followers-stats (abre em uma nova aba), que conta influenciadores, projetos e fundos de VC entre os seguidores, além de GET /top-followers e GET /score.
• Um endpoint de sentimento nunca existiu na v2 nem na v3. Puxe os posts com POST /search-tweets ou POST /mentions e calcule o score com o seu próprio modelo, como no guia de análise de sentimento no Twitter.
• /v1/analyze em api.tweetscout.io nunca foi um endpoint da TweetScout. Ele aparece em código de bots de trading gerado por IA, marcado ali como endpoint hipotético, e o endereço responde 404. Para essa função, chame GET /score e GET /followers-stats.

#O que a mesma chave lê agora e a TweetScout nunca leu

A Sorsa API v3 acrescentou 20 endpoints que a API da TweetScout nunca teve, então uma chave agora cobre as funções gerais de dados do X que os dashboards cripto compravam de um segundo provedor. Se a sua integração da TweetScout rodava ao lado de outra API para listas de seguidores ou busca, use a Sorsa API para as duas: uma chave, uma fatura e os dados de smart followers no mesmo JSON.

As funções que levavam usuários da TweetScout a um segundo provedor custam isto por 1.000 resultados na Sorsa API, contra os preços da API oficial do X (abre em uma nova aba), que também exige conta de desenvolvedor e OAuth e para em 3 milhões de leituras de posts por mês:

• Listas completas de seguidores

  Endpoint da Sorsa API

  GET /followers, 200 por página

  Sorsa API, por 1.000

  a partir de US$ 0,007

  API oficial do X, por 1.000

  US$ 10,00

• Perfis em lotes

  Endpoint da Sorsa API

  GET /info-batch, 100 por requisição

  Sorsa API, por 1.000

  a partir de US$ 0,014

  API oficial do X, por 1.000

  US$ 10,00

• Posts por ID

  Endpoint da Sorsa API

  POST /tweet-info-bulk, 100 por requisição

  Sorsa API, por 1.000

  a partir de US$ 0,014

  API oficial do X, por 1.000

  US$ 5,00

• Busca e menções, desde 2006

  Endpoint da Sorsa API

  POST /search-tweets, POST /mentions, cerca de 20 por página

  Sorsa API, por 1.000

  a partir de US$ 0,07

  API oficial do X, por 1.000

  US$ 5,00

• Score de influência cripto e categorias de seguidores

  Endpoint da Sorsa API

  GET /score, GET /followers-stats, uma conta por requisição

  Sorsa API, por 1.000

  a partir de US$ 1,40

  API oficial do X, por 1.000

  não oferecido

Para o acompanhamento de KOLs e smart followers, que os usuários da TweetScout faziam no app, a v3 tem quatro chamadas: GET /top-followers e GET /followers-stats para saber quem apoia uma conta, e GET /new-followers-7d e GET /new-following-7d para os follows cripto da última semana. As listas completas de todos os seguidores, cripto ou não, vêm de GET /followers (abre em uma nova aba); o guia da API de seguidores do Twitter mostra a exportação de ponta a ponta.

Os outros endpoints novos leem citações, quem deu repost, as respostas e os reposts de um usuário, X Articles, Spaces, trends por localização, seguidores verificados, seguidores de listas, informações, membros e busca de comunidades, e a verificação de shadowban. Equipes que também leem da API oficial do X podem migrar da API do Twitter/X com o mesmo tipo de mapa.

#Migre sua primeira chamada da TweetScout hoje

A API da TweetScout continua viva como a Sorsa API v3: mude a URL base, mova os handles para parâmetros de query, renomeie cursor, e 27 das 29 chamadas antigas voltam a funcionar. A Sorsa API é onde executá-las: 45 endpoints, o Sorsa Score incluído, 20 requisições por segundo em todos os planos e 100 requisições grátis para converter e testar uma integração inteira antes de escolher um plano.

#FAQ