Retrieve an Export Job

GET/api/v3/job/{guid}

Retrieve details of a specific export job by GUID. Use this endpoint to poll job status or fetch download links once a job completes.

Path Parameters

ParameterTypeDescription

guidrequiredstringJob GUID identifier

bash

curl https://exportcomments.com/api/v3/job/b4219d47-3138-5efd-9762-2ef9f9495084 \
  -H "X-AUTH-TOKEN: your-api-key"

Response (completed job)200

json

{
  "id": 12345,
  "guid": "b4219d47-3138-5efd-9762-2ef9f9495084",
  "status": "done",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "options": {
    "limit": 500,
    "replies": true
  },
  "locked": false,
  "json_url": "https://exportcomments.com/exports/12345.json",
  "download_link": "https://exportcomments.com/exports/12345.xlsx"
}

Response (in-progress job)200

json

{
  "id": 12345,
  "guid": "b4219d47-3138-5efd-9762-2ef9f9495084",
  "status": "progress",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "options": {
    "limit": 500,
    "replies": true
  },
  "locked": false,
  "json_url": null,
  "download_link": null
}

💡

Polling interval

Poll at 5-10 second intervals to avoid hitting rate limits. For production workloads, use webhooks instead of polling to avoid consuming API quota.