Dados sociais (beta)

/

GET /v1/social/{platform}/{capability} retorna dados públicos do Douyin, Xiaohongshu, TikTok, YouTube e outras plataformas sociais, com a mesma chave de API e o mesmo saldo das suas chamadas de modelo. Cada plataforma e capacidade tem preço por chamada bem-sucedida, e data é a resposta da própria plataforma — os campos não são normalizados entre plataformas.

GET /v1/social/{platform}/{capability} 
curl --get "https://api.chinaapi.ai/v1/social/tiktok/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=TikTok'

# HTTP 200
# {"object": "social.result", "platform": "tiktok", "capability": "search", "data": {...}}
Beta: somente contas pagas 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.

Autenticação e cobrança

Envie sua chave ChinaAPI como token bearer para https://api.chinaapi.ai, como em qualquer chamada de modelo. Uma chamada é cobrada uma única vez, pelo preço indicado para o endpoint, e só quando retorna HTTP 200 com dados; um resultado vazio, um parâmetro rejeitado ou uma falha no upstream não custam nada. Cada página buscada é uma chamada separada. Seu registro de uso lista cada chamada com o nome mostrado junto ao endpoint, como social-douyin-search.

Respostas e erros

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": "douyin",
  "capability": "search",
  "data": { "...": "the platform's own fields" }
}
  • 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 — 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 — 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.

Uso aceitável

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.

Plataformas e preços

USD por chamada bem-sucedida. Cada preço leva ao seu endpoint abaixo, e um traço significa que a plataforma não oferece essa capacidade. O catálogo ao vivo — GET https://dash.chinaapi.ai/api/social/catalog, sem chave — é a referência do que está à venda agora, incluindo qualquer endpoint pausado.

Endpoints

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.