Skip to main content
GET
Lister les exécutions
GET https://api-datahub.octoparse.com/v1/runs Authentification : clé API requise (Authorization: Bearer <API Key>). Toutes les exécutions que vous avez démarrées. La propriété est par compte : celles démarrées avec une clé API, SDK, MCP ou login web apparaissent dans la même liste. Toujours du plus récent au plus ancien par heure de début. pagination.total est le total filtré. Les filtres se combinent. status accepte des valeurs séparées par des virgules (OR). credential est l’id stable non sensible de la credential de démarrage, utile pour suivre quelle clé consomme le quota. created_from / created_to utilisent l’heure de début, début inclusif et fin exclusive. Le vocabulaire correspond à Agrégation de facturation : passez une clé de groupe de facturation telle quelle pour détailler les exécutions correspondantes. Chaque item inclut billing et usage, donc le rapprochement par exécution n’a pas besoin d’un appel de détail séparé. L’expurgation de l’écho d’entrée correspond au détail d’exécution.

Requête

Paramètres de requête

string
État de l’exécution. Multivaleur séparée par des virgules. Les valeurs hors vocabulaire renvoient 400.
string
Id stable de la credential de démarrage. Prenez la valeur de l’agrégation de facturation group_by=credentialcredential.
string
Référence d’app : <namespace>/<app_name> ou app_<hex>.
string
Canal de démarrage, par exemple api / sdk / mcp / cli / web.
string
Borne inférieure d’heure de début, inclusive. Horodatage ISO-8601 absolu.
string
Borne supérieure d’heure de début, exclusive.
string
production pour les exécutions normales ; test pour le debug de l’auteur.Valeurs : test / production.
integer
défaut:"0"
Offset de pagination.Plage ≥ 0.
integer
défaut:"50"
Taille de page, max 200.Plage 1 à 200.

Exemple de requête

Réponse

200 succès

La charge utile est encapsulée dans data. Champs :
object[]
requis
Liste d’exécutions. Chaque item correspond aux champs de détail d’exécution (sans sample_records).
object
Objet de pagination.

Erreurs

Les réponses d’erreur utilisent {"error": {code, category, message, retryable}}. Voir Erreurs.

Bibliothèques clientes