Saltar al contenido principal
POST
Buscar endpoints ejecutables
Elige un candidato y, antes de ejecutarlo, inspecciónalo. 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.

Cuerpo

application/json
use_case
string
requerido

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.

Minimum string length: 1
query
string | null

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.

limit
integer | null

Máximo de resultados por página. Predeterminado: 5; máximo: 20.

Rango requerido: 1 <= x <= 20
cursor
string | null

El next_cursor de la respuesta anterior. Usa la misma consulta; un cursor de otra consulta devuelve 400.

task_id
string | null

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.

metadata

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.

Respuesta

Éxito

data
object[]
requerido

Resúmenes de endpoints ordenados por relevancia y filtrados según la Policy de tu API Key. El Price no afecta al orden.

next_cursor
string | null
requerido

Pasa este valor como cursor para obtener la página siguiente. Null significa que no hay más páginas.

total
integer
requerido

Número total de candidatos clasificados en todas las páginas.

Rango requerido: x >= 0
task_id
string
requerido

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.

client
object