export

Create a new export job for a URL. Alias: create.

bash

exportcomments export <url> [options]

Options

ParameterTypeDescription

--repliesflagInclude replies to comments --limit <n>numberMaximum number of items to export --min-date <date>stringStart date filter (ISO 8601) --max-date <date>stringEnd date filter (ISO 8601) --vpn <country>stringUse VPN with the specified country code --cookies <json>stringCookies as a JSON string --tweetsflagInclude tweets (Twitter/X only) --followersflagExport followers (Twitter/X only) --followingflagExport following list (Twitter/X only) --likesflagExport likes --sharesflagInclude shares data --advancedflagEnable advanced export features --facebook-adsflagInclude Facebook ads data --waitflagWait for the job to complete (polls every 5s) --realtimeflagUse WebSocket for real-time status updates --wait-interval <ms>numberCustom polling interval in milliseconds --wait-timeout <ms>numberCustom timeout in milliseconds (default: 600000) --downloadflagDownload Excel/CSV file when done (implies --wait) --download-jsonflagDownload raw JSON when done (implies --wait)

Examples

Basic export:

bash

exportcomments export https://www.instagram.com/p/ABC123/

With options:

bash

exportcomments export https://www.youtube.com/watch?v=dQw4w9WgXcQ --replies --limit 500

Wait for completion and download:

bash

exportcomments export https://www.amazon.com/dp/B08N5WRWNW --wait --download

Download raw JSON data:

bash

exportcomments export https://www.trustpilot.com/review/example.com --wait --download-json

Filter by date range:

bash

exportcomments export https://www.reddit.com/r/sub/comments/abc123/ \
  --min-date 2024-01-01 --max-date 2024-06-30

Twitter/X specific options:

bash

exportcomments export https://x.com/username --tweets --followers --limit 1000

Real-time monitoring:

bash

exportcomments export https://www.amazon.com/dp/B08N5WRWNW --wait --realtime

Response200

json

{
  "ok": true,
  "data": {
    "id": 12345,
    "guid": "b4219d47-3138-5efd-9762-2ef9f9495084",
    "status": "queueing",
    "url": "https://www.instagram.com/p/ABC123/"
  }
}

💡

Waiting for completion

When using --wait, the CLI polls the API every 5 seconds (configurable with --wait-interval) until the job reaches a done or error status, or the timeout is reached.