Kuaishou Cili Juxing · Público do criador

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.

Somente contas que já fizeram a primeira recarga, sem teste gratuito · 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
`star_id`	string	Sim	`"8646245"`	Cili Juxing creator ID (starId)
`star_type`	integer	Não	`1`	1 short-video creators, 4 live-stream creators

Exemplo de requisição

curl --get "https://api.chinaapi.ai/v1/social/cljx/creator-audience" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'star_id=8646245'

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": "cljx",
  "capability": "creator-audience",
  "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	`model_requires_topup`	A conta não concluiu sua primeira recarga.
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	`social_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.
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

Faça sua primeira recarga antes de chamar. O crédito de teste não pode ser gasto nesses endpoints; uma conta que nunca recarregou recebe HTTP 403 model_requires_topup. 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.

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].