POST/v1/tasks/upload

Upload Tasks

Upload a CSV/TSV file containing multiple tasks for a squid

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

Key	Value	Required
Authorization	Token YOUR_API_KEY	Yes
Content-Type	multipart/form-data	Yes

Form Data Parameters

filefile

Required

CSV or TSV file containing task data. Column headers should match crawler parameter keys

Example: tasks.csv

squidstring

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

object

string

Always "task_upload"

Example: task_upload

Pro Tip

Use the returned task ID with Check Upload Status to monitor the upload progress.

Note

CSV column headers must match the crawler's expected parameter keys (e.g., 'url', 'city', 'activity').

Warning

Large files may take time to process. Always check upload status before running the squid.

Pro Tip

TSV (tab-separated) files are also supported and may be easier to work with for URLs containing commas.