Bilibili · Evolução dos seguidores

Beta

Dados públicos de plataformas sociais, cobrados por chamada, com a mesma chave de API e o mesmo saldo das suas chamadas de modelos.

Contas sem pagamento: até 50 chamadas por dia. Contas pagas: sem limite diário de chamadas. Reinicia às 00:00 UTC. · Uma chamada só é cobrada quando retorna HTTP 200 com data não vazio; resultados vazios, parâmetros recusados e falhas upstream não são cobrados.

Parâmetros da Requisição

Os parâmetros vão na query string, com os nomes da própria plataforma. Os exemplos vêm do catálogo; substitua os identificadores pelo conteúdo que você quer obter.

Nome	Tipo	Obrigatório	Exemplo	Descrição
`upper_mid`	integer	Sim	`546195`	Bilibili creator UID
`query_type`	integer	Não	`1`	Trend window Padrão `1`

Exemplo de requisição

curl --get "https://api.chinaapi.ai/v1/social/bilibili/creator-follower-trend" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'upper_mid=546195'

Formato da resposta

Uma resposta bem-sucedida envolve os dados da plataforma em um pequeno envelope. Tudo dentro de data — nomes de campos, cursores de paginação, IDs — é da própria plataforma; devolva os cursores exatamente como os recebeu.

{
  "object": "social.result",
  "platform": "bilibili",
  "capability": "creator-follower-trend",
  "data": { … }
}

Paginação

Este endpoint não tem parâmetros de paginação.

Erros e o que não é cobrado

Código de status	Código de erro	Significado
400	—	Um parâmetro é desconhecido, repetido, longo demais, do tipo errado ou está faltando, inclusive quando nenhum membro de um grupo "pelo menos um de" é informado. O `code` do erro diz qual, como `unknown_parameter` ou `missing_parameter`.
403	—	A chave API não tem permissão para esta solicitação.
404	`social_data_no_result`	O par plataforma e capacidade não existe, ou a plataforma não encontrou nada para esses parâmetros (`social_data_no_result`).
429	`data_api_daily_limit_exceededsocial_data_capacity_reached`	A capacidade diária do beta se esgotou e é reiniciada às 00:00 UTC, ou a plataforma está ocupada e uma nova tentativa alguns segundos depois resolve. Não repita em um loop apertado. Contas sem pagamento: até 50 chamadas por dia. Contas pagas: sem limite diário de chamadas. Reinicia às 00:00 UTC.
502	`social_data_no_result`	A fonte de dados não respondeu, ou respondeu sem dados.
503	`social_data_unavailable`	Este endpoint está pausado no momento; o catálogo ao vivo o lista como `paused`.

Nenhuma dessas respostas é cobrada.

Toda resposta traz o cabeçalho X-Oneapi-Request-Id; inclua-o ao falar com o suporte e encontraremos exatamente essa chamada.

Termos do beta

Contas sem pagamento: até 50 chamadas por dia. Contas pagas: sem limite diário de chamadas. Reinicia às 00:00 UTC. O beta não tem SLA, e suas plataformas, endpoints e preços podem mudar.

Siga os termos de cada plataforma e as regras de proteção de dados que se aplicam a você. Não use esta API para montar perfis de indivíduos. Fazer login, extrair dados de contato, manipular engajamento e acessar conteúdo privado ou pago estão fora deste beta.

Benefícios de velocidade da API de dados

Contas pagas começam com 10 solicitações/segundo e aumentam automaticamente conforme o gasto líquido acumulado, até 100 solicitações/segundo.

Contas sem pagamento: até 50 chamadas por dia. Contas pagas: sem limite diário de chamadas. Reinicia às 00:00 UTC.

Gasto líquido acumulado	Solicitações por segundo
Padrão pago	10/s
Acima de US$ 50	20/s
Acima de US$ 500	50/s
Acima de US$ 1500	100/s

Base de gastos: cobranças liquidadas da API de dados menos reembolsos de chamadas. Recargas e gastos com APIs de modelos não contam.

Todas as chaves API da conta compartilham esta velocidade. São solicitações por segundo, não solicitações simultâneas.

Os endpoints dos fornecedores têm limites próprios de capacidade que também afetam a vazão disponível.

Precisa de uma velocidade maior? Envie um e-mail para [email protected].