Inicia sesión para ver tus créditos
Acceso
Empezar

DOCUMENTACIÓN API

Punto final de búsqueda

Busque empresas chinas por nombre, nombre en inglés o número de licencia comercial (USCC).

Pedido

OBTENER /wp-json/chinacheckup/v1/search

Autenticación

Método Ejemplo
Encabezado (preferido) X-API-Key: tu-clave-api
Parámetro de consulta ?token=tu-clave-api

Parámetros

Parámetro Tipo Requerido Descripción
términos_de_búsqueda cadena Sí Nombre de la empresa (en chino o inglés) o USCC
página_actual entero No Número de página para la paginación (predeterminado: 1)

Ejemplo de solicitud

GET /wp-json/chinacheckup/v1/search?search_terms=toto&current_page=1 Encabezado: X-API-Key: YOUR_API_KEY

Respuesta

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

Campos de respuesta

Campo Tipo Descripción
resultados_totales entero Número total de empresas coincidentes
página_actual cadena Número de página actual
lista de empresas objeto Mapa de ID de empresa → datos de la empresa

Objeto de la empresa

Campo Tipo Descripción
nombre cadena Nombre de la empresa china
Código de crédito cadena USCC (Código Unificado de Crédito Social) – 18 caracteres
ciudad cadena Nombre de la ciudad (traducido al inglés)
base cadena Provincia/región (chino)
nombre_registrado_en_inglés cadena Nombre oficial registrado en inglés (si lo hubiera)
nombre_auto_inglés cadena Nombre en inglés traducido automáticamente (si no hay nombre oficial)
tipo de empresa entero Código de tipo de empresa (1 = Empresa, 2 = Persona)
tipo de empresaTexto cadena Etiqueta de tipo de empresa

Costo

Gratis (0 créditos) – Registrado con fines de seguimiento.

Respuestas de error

Estado Código Descripción
400 términos faltantes Desaparecido términos_de_búsqueda parámetro
400 sin billetera El usuario no tiene ninguna billetera configurada.
401 falta_clave_api No se proporcionó ninguna clave API.
403 clave_de_pi_inválida Clave API no válida

Notas

  • Devuelve hasta 5 resultados por página.
  • Usar Código de crédito (USCC) para posterior obtenerBásico o obtenerFull llamadas
  • Empresas sin una Código de crédito o ciudad No se pueden realizar consultas para obtener informes detallados.

Obtenga el punto final de datos completos de la empresa

Obtenga información completa de la empresa, incluidos los detalles de registro, datos comerciales, antecedentes judiciales, evaluación de riesgos y análisis basados en inteligencia artificial.

Pedido

OBTENER /wp-json/chinacheckup/v1/getFull

Autenticación

Método Ejemplo
Encabezado (preferido) X-API-Key: tu-clave-api
Parámetro de consulta ?token=tu-clave-api

Parámetros

Parámetro Tipo Requerido Descripción
USCC cadena Sí Código USCC (Código Unificado de Crédito Social) de la empresa: 18 caracteres

Ejemplo de solicitud

GET /wp-json/chinacheckup/v1/getFull?uscc=91110000625910848Y Encabezado: X-API-Key: YOUR_API_KEY

Respuesta

{ "name": "东陶（中国）有限公司", "registered_english_name": "Dongtao (China) Co., Ltd.", "creditCode": "91110000625910848Y", "regStatus": "Active", "regStatus_interpretation": "Este estado indica que la empresa existe y está en funcionamiento.", "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": "Sociedad de responsabilidad limitada (inversión extranjera)", "ciudad": "Pekín", "base": "Pekín", "distrito": "Chaoyang", "ubicación registrada": "Calle Ejemplo n.° 123, distrito de Chaoyang, Pekín", "ámbito comercial": "Fabricación y venta de artículos sanitarios...", "nombre de la persona legal": "Zhang Wei", "tipo de persona legal": "Persona", "número de teléfono": "010-12345678", "correo electrónico": "contact@example.com", "sitio web": "www.example.com", "industria principal": "Fabricación", "industria grande": "Artículos sanitarios", "rango de personal": "1000-4999", "personal social": 2500, "análisis": "Esta es una empresa bien establecida con inversión extranjera...", "información de riesgo": { "nivel de riesgo": "bajo", "riesgo total propio": 0, "riesgo total asociado": 2, "categorías": [...] }, "lista_personal": [...], "lista_accionistas": [...], "lista_sucursales": [...], "lista_de_demandas": [...], "lista_de_cambios": [...], "traducción_completada": 1, "_créditos": 95, "_ya_comprado": false }

Campos de respuesta

Información básica

Campo Tipo Descripción
nombre cadena Nombre de la empresa china
nombre_registrado_en_inglés cadena Nombre oficial registrado en inglés
Código de crédito cadena USCC (18 caracteres)
Estado del registro cadena Estado de registro (por ejemplo, Activo, Cancelado)
interpretación de regStatus cadena Explicación del estado de registro
tiempo de establecimiento cadena Fecha de constitución de la empresa
edad_de_la_empresa_años cadena Edad de la empresa en años
Puntuación percentil cadena Puntuación de fiabilidad de la empresa (0-100%)

Información financiera

