Basic Usage
Get Latest Data
Retrieve the most recent data from a workflow: View full API reference →Pagination and Filtering
Handle Large Datasets
Use pagination for efficient data retrieval:Filtering Options
Target specific data with query parameters:- Date Range:
?startDate=2024-01-01&endDate=2024-01-31 - Status Filter:
?status=success - Changes Only:
?changesOnly=true - Fields:
?fields=title,price,extractedAt
Example with Filters
Data Formats
JSON (Default)
Standard JSON format, perfect for modern applications:CSV Format
AddAccept: text/csv header for CSV output:
Parquet Download
Download the complete dataset for a workflow run as a typed Parquet file: View full API reference →runId to download a specific historical run:
Content-Type: application/vnd.apache.parquet and Content-Disposition: attachment. Unlike the JSON and CSV data endpoint, Parquet downloads do not support pagination, filtering, sorting, or field selection. If you need a subset, download the file and filter it in your warehouse or query engine.
Typed columns are preserved where the workflow schema provides native types, including booleans, numbers, dates, timestamps, JSON-compatible objects, and arrays. Older workflow runs may still reflect the type information available when that run was produced.
Error Handling
Common HTTP Status Codes
| Code | Meaning | Action |
|---|---|---|
| 200 | Success | Process data normally |
| 400 | Bad Request | Check query parameters |
| 401 | Unauthorized | Verify API key |
| 404 | Not Found | Check workflow ID |
| 429 | Rate Limited | Wait and retry |
| 500 | Server Error | Contact support |