Skip to main content
POST
Upload Tasks
This endpoint allows you to upload a file (CSV/TSV) containing multiple tasks for a specific squid. The file should contain task parameters in columns matching the crawler’s expected keys. This is ideal for bulk task creation.

Headers

string
required
Your API authentication token. Value: Token YOUR_API_KEY
string
required
Must be multipart/form-data for file upload. Value: multipart/form-data

Form Data Parameters

file
required
CSV or TSV file containing task data. Column headers should match crawler parameter keys. Example: tasks.csv
string
required
The hash ID of the squid to add tasks to. Example: "a1b2c3d4e5f6g7h8i9j0"

Response Field Explanations

string
Upload task identifier for tracking progress. Example: "427a7bfc54cf4ce483d83ba23425164b"
string
Always “task_upload”. Example: "task_upload"
Use the returned task ID with Check Upload Status to monitor the upload progress.
CSV column headers must match the crawler’s expected parameter keys (e.g., ‘url’, ‘city’, ‘activity’).
Large files may take time to process. Always check upload status before running the squid.
TSV (tab-separated) files are also supported and may be easier to work with for URLs containing commas.

Code Examples

Response

200