Ponto final de pesquisa

Pesquise empresas chinesas por nome, nome em inglês ou número de licença comercial (USCC).

Solicitar

GET /wp-json/chinacheckup/v1/search

Autenticação

Método Exemplo
Cabeçalho (preferencial) X-API-Key: sua-chave-de-api
Parâmetro de consulta ?token=sua-chave-de-api

Parâmetros

Parâmetro Tipo Obrigatório Descrição
termos_de_busca corda Sim Nome da empresa (chinês ou inglês) ou USCC
página_atual inteiro Não Número da página para paginação (padrão: 1)

Exemplo de solicitação

GET /wp-json/chinacheckup/v1/search?search_terms=toto&current_page=1 Cabeçalho: X-API-Key: SUA_CHAVE_DE_API

Resposta

{ "total_results": 649, "current_page": "1", "companylist": { "9295814": { "name": "东陶(中国)有限公司", "creditCode": "91110000625910848Y", "city": "Pequim", "base": "北京", "registered_english_name": "Dongtao (China) Co., Ltd.", "auto_english_name": "", "companyType": 1, "companyTypeText": "Empresa" }, "2344995451": { "name": "南京东陶有限公司", "creditCode": "91320115608929125H", "city": "Nanjing", "base": "江苏", "registered_english_name": "Nanjing TOTO Co.,Ltd.", "auto_english_name": "", "companyType": 1, "companyTypeText": "Company" } } }

Campos de resposta

Campo Tipo Descrição
total_resultados inteiro Número total de empresas correspondentes
página_atual corda Número da página atual
lista de empresas objeto Mapa de identificação da empresa → dados da empresa

Objeto da Empresa

Campo Tipo Descrição
nome corda Nome da empresa chinesa
código de crédito corda USCC (Código Unificado de Crédito Social) – 18 caracteres
cidade corda Nome da cidade (traduzido para o inglês)
base corda Província/região (chinês)
nome_registrado_em_inglês corda Nome oficial em inglês registrado (se houver)
nome_em_inglês_automático corda Nome em inglês traduzido automaticamente (caso não haja nome oficial)
tipo de empresa inteiro Código do tipo de empresa (1 = Empresa, 2 = Pessoa)
tipoDeEmpresaTexto corda Etiqueta de tipo de empresa

Custo

Livre (0 créditos) – Registrado para fins de rastreamento.

Respostas de erro

Status Código Descrição
400 termos_faltantes Ausente termos_de_busca parâmetro
400 sem carteira O usuário não tem nenhuma carteira configurada.
401 chave_api_faltando Nenhuma chave de API fornecida
403 chave_api_inválida Chave de API inválida

Notas

  • Retorna até 5 resultados por página.
  • Usar código de crédito (USCC) para uso posterior obterBásico ou getFull ligações
  • Empresas sem um código de crédito ou cidade Não é possível solicitar relatórios detalhados.

Obtenha o endpoint com os dados completos da empresa.

Obtenha informações completas sobre a empresa, incluindo detalhes de registro, dados comerciais, registros judiciais, avaliação de riscos e análises com inteligência artificial.

Solicitar

GET /wp-json/chinacheckup/v1/getFull

Autenticação

Método Exemplo
Cabeçalho (preferencial) X-API-Key: sua-chave-de-api
Parâmetro de consulta ?token=sua-chave-de-api

Parâmetros

Parâmetro Tipo Obrigatório Descrição
USCC corda Sim USCC da empresa (Código Unificado de Crédito Social) – 18 caracteres

Exemplo de solicitação

GET /wp-json/chinacheckup/v1/getFull?uscc=91110000625910848Y Cabeçalho: X-API-Key: SUA_CHAVE_DE_API

Resposta

{ "name": "东陶(中国)有限公司", "registered_english_name": "Dongtao (China) Co., Ltd.", "creditCode": "91110000625910848Y", "regStatus": "Active", "regStatus_interpretation": "This status indicators that the company exists and it is in operation.", "estiblishTime": "1995-08-18", "estiblishTime_formatted": "1995-08-18", "company_age_years": "29", "percentileScore": "85%", "regCapital": "USD 50,000,000", "actualCapital": "USD 50,000,000", "companyOrgType": "Sociedade de Responsabilidade Limitada (Investimento Estrangeiro)", "cidade": "Pequim", "base": "Pequim", "distrito": "Chaoyang", "local de registro": "Rua Exemplo nº 123, Distrito de Chaoyang, Pequim", "âmbito de atuação": "Fabricação e venda de louças sanitárias...", "nome da pessoa jurídica": "Zhang Wei", "tipo de pessoa jurídica": "Pessoa física", "número de telefone": "010-12345678", "e-mail": "contato@exemplo.com", "site": "www.exemplo.com", "principal setor": "Fabricação", "grande setor": "Louças sanitárias", "faixa de número de funcionários": "1000-4999", "número de funcionários nas redes sociais": 2500, "análise": "Esta é uma empresa de investimento estrangeiro bem estabelecida...", "informações de risco": { "nível_de_risco": "baixo", "risco_próprio_total": 0, "risco_associado_total": 2, "categorias": [...] }, "lista_de_funcionários": [...], "lista_de_acionistas": [...], "lista_de_filiais": [...], "lista_de_processos_judiciais": [...], "lista_de_alterações": [...], "tradução_concluída": 1, "_créditos": 95, "_já_adquirido": falso }

Campos de resposta

Informações básicas

