Create an Export Job

POST/api/v3/job

Create a new export job. The API automatically detects the platform from the URL and begins processing.

Request Body

ParameterTypeDescription

urlrequiredstringURL to export (must be from a supported platform) optionsobjectExport configuration options (see below)

Options Object

Pass additional options in the options field:

ParameterTypeDescription

options.limitintegerMaximum items to export (up to your tier's max) options.repliesbooleanInclude replies/nested comments (default: false) options.likesbooleanInclude likes data options.sharesbooleanInclude shares data options.followersbooleanExport followers instead of comments options.followingbooleanExport following instead of comments options.tweetsbooleanExport tweets (Twitter/X) options.livebooleanExport live chat data options.vpnstringVPN location name (see VPN Locations) options.poolstring (uuid)Proxy pool UUID to use options.cursorstringPagination cursor for continuing a previous export options.minTimestampintegerMinimum Unix timestamp filter options.maxTimestampintegerMaximum Unix timestamp filter options.cookiesobjectAuthentication cookies for private content options.facebookAdsbooleanExport Facebook Ads data only options.advancedbooleanEnable advanced search (Google)

Cookies Object

Some platforms require authentication cookies to access private or restricted content:

ParameterTypeDescription

options.cookies.sessionidstringSession ID (Instagram, general) options.cookies.auth_tokenstringAuth token (Twitter/X) options.cookies.cookie_userstringFacebook c_user cookie options.cookies.cookie_xsstringFacebook xs cookie

bash

curl -X POST https://exportcomments.com/api/v3/job \
  -H "X-AUTH-TOKEN: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "options": {
      "limit": 500,
      "replies": true
    }
  }'

Response — Single Job201

json

{
  "guid": "b4219d47-3138-5efd-9762-2ef9f9495084"
}

💡

Use the Retrieve endpoint for full job details

The creation response only returns the guid. To get the full job object (status, download links, etc.) use the Retrieve Job endpoint with that guid.

Batch Job Creation

Send {"urls": [...]} instead of {"url": "..."} to create multiple jobs in a single request.

Response — Batch Jobs201

json

{
  "data": [
    {
      "guid": "b4219d47-3138-5efd-9762-2ef9f9495084",
      "item": {}
    },
    {
      "guid": "c7341e58-4249-6fae-0873-3fg0g0506195",
      "item": {}
    }
  ]
}

💡

Job processing is asynchronous

A newly created job starts in queueing status. Use the Retrieve Job endpoint to poll for status changes, or set up a webhook to be notified when the job completes.