Runs & Results
Run-Datensätze abrufen
Von einem Run erzeugte Datensätze seitenweise lesen. Unterstützt JSON, JSONL, CSV und Spaltenprojektion.
GET
Run-Datensätze abrufen
GET https://api-datahub.octoparse.com/v1/runs/{run_id}/records
Authentifizierung: API-Schlüssel erforderlich (Authorization: Bearer <API Key>).
Blättert durch die von einem Run erzeugten Datensätze. format unterstützt json (Standard, mit Paginierung im Envelope), jsonl und csv. fields ist eine kommagetrennte Spaltenprojektion.
Lesen während der Run noch läuft möglich; Sie erhalten das bisher Produzierte, pagination.total wächst. Für das vollständige Ergebnis auf terminalen Status warten. partial ist true bei Teilerfolg oder Cancel; diese Datensätze sind gültig und bereits abgerechnet.
Sie können nur selbst gestartete Runs lesen. run_id eines anderen Accounts und fehlende run_id liefern beide 404.
Anfrage
Pfadparameter
string
erforderlich
Run-ID.
Abfrageparameter
integer
Standard:"0"
Paginierungs-Offset.Bereich ≥ 0.
integer
Standard:"100"
Seitengröße, max 10000.Bereich 1 bis 10000.
string
Standard:"json"
Ausgabeformat.
json ist mit Paginierung enveloped; jsonl ein Record pro Zeile; csv tabellarisch.Werte: json / jsonl / csv.string
Kommagetrennte Feldnamen. Nur diese Spalten werden zurückgegeben, z. B.
title,price,url.Beispielanfrage
Antwort
200 Erfolg
format=jsonl oder format=csv ist der Response-Body Rohtext ohne Envelope. Paginierungsparameter gelten weiterhin.
Payload ist in data gewrappt. Felder:
string
Run-ID.
string
erforderlich
Dataset, das das Ergebnis enthält.
object[]
erforderlich
Record-Array. Jedes Element folgt dem App-
output_schema.record.boolean
Ob der Run teilweise erfolgreich war oder abgebrochen wurde.
object
erforderlich
Paginierungsobjekt.
Fehler
Fehlerantworten nutzen
{"error": {code, category, message, retryable}}. Siehe Fehler.