Create a Batch Export

POST/api/v1/batch-export

Submit up to 25 URLs (Premium) or 100 URLs (Business) in one request. The API creates one independent export job per URL, all tagged with the same batch_id. Duplicate URLs inside the array are de-duplicated automatically before jobs are created.

Request Body

ParameterTypeDescription

urlsrequiredarray<string>Array of URLs to export. Each must be from a supported platform. Invalid / unsupported URLs are reported in the errors array of the response and DO NOT consume a job slot. optionsobjectExport options applied to EVERY URL in the batch. Same shape as the Create Job options (limit, replies, likes, vpn, cookies, etc.). Per-URL overrides are not supported in this endpoint — split the batch if you need different options per URL.

bash

curl -X POST https://exportcomments.com/api/v1/batch-export \
  -H "X-AUTH-TOKEN: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.instagram.com/p/Cabc123/",
      "https://www.tiktok.com/@user/video/7223456789012345678",
      "https://www.facebook.com/page/posts/9876543210"
    ],
    "options": {
      "replies": true,
      "limit": 5000
    }
  }'

Response201

json

{
  "batch_id": "b1d49f3e-7a4c-4c2b-9d8e-1234567890ab",
  "guids": [
    "abc12345-6789-0abc-def0-123456789abc",
    "def67890-1234-5678-9abc-def012345678",
    "ghi34567-89ab-cdef-0123-456789abcdef"
  ],
  "errors": []
}

Partial-success responses

If some URLs are unsupported / malformed, the endpoint still creates jobs for the valid ones and reports the failures in errors. Indexes refer to the original urls array position:

json

{
  "batch_id": "b1d49f3e-7a4c-4c2b-9d8e-1234567890ab",
  "guids": [
    "abc12345-6789-0abc-def0-123456789abc",
    "ghi34567-89ab-cdef-0123-456789abcdef"
  ],
  "errors": [
    { "index": 1, "url": "not-a-url", "error": "Unsupported or invalid URL." }
  ]
}

Error responses

Status	Reason
`400`	`urls` array missing, empty, or exceeds plan ceiling (25 / 100)
`400`	"Bulk export requires a Premium or Business plan." — caller is Free / Personal
`401`	Missing or invalid `X-AUTH-TOKEN`
`429`	Too many batch creation calls in the rate window — back off and retry
`500`	Server-side failure (none of the jobs were created — safe to retry)

💡

Same options apply to every URL

The options object is applied uniformly to every job in the batch. If different URLs need different options (e.g. some need replies: true, others don't), submit them as separate batches.