API para X / Twitter

API para X / Twitter: Buscar comunidades

Busque comunidades do X (Twitter) por palavra-chave e receba ID, nome, tema e número de membros, com paginação por cursor. É assim que você encontra a URL de comunidade a passar para twitter.community ou twitter.community_tweets.

POST/v1/run/twitter.search_communities
Disponibilidade
100,00%
30d · 29 chamadas
Requisições
29
30d · semanal, últimas 12 sem.
Resposta
0,5s
mediana · 30d

Teste

Faça sua primeira requisição

Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "data": {
    "communities": [
      {
        "id": "a1b2c3d4",
        "memberCount": 12500,
        "name": "Example title",
        "nsfw": true,
        "topic": "example",
        "url": "https://example.com/page"
      }
    ],
    "nextCursor": "example"
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface TwitterSearchCommunitiesResponse {
  data: {
    communities: {
      id: string;
      memberCount: number;
      name: string;
      nsfw: boolean;
      topic: string;
      url: string;
    }[];
    nextCursor: string | null;
  } | null;
  found: boolean;
  reason?: "not_found";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30d
POST /v1/run/twitter.search_communities
curl -X POST https://api.getanyapi.com/v1/run/twitter.search_communities \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"artificial intelligence"}'
CampoTipoValor de exemplo
Corpo da requisição
querystring"artificial intelligence"Palavra-chave comparada com nomes e temas de comunidades do X (Twitter) (ex.: artificial intelligence).
cursorstringCursor de paginação opaco vindo do nextCursor da resposta anterior. Omita na primeira página; envie-o para buscar a próxima página de comunidades.
Resposta
dataobjectThe page of matching communities, or null when nothing was found.
data.communitiesobject[]Matching X (Twitter) communities. Search returns a summary record; pass url to twitter.community for the full detail, or to twitter.community_tweets for its posts. Populated whenever the provider has data for the entity.
data.communities[].idstringCommunity identifier. Populated whenever the provider has data for the entity.
data.communities[].memberCountintegerNumber of members in the community.
data.communities[].namestringCommunity name. Populated whenever the provider has data for the entity.
data.communities[].nsfwbooleanWhether the community is flagged as not safe for work.
data.communities[].topicstringThe community's primary topic label (may be empty).
data.communities[].urlstringCanonical URL of the community on X. Pass it to twitter.community or twitter.community_tweets. Populated whenever the provider has data for the entity.
data.nextCursorstringOpaque cursor for the next page of communities, or null when this lane has no more. Pass it back as cursor to continue.
foundbooleanTrue when the search returned at least one community; false when nothing matched.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preço
Preço por requisição (teto)USDUS$ 0,0011
Preço /mil resultadosUSDUS$ 0,11

Dúvidas frequentes

Sobre o endpoint Buscar comunidades da API para X / Twitter

O endpoint Buscar comunidades da AnyAPI para X / Twitter retorna dados de X / Twitter em JSON normalizado com uma chamada POST para /v1/run/twitter.search_communities. Busque comunidades do X (Twitter) por palavra-chave e receba ID, nome, tema e número de membros, com paginação por cursor. É assim que você encontra a URL de comunidade a passar para twitter.community ou twitter.community_tweets. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa US$ 0,11 por mil resultados, e nunca mais de US$ 0,0011 por requisição, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar comunidades da API para X / Twitter feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 0,5 segundos, em 29 chamadas medidas.

Custa US$ 0,11 por mil resultados, e nunca mais de US$ 0,0011 por requisição, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Busque comunidades do X (Twitter) por palavra-chave e receba ID, nome, tema e número de membros, com paginação por cursor. É assim que você encontra a URL de comunidade a passar para twitter.community ou twitter.community_tweets. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar comunidades da API para X / Twitter feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 0,5 segundos, em 29 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.