Saltar al contenido principal
Usa datos de pago de proveedores de datos especializados en tu propia aplicación con una única Key de Glasser y saldo. Cada Endpoint es una operación de un proveedor de datos, como el enriquecimiento de empresas o la investigación de palabras clave. Busca en las fuentes de datos, inspecciona las entradas y el Price de un Endpoint y ejecútalo para obtener los datos del proveedor de datos. Para comprender el flujo de datos y elegir cómo se conectará tu producto, empieza por Integraciones.

​
Autenticación

La URL base de la API es https://api.glasser.ai. Las solicitudes a /v1 necesitan una Key. Crea una en Keys y configúrala como GLASSER_API_KEY en tu entorno. Envíala en el encabezado Authorization: Bearer. Comprueba la conexión con esta solicitud gratuita de saldo:

​
Límites de solicitudes

Nuestro límite actual es de 600 solicitudes por minuto por clave de API y por ruta de API.

​
Explorar proveedores de datos y Endpoints

Lista de proveedores de datos y Endpoints con GET /public/catalog. Esta solicitud pública y gratuita no necesita una Key y devuelve la lista completa en una sola respuesta: providers describe cada proveedor de datos; entries enumera sus Endpoints y precios visibles. Úsala para elegir un Endpoint durante el desarrollo o crear un selector de proveedores de datos. La lista está en caché y no aplica la Policy de tu Key. Inspecciona el Endpoint elegido con tu Key para consultar su esquema y Price actual.

​
Buscar, inspeccionar y ejecutar

  1. Buscar Endpoints. Encuentra datos para tu tarea. Usa query para los términos de búsqueda, como company enrichment, e incluye el use_case requerido, como Create a company profile for glasser.ai. Los resultados identifican el proveedor de datos, el Endpoint y la versión del Endpoint, con su Price.
  2. Inspeccionar el Endpoint. Consulta su input_schema, un ejemplo de entrada y el Price, incluidas las reglas de cobro para cada resultado. Usa este esquema para crear la entrada del proveedor de datos.
  3. Ejecutar el Endpoint. Envía el provider y el endpoint seleccionados, junto con la entrada que creaste, a POST /v1/runs. Esto crea un Run y recupera los datos según las reglas de cobro de ese Endpoint.
La búsqueda y la inspección son gratuitas. Crear un Run requiere un encabezado Idempotency-Key. Conserva el mismo valor al reintentar la misma solicitud; usa un valor nuevo para una ejecución nueva.

​
Leer el resultado

Una solicitud de datos devuelve un Run. Lee estos campos antes de usar el resultado: Un Run puede devolver HTTP 200 con status: "COMPLETED" incluso cuando el proveedor de datos rechaza la solicitud. En ese caso, output es null; lee el estado y el cuerpo del error del proveedor de datos en provider_response. Las listas de Runs solo contienen resúmenes; usa Obtener un Run para consultar todos los detalles del error. Reintentar un Run completado con el mismo Idempotency-Key y la misma entrada devuelve el mismo resultado sin otra llamada al proveedor de datos. Usa una clave nueva para otro intento, incluida una solicitud con una entrada modificada. Consulta Cómo funciona para conocer los estados de Run, los precios y los reintentos.

​
Soluciones para tareas comunes

Las soluciones ofrecen una ruta más corta para solicitudes comunes. Por ejemplo, company_intelligence acepta un dominio, después Glasser selecciona un Endpoint y convierte la entrada para su proveedor de datos. Úsala cuando los parámetros disponibles de Glasser cubran tu tarea. Utiliza la misma Key y el mismo saldo, y devuelve un Run normal. Consulta la descripción general de Soluciones para conocer las capacidades disponibles, la selección de proveedores de datos y los cobros.