Campo Tipo Descripción
regCapital cadena Capital registrado
capital real cadena Capital desembolsado real

Ubicación y contacto

Campo Tipo Descripción
ciudad cadena Ciudad (traducido)
base cadena Provincia/región (traducido)
distrito cadena Distrito
regLocation cadena Dirección registrada
número de teléfono cadena Número de teléfono de contacto
correo electrónico cadena Correo electrónico de contacto
sitio web cadena Sitio web de la empresa

Información de negocios

Campo Tipo Descripción
tipo de organización de la empresa cadena Tipo de organización de la empresa
ámbito de negocio cadena Descripción del alcance del negocio
Industria principal cadena Categoría principal de la industria
Industria grande cadena Categoría principal de la industria
Industria media cadena Categoría media de la industria
Pequeña industria cadena Categoría menor de la industria
Rango de número de personal cadena Rango de número de empleados
Número de personal social entero empleados registrados en el seguro social
Nombre de la persona legal cadena Nombre del representante legal
Tipo de persona legal cadena Tipo de representante legal (Persona/Empresa)

Evaluación de riesgos

Campo Tipo Descripción
información_de_riesgo objeto Datos de evaluación de riesgos integrales
análisis cadena Análisis de empresas generado por IA

Listas (Matrices)

Campo Tipo Descripción
Lista de personal formación Personal clave y ejecutivos
Lista de accionistas formación Accionistas y estructura de propiedad
lista de ramas formación Sucursales
Lista de inversión formación Inversiones en otras empresas
Lista de demandas legales formación Casos legales y demandas judiciales
tribunalAnuncioLista formación Anuncios judiciales
lista deshonesta formación Registros de deudores deshonestos
lista anormal formación anomalías empresariales
Lista de cambios formación La historia de los cambios de la empresa
Lista de nombres de historial formación Nombres de empresas anteriores

Metadatos

Campo Tipo Descripción
traducción_completa entero Estado de la traducción (0 = en curso, 1 = completada)
_créditos entero Su saldo de crédito restante
_ya_comprado booleano Si este informe fue comprado previamente

Costo

1 crédito por compañía única (USCC). Las llamadas posteriores para la misma USCC son gratuitas.

Respuestas de error

Estado Código Descripción
400 falta_uscc Desaparecido USCC parámetro
400 sin billetera El usuario no tiene ninguna billetera configurada.
401 falta_clave_api No se proporcionó ninguna clave API.
402 créditos insuficientes Créditos insuficientes para comprar el informe
403 clave_de_pi_inválida Clave API no válida

Notas

  • Los datos se almacenan en caché durante 180 días; las llamadas posteriores devuelven los datos almacenados en caché sin costes adicionales de API.
  • La primera llamada puede tardar más tiempo mientras se obtienen los datos de la fuente.
  • Controlar traducción_completa campo – si 0, Algunos campos aún pueden estar en chino.
  • Usar obtenerEstadoDeTraducción sondear para completar la traducción
  • El _ya_comprado Este campo indica si la llamada fue de pago o gratuita (previamente adquirida).

Obtener punto final de estado de traducción

Compruebe el estado de la traducción de un informe de la empresa. Los informes se traducen automáticamente del chino al inglés tras solicitarse.

Pedido

OBTENER /wp-json/chinacheckup/v1/getTranslationStatus

Autenticación

Método Ejemplo
Encabezado (preferido) X-API-Key: tu-clave-api
Parámetro de consulta ?token=tu-clave-api

Parámetros

Parámetro Tipo Requerido Descripción
USCC cadena Sí Código de Crédito Social Unificado (USCC) de la empresa

Ejemplo de solicitud

GET /wp-json/chinacheckup/v1/getTranslationStatus?uscc=91110000625910848Y Encabezado: X-API-Key: YOUR_API_KEY

Respuesta

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

Campos de respuesta

Campo Tipo Descripción
USCC cadena La empresa solicitada es USCC.
traducción_completa entero Código de estado de la traducción (ver más abajo)
estado cadena Estado legible para humanos

Códigos de estado de traducción

Código Estado Descripción
0 en curso La traducción está pendiente o en curso.
1 completo La traducción ha finalizado; el informe está listo.
2 en curso Verificado pero incompleto: aún en proceso.

Costo

Gratis (0 créditos) – No se cobra por consultar el estado de la traducción.

Respuestas de error

Estado Código Descripción
400 falta_uscc Desaparecido USCC parámetro
401 falta_clave_api No se proporcionó ninguna clave API.
403 clave_de_pi_inválida Clave API no válida

Notas

  • Si nunca se ha solicitado información sobre la empresa, este punto final activará la obtención inicial de datos.
  • La traducción suele completarse en pocos minutos.
  • Consulta este punto final para comprobar cuándo un informe está listo para su visualización.
  • Una vez traducción_completa es 1, El informe está completamente traducido y listo.

Flujo de trabajo típico

  1. Llamar obtenerFull o obtenerBásico Para solicitar un informe de la empresa
  2. Encuesta obtenerEstadoDeTraducción cada 30-60 segundos
  3. Cuando estado es ""completo"", El informe traducido está listo.
  4. Llamar obtenerFull nuevamente para recuperar los datos completamente traducidos

Empezar