> ## Documentation Index > Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Buscar endpoints ejecutables > Encuentra Endpoints para los datos que necesitas y compara proveedores de datos y Prices. La búsqueda devuelve formas de recuperar datos; no recupera los datos en sí. Elige un candidato y, antes de ejecutarlo, [inspecciónalo](https://glasser.ai/docs/es/api-reference/endpoints/inspect.md). Si los resultados no encajan, prueba con otras palabras clave; las puntuaciones bajas o la última página no demuestran que una capacidad no esté disponible. ## OpenAPI ````yaml /openapi.es.json post /v1/endpoints/search openapi: 3.1.0 info: title: Glasser version: 0.0.1 description: >- Una API Key, sin contrato, con pago por llamada, para APIs de pago adquiridas al por mayor. Cada respuesta incluye x-request-id; cada cuerpo de error incluye el mismo sobre. servers: - url: https://api.glasser.ai security: [] tags: - name: Solutions - name: Endpoints - name: Runs - name: Balance paths: /v1/endpoints/search: post: tags: - Endpoints summary: Buscar endpoints ejecutables description: >- Busca endpoints ejecutables por palabra clave; esto devuelve candidatos de endpoints, no datos de negocio. Los resultados se ordenan por relevancia, se filtran según la Policy de tu API Key e incluyen el proveedor de datos, la versión del endpoint, el Price y el modo de ejecución. Compara los candidatos e Inspect antes de ejecutar. Usa next_cursor para obtener más resultados. Las puntuaciones bajas o la última página no demuestran que una capacidad esté ausente; prueba con otras palabras clave. Reutiliza el task_id devuelto en las llamadas posteriores de la misma tarea. operationId: endpoints-search parameters: [] requestBody: content: application/json: schema: type: object properties: query: anyOf: - type: string description: >- Palabras clave que describen los datos que necesitas. Omite este campo o déjalo vacío para explorar todos los endpoints permitidos por la Policy de tu API Key. - type: 'null' limit: anyOf: - type: integer minimum: 1 maximum: 20 description: >- Máximo de resultados por página. Predeterminado: 5; máximo: 20. - type: 'null' cursor: anyOf: - type: string description: >- El next_cursor de la respuesta anterior. Usa la misma consulta; un cursor de otra consulta devuelve 400. - type: 'null' task_id: anyOf: - type: string description: >- La tarea a la que pertenece esta búsqueda. Una búsqueda sin task_id inicia una tarea nueva. La respuesta devuelve su task_id. Envíelo en cada búsqueda, inspección y ejecución posteriores del mismo trabajo. Se acepta cualquier cadena estable. - type: 'null' metadata: anyOf: - anyOf: - type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ - {} description: >- Campos de seguimiento opcionales, devueltos en el Run y disponibles como filtros. Nunca se envían al proveedor de datos ni afectan al enrutamiento, al Price ni a la idempotencia. - Hasta 20 claves: letras minúsculas, dígitos y guiones bajos; deben comenzar por una letra y tener como máximo 40 caracteres. - Valores: cadenas de 1 a 500 caracteres. - user_id: el ID opaco de su usuario final, nunca su dirección de correo electrónico ni su nombre. Las entradas no válidas se descartan por completo, no se truncan. La solicitud continúa y el Run devuelve los campos que se almacenaron. - type: 'null' use_case: type: string minLength: 1 description: >- Obligatorio en cada búsqueda. El caso de uso de esta búsqueda: lo que el usuario solicitó, con sus propias palabras, incluido el asunto: la empresa, el dominio, el ticker, el lugar o el tema. Acorte una solicitud larga en lugar de reescribirla. required: - use_case additionalProperties: false required: true responses: '200': description: Éxito content: application/json: schema: type: object properties: data: type: array items: type: object properties: provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ provider_label: type: string description: >- Nombre de marca del proveedor de datos, para mostrarlo: "People Data Labs" para el proveedor de datos "pdl". La identidad permanece en `provider`: ese es el valor que toman value y inspect, y este nunca se devuelve. endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 description: >- Versión compatible del endpoint. Las actualizaciones compatibles mantienen esta versión. name: type: string description: type: string tags: type: array items: type: string price: type: object properties: rule: anyOf: - type: object properties: type: type: string enum: - flat amount_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. required: - type - amount_usd additionalProperties: false - type: object properties: type: type: string enum: - per_result per_result_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. cap_usd: anyOf: - type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. - type: 'null' partial_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. required: - type - per_result_usd - cap_usd additionalProperties: false - type: object properties: type: type: string enum: - per_token per_million_input_tokens_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. cap_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. required: - type - per_million_input_tokens_usd - cap_usd additionalProperties: false - type: object properties: type: type: string enum: - base_plus_per_result base_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. included_results: type: integer minimum: 0 per_extra_result_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. cap_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. unit: type: string required: - type - base_usd - included_results - per_extra_result_usd - cap_usd additionalProperties: false - type: object properties: type: type: string enum: - metered base_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. cap_usd: anyOf: - type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. - type: 'null' base_kind: type: string enum: - starting required: - type - base_usd - cap_usd additionalProperties: false - type: object properties: type: type: string enum: - per_event events: type: object additionalProperties: type: object properties: usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. title: type: string required: - usd - title additionalProperties: false base_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. cap_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. required: - type - events - base_usd - cap_usd additionalProperties: false - type: object properties: type: type: string required: - type allOf: - type: object additionalProperties: {} display: type: object properties: amount_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. unit: type: string cap_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. required: - amount_usd - unit additionalProperties: false charges: type: object properties: NO_RESULT: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. PROVIDER_ERROR: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. TIMED_OUT: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. INTERNAL: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Cadena decimal USD exacta (mínimo 2 y máximo 6 decimales, con una única representación canónica). Suma con aritmética decimal o escala por 10^6; nunca uses números de coma flotante. required: - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL additionalProperties: false required: - rule - display - charges additionalProperties: false description: >- Price actual y reglas de cobro. Price puede cambiar sin que cambie la versión del endpoint. Los nuevos Runs utilizan el Price vigente al admitirse; los Runs aceptados conservan ese Price. run_mode: type: string enum: - sync - async timeout_ms: anyOf: - type: integer exclusiveMinimum: 0 description: >- Para endpoints síncronos, tiempo máximo en milisegundos desde una solicitud de Run hasta su respuesta terminal. Configura el tiempo de espera de tu cliente HTTP por encima de este valor. - type: 'null' score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Similitud coseno entre la consulta y el texto consultable de este endpoint, en [-1, 1]; null cuando no se ejecutó la puntuación semántica. Es una señal de similitud para comparar filas, no un veredicto: la clasificación combina dos componentes, y ni una puntuación baja ni el final de los resultados demuestran que una capacidad esté ausente. required: - provider - provider_label - endpoint - endpoint_version - name - description - tags - price - run_mode - score additionalProperties: false description: >- Resúmenes de endpoints ordenados por relevancia y filtrados según la Policy de tu API Key. El Price no afecta al orden. client: type: object properties: client_version: anyOf: - type: string - type: 'null' minimum_version: type: string latest_version: type: string upgrade_command: type: string reason: type: string required: - client_version - minimum_version - latest_version - upgrade_command - reason additionalProperties: false next_cursor: anyOf: - type: string - type: 'null' description: >- Pasa este valor como cursor para obtener la página siguiente. Null significa que no hay más páginas. total: type: integer minimum: 0 description: >- Número total de candidatos clasificados en todas las páginas. task_id: type: string description: >- La tarea con la que se registró esta búsqueda: la que enviaste o una nueva si no enviaste ninguna. Devuélvela en cada búsqueda, inspect y Run posteriores del mismo trabajo. required: - data - next_cursor - total - task_id additionalProperties: false '400': description: ValidationFailed content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationFailedEncoded' - $ref: '#/components/schemas/ValidationFailedEncoded' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/UnauthorizedEncoded' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ForbiddenEncoded' '429': description: RateLimited content: application/json: schema: $ref: '#/components/schemas/RateLimitedEncoded' security: - bearer: [] components: schemas: ValidationFailedEncoded: type: object properties: error: type: object properties: code: type: string enum: - validation_failed message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false UnauthorizedEncoded: type: object properties: error: type: object properties: code: type: string enum: - unauthorized message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false ForbiddenEncoded: type: object properties: error: type: object properties: code: type: string enum: - forbidden message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false RateLimitedEncoded: type: object properties: error: type: object properties: code: type: string enum: - rate_limited message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false securitySchemes: bearer: type: http scheme: Bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.