Douyin · Buscar publicações
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 |
|---|---|---|---|---|
keyword | string | Sim | "猫咪" | Keyword |
cursor | integer | Não | 0 | Offset cursor for pagination, obtained from the last response |
sort_type | string | Não | "0" | Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest |
publish_time | string | Não | "0" | Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year |
filter_duration | string | Não | "0" | Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes |
content_type | string | Não | "0" | Content type: 0=All, 1=Video, 2=Picture, 3=Article |
search_id | string | Não | "" | Search ID for pagination, obtained from the last response |
backtrace | string | Não | "" | Backtrace for pagination, obtained from the last response |
Exemplo de requisição
curl --get "https://api.chinaapi.ai/v1/social/douyin/search" \
-H "Authorization: Bearer $CHINAAPI_KEY" \
--data-urlencode 'keyword=猫咪'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": "douyin",
"capability": "search",
"data": { … }
}Paginação
Parâmetros de paginação: cursor, search_id, backtrace. Cada página é uma chamada cobrada separadamente; use os valores de cursor da resposta anterior exatamente como vieram.
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.