Campo Tipo Descrição
nome corda Nome da empresa chinesa
nome_registrado_em_inglês corda Nome oficial registrado em inglês
código de crédito corda USCC (18 caracteres)
regStatus corda Status do registro (ex.: Ativo, Cancelado)
regStatus_interpretation corda Explicação do status de registro
tempo de estabelecimento corda data de fundação da empresa
idade_da_empresa_em_anos corda Idade da empresa em anos
Pontuação percentil corda Pontuação de confiabilidade da empresa (0-100%)

Informações financeiras

Campo Tipo Descrição
regCapital corda Capital social
capital real corda Capital integralizado real

Localização e contato

Campo Tipo Descrição
cidade corda Cidade (traduzido)
base corda Província/região (traduzido)
distrito corda Distrito
regLocalização corda Endereço registrado
número de telefone corda Número de telefone para contato
e-mail corda E-mail de contato
site corda Site da empresa

Informação de negócios

Campo Tipo Descrição
tipoOrganizaçãoDaEmpresa corda Tipo de organização da empresa
Escopo de negócios corda Descrição do escopo do negócio
IndústriaPrincipal corda Categoria principal da indústria
IndústriaGrande corda Categoria principal do setor
IndústriaMédia corda Categoria intermediária da indústria
Indústria de pequeno porte corda Categoria secundária da indústria
intervaloNúmeroDeFuncionários corda intervalo de número de funcionários
socialStaffNum inteiro funcionários registrados na previdência social
nomePessoaLegal corda Nome do representante legal
tipoPessoaLegal corda Tipo de representante legal (Pessoa/Empresa)

Avaliação de risco

Campo Tipo Descrição
informações_de_risco objeto Dados abrangentes de avaliação de risco
análise corda Análise de empresas gerada por IA

Listas (Arrays)

Campo Tipo Descrição
Lista de funcionários variedade Pessoal-chave e executivos
Lista de acionistas variedade Acionistas e estrutura de propriedade
lista de ramos variedade Filiais
lista de investimentos variedade Investimentos em outras empresas
lista de processos judiciais variedade Casos e processos judiciais
Lista de anúncios do tribunal variedade Anúncios do tribunal
lista desonesta variedade Registros de devedores desonestos
lista anormal variedade Anomalias comerciais
lista de alterações variedade A história das mudanças da empresa
lista de nomes de histórico variedade Nomes anteriores da empresa

Metadados

Campo Tipo Descrição
tradução_concluída inteiro Status da tradução (0 = em andamento, 1 = concluída)
_créditos inteiro Seu saldo de crédito restante
_já_comprado booleano Se este relatório foi adquirido anteriormente.

Custo

1 crédito por empresa única (USCC). Chamadas subsequentes para o mesmo USCC são gratuitas.

Respostas de erro

Status Código Descrição
400 missing_uscc Ausente USCC parâmetro
400 sem carteira O usuário não tem nenhuma carteira configurada.
401 chave_api_faltando Nenhuma chave de API fornecida
402 créditos_insuficientes Créditos insuficientes para comprar o relatório.
403 chave_api_inválida Chave de API inválida

Notas

  • Os dados são armazenados em cache por 180 dias – chamadas subsequentes retornam os dados em cache sem custos adicionais de API.
  • A primeira chamada pode demorar mais, pois os dados estão sendo obtidos da fonte.
  • Verificar tradução_concluída campo – se 0, alguns campos ainda podem estar em chinês
  • Usar obterStatusDaTradução consultar a conclusão da tradução
  • O _já_comprado Este campo indica se esta chamada foi cobrada ou gratuita (previamente adquirida).

Endpoint para obter o status da tradução

Verifique o status da tradução de um relatório da empresa. Os relatórios são traduzidos automaticamente do chinês para o inglês após a solicitação.

Solicitar

GET /wp-json/chinacheckup/v1/getTranslationStatus

Autenticação

Método Exemplo
Cabeçalho (preferencial) X-API-Key: sua-chave-de-api
Parâmetro de consulta ?token=sua-chave-de-api

Parâmetros

Parâmetro Tipo Obrigatório Descrição
USCC corda Sim Empresa USCC (Código Unificado de Crédito Social)

Exemplo de solicitação

GET /wp-json/chinacheckup/v1/getTranslationStatus?uscc=91110000625910848Y Cabeçalho: X-API-Key: SUA_CHAVE_DE_API

Resposta

{ "uscc": "91110000625910848Y", "translation_complete": 1, "status": "complete" }

Campos de resposta

Campo Tipo Descrição
USCC corda A empresa solicitada, USCC
tradução_concluída inteiro Código de status da tradução (veja abaixo)
status corda status legível por humanos

Códigos de status da tradução

Código Status Descrição
0 em andamento A tradução está pendente ou em andamento.
1 completo Tradução concluída – relatório pronto
2 em andamento Verificado, mas incompleto – ainda em processamento.

Custo

Livre (0 créditos) – Verificar o status da tradução é gratuito.

Respostas de erro

Status Código Descrição
400 missing_uscc Ausente USCC parâmetro
401 chave_api_faltando Nenhuma chave de API fornecida
403 chave_api_inválida Chave de API inválida

Notas

  • Se a empresa nunca tiver sido solicitada, este endpoint acionará a busca inicial de dados.
  • A tradução geralmente é concluída em poucos minutos.
  • Consulte este endpoint para verificar quando um relatório estiver pronto para visualização.
  • Uma vez tradução_concluída é 1, O relatório está totalmente traduzido e pronto.

Fluxo de trabalho típico

  1. Chamar getFull ou obterBásico para solicitar um relatório da empresa
  2. Enquete obterStatusDaTradução a cada 30-60 segundos
  3. Quando status é ""completo"", O relatório traduzido está pronto.
  4. Chamar getFull novamente para recuperar os dados totalmente traduzidos