Skip to main content
GET
Listar ejecuciones
GET https://api-datahub.octoparse.com/v1/runs Autenticación: se requiere API key (Authorization: Bearer <API Key>). Todas las ejecuciones que iniciaste. La propiedad es por cuenta: las iniciadas con API key, SDK, MCP o login web aparecen en la misma lista. Siempre de más reciente a más antigua por hora de inicio. pagination.total es el total filtrado. Los filtros se pueden combinar. status admite valores separados por comas (OR). credential es el id estable no sensible de la credencial de inicio, útil para ver qué clave consume cuota. created_from / created_to usan la hora de inicio, inicio inclusivo y fin exclusivo. El vocabulario coincide con Agregación de facturación: pasa una clave de grupo de facturación sin cambios para profundizar en las ejecuciones correspondientes. Cada ítem incluye billing y usage, así que la conciliación por ejecución no necesita una llamada de detalle aparte. La redacción del eco de entrada coincide con el detalle de ejecución.

Solicitud

Parámetros de consulta

string
Estado de la ejecución. Multivalor separado por comas. Valores fuera del vocabulario devuelven 400.
string
Id estable de la credencial de inicio. Toma el valor de la agregación de facturación group_by=credentialcredential.
string
Referencia de app: <namespace>/<app_name> o app_<hex>.
string
Canal de inicio, por ejemplo api / sdk / mcp / cli / web.
string
Límite inferior de hora de inicio, inclusivo. Marca de tiempo ISO-8601 absoluta.
string
Límite superior de hora de inicio, exclusivo.
string
production para ejecuciones normales; test para debug del autor.Valores: test / production.
integer
predeterminado:"0"
Offset de paginación.Rango ≥ 0.
integer
predeterminado:"50"
Tamaño de página, máximo 200.Rango 1 a 200.

Ejemplo de solicitud

Respuesta

200 correcto

La carga útil va envuelta en data. Campos:
object[]
requerido
Lista de ejecuciones. Cada ítem coincide con los campos de detalle de ejecución (sin sample_records).
object
Objeto de paginación.

Errores

Las respuestas de error usan {"error": {code, category, message, retryable}}. Véase Errores.

Bibliotecas cliente