WeChat Search · 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	`"人民日报"`	Search keyword (1-100 chars)
`business_type`	string	Não	`"account"`	Search category. Tested categories with results: all, account, article, video, sticker. Other categories may return no data.
`sort`	integer	Não	`"hot"`	Sort (result page 'sort' dropdown, common to all verticals): default/0 (relevance) / latest/1 (newest) / hot/2
`publish_time`	integer	Não	`"week"`	Publish time (result page 'time' dropdown, common): all/0 / day/1 / week/2 / half_year/3; string key or integer
`offset`	integer	Não	`0`	Pass 0 for the first page; use cursor to paginate (offset alone does not work — it returns the first page every time)
`cursor`	string	Não	`—`	Pagination cursor: leave empty for the first page; for the next page pass back the cursor returned in the previous response
`raw`	boolean	Não	`true`	True=raw search response; False=simplified parsed structure

Exemplo de requisição

curl --get "https://api.chinaapi.ai/v1/social/wechat-search/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": "wechat-search",
  "capability": "search",
  "data": { … }
}

Paginação

Parâmetros de paginação: offset, cursor. 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.