Cross-platform · 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 |
|---|---|---|---|---|
query | string | Sim | "人工智能" | Search terms; separate terms with spaces to require all of them. Put excluded words in exclude_words. |
platforms | array | Não | ["weibo","douyin","toutiao","xiaohongshu","short_video","wechat","news","forum","long_video","app"] | Only these platforms, all by default: weibo, douyin, toutiao, xiaohongshu, short_video (Kuaishou and other short-video apps), wechat (official accounts), news (news sites and newspapers), forum (forum Pass a JSON array in this query parameter. |
since | string | Não | — | First day, YYYY-MM-DD (Beijing time, included); defaults to 6 days before until |
until | string | Não | — | Last day, YYYY-MM-DD (Beijing time, included); defaults to today and cannot be later. since to until spans at most 90 days |
types | array | Não | ["original","repost","comment"] | Content types, all by default: original, repost, comment Pass a JSON array in this query parameter. |
sentiment | array | Não | ["negative","neutral","positive"] | Sentiment, all by default: negative, neutral, positive Pass a JSON array in this query parameter. |
match | array | Não | ["title","content","author"] | Where the search terms must match, title, content and author by default: title, content, author (author name), media_text (images and video frames), audio Pass a JSON array in this query parameter. |
exclude_words | string | Não | — | Filter words; results that contain them are left out |
author | string | Não | — | Only content published by this author (account name) |
page | integer | Não | 1 | Page number, from 1, at most 50 |
limit | integer | Não | 20 | Results per page: 10 or 20 |
Exemplo de requisição
curl --get "https://api.chinaapi.ai/v1/social/cross-platform/search" \
-H "Authorization: Bearer $CHINAAPI_KEY" \
--data-urlencode 'query=人工智能'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": "cross-platform",
"capability": "search",
"data": { … }
}Paginação
Parâmetros de paginação: page. 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.
Benefícios de velocidade da API de dados
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].