Quickstart

Prerequisites

• Valid API key (get one here)

• Post URL that you want to analyze

• Workspace ID (we'll show you how to get this)

Step 1: Get Your Workspace ID

Every data collection needs a workspace. List your available workspaces:

curl -H "X-API-Key: your_api_key_here" \
     https://production.viacurrent.com/api/workspaces/

Response:

[  {    "workspace_id": "507f1f77bcf86cd799439011",    "name": "My Company Workspace",    "role": "owner"  }]

Save the workspace_id - you'll need it for data collection.

Step 2: Start Data Collection

Create a collection task for a post:

curl -X POST \
     -H "X-API-Key: your_api_key_here" \
     -H "Content-Type: application/json" \
     -d '{
       "post_url": "https://www.linkedin.com/posts/username_activity-1234567890",
       "data_types": ["comment", "reaction"],
       "workspace_id": "507f1f77bcf86cd799439011"
     }' \
     https://production.viacurrent.com/api/workbooks/

Response:

{
  "task_id": "abc123-def456-ghi789",
  "status": "pending"
}

Save the task_id to monitor progress.

Step 3: Monitor Progress

Check your task status:

curl -H "X-API-Key: your_api_key_here" \
     https://production.viacurrent.com/tasks/abc123-def456-ghi789/status

When completed:

{
  "task_id": "abc123-def456-ghi789",
  "status": "success",
  "completed_at": "2025-08-10T10:30:00Z",
  "result": {
    "workbook_id": "507f1f77bcf86cd799439012",
    "items_collected": 150,
    "success": true
  }
}

The workbook_id is your key to accessing the collected data.

Step 4: Retrieve Your Data

Use the workbook_id to get the collected data:

Get All Contacts

Returns a de-duplicated list of all comment and reaction authors

curl -H "X-API-Key: your_api_key_here" \
     https://production.viacurrent.com/api/workbooks/507f1f77bcf86cd799439012/contacts

Get Comments

curl -H "X-API-Key: your_api_key_here" \
     https://production.viacurrent.com/api/workbooks/507f1f77bcf86cd799439012/comments

Get Reactions

curl -H "X-API-Key: your_api_key_here" \
     https://production.viacurrent.com/workbooks/507f1f77bcf86cd799439012/reactions

⚠️ Important: 12-Hour Data Window

Your data lives in a temporary workbook that expires after 12 hours. Make sure to download everything you need within this timeframe.

Common Issues

422 Validation Error? Check that your URL format is correct and all required fields are provided.

403 Forbidden? Verify you have access to the workspace ID you're using.

409 Conflict? A collection task is already running for this post. Wait for it to complete or check its status.