LinkedIn · Tarefa de perfil
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 ·
POST with an empty body and Idempotency-Key (8–128 characters). Creation reserves the price; failed or empty tasks refund it. Read GET /v1/social-tasks/TASK_ID for free with the same account. Poll every five seconds or slower; results expire after 30 days. Retry creation with the same key.
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 |
|---|---|---|---|---|
url | string | Sim | "https://www.linkedin.com/in/williamhgates/" | Full profile URL |
Exemplo de requisição
curl --get -X POST "https://api.chinaapi.ai/v1/social/linkedin/user-async" \
-H "Authorization: Bearer $CHINAAPI_KEY" \
-H "Idempotency-Key: YOUR_UNIQUE_OPERATION_KEY" \
--data-urlencode 'url=https://www.linkedin.com/in/williamhgates/'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.task","id":"task_...","status":"queued","url":"/v1/social-tasks/task_..."}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.