Bulk Add Tasks

curl --request POST \
  --url https://monitor-api.tweet-catcher.com/pro/bulk-add-tasks \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "user": "gioppooo",
    "options": [
      "posts",
      "retweets"
    ],
    "notification": "discord",
    "webhook": "https://discord.com/api/webhooks/...",
    "start": true
  },
  {
    "user": "another_user",
    "options": [
      "posts"
    ],
    "notification": "websocket",
    "start": false
  },
  {
    "module": "twitter_keyword",
    "keyword": "bitcoin",
    "notification": "websocket",
    "start": true
  }
]
'

import requests

url = "https://monitor-api.tweet-catcher.com/pro/bulk-add-tasks"

payload = [
    {
        "user": "gioppooo",
        "options": ["posts", "retweets"],
        "notification": "discord",
        "webhook": "https://discord.com/api/webhooks/...",
        "start": True
    },
    {
        "user": "another_user",
        "options": ["posts"],
        "notification": "websocket",
        "start": False
    },
    {
        "module": "twitter_keyword",
        "keyword": "bitcoin",
        "notification": "websocket",
        "start": True
    }
]
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify([
    {
      user: 'gioppooo',
      options: ['posts', 'retweets'],
      notification: 'discord',
      webhook: 'https://discord.com/api/webhooks/...',
      start: true
    },
    {
      user: 'another_user',
      options: ['posts'],
      notification: 'websocket',
      start: false
    },
    {
      module: 'twitter_keyword',
      keyword: 'bitcoin',
      notification: 'websocket',
      start: true
    }
  ])
};

fetch('https://monitor-api.tweet-catcher.com/pro/bulk-add-tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://monitor-api.tweet-catcher.com/pro/bulk-add-tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'user' => 'gioppooo',
        'options' => [
                'posts',
                'retweets'
        ],
        'notification' => 'discord',
        'webhook' => 'https://discord.com/api/webhooks/...',
        'start' => true
    ],
    [
        'user' => 'another_user',
        'options' => [
                'posts'
        ],
        'notification' => 'websocket',
        'start' => false
    ],
    [
        'module' => 'twitter_keyword',
        'keyword' => 'bitcoin',
        'notification' => 'websocket',
        'start' => true
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://monitor-api.tweet-catcher.com/pro/bulk-add-tasks"

	payload := strings.NewReader("[\n  {\n    \"user\": \"gioppooo\",\n    \"options\": [\n      \"posts\",\n      \"retweets\"\n    ],\n    \"notification\": \"discord\",\n    \"webhook\": \"https://discord.com/api/webhooks/...\",\n    \"start\": true\n  },\n  {\n    \"user\": \"another_user\",\n    \"options\": [\n      \"posts\"\n    ],\n    \"notification\": \"websocket\",\n    \"start\": false\n  },\n  {\n    \"module\": \"twitter_keyword\",\n    \"keyword\": \"bitcoin\",\n    \"notification\": \"websocket\",\n    \"start\": true\n  }\n]")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://monitor-api.tweet-catcher.com/pro/bulk-add-tasks")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("[\n  {\n    \"user\": \"gioppooo\",\n    \"options\": [\n      \"posts\",\n      \"retweets\"\n    ],\n    \"notification\": \"discord\",\n    \"webhook\": \"https://discord.com/api/webhooks/...\",\n    \"start\": true\n  },\n  {\n    \"user\": \"another_user\",\n    \"options\": [\n      \"posts\"\n    ],\n    \"notification\": \"websocket\",\n    \"start\": false\n  },\n  {\n    \"module\": \"twitter_keyword\",\n    \"keyword\": \"bitcoin\",\n    \"notification\": \"websocket\",\n    \"start\": true\n  }\n]")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://monitor-api.tweet-catcher.com/pro/bulk-add-tasks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "[\n  {\n    \"user\": \"gioppooo\",\n    \"options\": [\n      \"posts\",\n      \"retweets\"\n    ],\n    \"notification\": \"discord\",\n    \"webhook\": \"https://discord.com/api/webhooks/...\",\n    \"start\": true\n  },\n  {\n    \"user\": \"another_user\",\n    \"options\": [\n      \"posts\"\n    ],\n    \"notification\": \"websocket\",\n    \"start\": false\n  },\n  {\n    \"module\": \"twitter_keyword\",\n    \"keyword\": \"bitcoin\",\n    \"notification\": \"websocket\",\n    \"start\": true\n  }\n]"

response = http.request(request)
puts response.read_body

event: progress
data: {"index":0,"total":3,"result":{"error":false}}

event: done
data: {"total":3}

{
  "error": true,
  "message": "Invalid request parameters"
}

{
  "error": true,
  "message": "Invalid or missing authorization token"
}

POST

https://monitor-api.tweet-catcher.com/pro

bulk-add-tasks

Bulk Add Tasks

curl --request POST \
  --url https://monitor-api.tweet-catcher.com/pro/bulk-add-tasks \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "user": "gioppooo",
    "options": [
      "posts",
      "retweets"
    ],
    "notification": "discord",
    "webhook": "https://discord.com/api/webhooks/...",
    "start": true
  },
  {
    "user": "another_user",
    "options": [
      "posts"
    ],
    "notification": "websocket",
    "start": false
  },
  {
    "module": "twitter_keyword",
    "keyword": "bitcoin",
    "notification": "websocket",
    "start": true
  }
]
'

import requests

url = "https://monitor-api.tweet-catcher.com/pro/bulk-add-tasks"

payload = [
    {
        "user": "gioppooo",
        "options": ["posts", "retweets"],
        "notification": "discord",
        "webhook": "https://discord.com/api/webhooks/...",
        "start": True
    },
    {
        "user": "another_user",
        "options": ["posts"],
        "notification": "websocket",
        "start": False
    },
    {
        "module": "twitter_keyword",
        "keyword": "bitcoin",
        "notification": "websocket",
        "start": True
    }
]
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify([
    {
      user: 'gioppooo',
      options: ['posts', 'retweets'],
      notification: 'discord',
      webhook: 'https://discord.com/api/webhooks/...',
      start: true
    },
    {
      user: 'another_user',
      options: ['posts'],
      notification: 'websocket',
      start: false
    },
    {
      module: 'twitter_keyword',
      keyword: 'bitcoin',
      notification: 'websocket',
      start: true
    }
  ])
};

fetch('https://monitor-api.tweet-catcher.com/pro/bulk-add-tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://monitor-api.tweet-catcher.com/pro/bulk-add-tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'user' => 'gioppooo',
        'options' => [
                'posts',
                'retweets'
        ],
        'notification' => 'discord',
        'webhook' => 'https://discord.com/api/webhooks/...',
        'start' => true
    ],
    [
        'user' => 'another_user',
        'options' => [
                'posts'
        ],
        'notification' => 'websocket',
        'start' => false
    ],
    [
        'module' => 'twitter_keyword',
        'keyword' => 'bitcoin',
        'notification' => 'websocket',
        'start' => true
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://monitor-api.tweet-catcher.com/pro/bulk-add-tasks"

	payload := strings.NewReader("[\n  {\n    \"user\": \"gioppooo\",\n    \"options\": [\n      \"posts\",\n      \"retweets\"\n    ],\n    \"notification\": \"discord\",\n    \"webhook\": \"https://discord.com/api/webhooks/...\",\n    \"start\": true\n  },\n  {\n    \"user\": \"another_user\",\n    \"options\": [\n      \"posts\"\n    ],\n    \"notification\": \"websocket\",\n    \"start\": false\n  },\n  {\n    \"module\": \"twitter_keyword\",\n    \"keyword\": \"bitcoin\",\n    \"notification\": \"websocket\",\n    \"start\": true\n  }\n]")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://monitor-api.tweet-catcher.com/pro/bulk-add-tasks")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("[\n  {\n    \"user\": \"gioppooo\",\n    \"options\": [\n      \"posts\",\n      \"retweets\"\n    ],\n    \"notification\": \"discord\",\n    \"webhook\": \"https://discord.com/api/webhooks/...\",\n    \"start\": true\n  },\n  {\n    \"user\": \"another_user\",\n    \"options\": [\n      \"posts\"\n    ],\n    \"notification\": \"websocket\",\n    \"start\": false\n  },\n  {\n    \"module\": \"twitter_keyword\",\n    \"keyword\": \"bitcoin\",\n    \"notification\": \"websocket\",\n    \"start\": true\n  }\n]")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://monitor-api.tweet-catcher.com/pro/bulk-add-tasks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "[\n  {\n    \"user\": \"gioppooo\",\n    \"options\": [\n      \"posts\",\n      \"retweets\"\n    ],\n    \"notification\": \"discord\",\n    \"webhook\": \"https://discord.com/api/webhooks/...\",\n    \"start\": true\n  },\n  {\n    \"user\": \"another_user\",\n    \"options\": [\n      \"posts\"\n    ],\n    \"notification\": \"websocket\",\n    \"start\": false\n  },\n  {\n    \"module\": \"twitter_keyword\",\n    \"keyword\": \"bitcoin\",\n    \"notification\": \"websocket\",\n    \"start\": true\n  }\n]"

response = http.request(request)
puts response.read_body

event: progress
data: {"index":0,"total":3,"result":{"error":false}}

event: done
data: {"total":3}

{
  "error": true,
  "message": "Invalid request parameters"
}

{
  "error": true,
  "message": "Invalid or missing authorization token"
}

Authorizations

Authorization

string

header

required

Api key for application authentication

Body

application/json

Required array length: 1 - 200 elements

module

enum<string>

default:twitter

Platform module to monitor

Available options:

twitter,

truth_social,

twitter_keyword

Example:

"twitter"

user

string

Username to monitor (not applicable for keyword tasks)

Example:

"Gioppooo"

keyword

string

Keyword to monitor (used by twitter_keyword module)

Example:

"bitcoin"

group

string

Task group for organization

Example:

"influencers"

options

enum<string>[]

Monitoring options

Monitoring option

Available options:

posts,

retweets,

replies,

deletion,

following,

unfollow,

userUpdates,

ocr,

subscriptions,

private

Example:

["ocr", "posts", "retweets", "replies"]

notification

enum<string>

default:discord

Notification method

Available options:

discord,

telegram,

webhook,

websocket

Example:

"discord"

differentWebhooks

boolean

default:false

Whether to use different webhooks/chat IDs per monitoring option

Example:

false

webhook

string

Discord webhook URL or custom webhook URL

Example:

"https://discord.com/api/webhooks/..."

webhook-posts

string

Webhook for posts (if differentWebhooks is true)

webhook-following

string

Webhook for following updates (if differentWebhooks is true)

webhook-unfollow

string

Webhook for unfollow updates (if differentWebhooks is true)

webhook-userUpdates

string

Webhook for user updates (if differentWebhooks is true)

webhook-deletion

string

Webhook for deletion updates (if differentWebhooks is true)

chatId

string

Telegram chat ID

Example:

"123456789"

chatId-posts

string

Telegram chat ID for posts (if differentWebhooks is true)

chatId-following

string

Telegram chat ID for following updates (if differentWebhooks is true)

chatId-unfollow

string

Telegram chat ID for unfollow updates (if differentWebhooks is true)

chatId-userUpdates

string

Telegram chat ID for user updates (if differentWebhooks is true)

chatId-deletion

string

Telegram chat ID for deletion updates (if differentWebhooks is true)

pingKeywords

object

Keywords or regex configuration used for selective pinging

Show child attributes

Example:

{
  "n": ["test"],
  "p": ["alpha"],
  "isRegex": false
}

useRegex

boolean

default:false

Whether to use regex for ping keywords

Example:

false

ping

enum<string>

default:none

Discord ping option

Available options:

everyone,

here,

role,

none

Example:

"everyone"

roleId

string

Discord role ID to ping (required if ping is role)

Example:

"123456789012345678"

note

string

Task note shown in notifications

Example:

"high priority profile"

quickLink

string

Custom quick link included in notifications

Example:

"https://x.com/Gioppooo"

ignoreImages

boolean

default:false

Whether to ignore images in notifications

Example:

false

ignoreVideos

boolean

default:false

Whether to ignore videos in notifications

Example:

false

followingFilters

object

Filters for following notifications (typically used with Discord and Telegram notifications)

Show child attributes

userUpdatesOptions

object

Options for user update notifications (typically used with Discord and Telegram notifications)

Show child attributes

start

boolean

Whether to automatically start the task after creation

Example:

true

Response

SSE stream — tasks are processed sequentially; each result is emitted as a progress event

A Server-Sent Events (SSE) stream (Content-Type: text/event-stream).

The connection stays open while tasks are processed. Three named event types are sent:

Event	When	Data shape
`progress`	After each task is processed	`{ index, total, result }`
`done`	All tasks finished successfully	`{ total }`
`error`	Fatal error aborts the operation	`{ error: true, message }`

Example stream:

event: progress
data: {"index":0,"total":3,"result":{"error":false,"id":932}}

event: progress
data: {"index":1,"total":3,"result":{"error":true,"message":"Task limit reached"}}

event: done
data: {"total":3}

Example:

"event: progress\ndata: {\"index\":0,\"total\":3,\"result\":{\"error\":false}}\n\nevent: done\ndata: {\"total\":3}\n\n"

Getting started

Monitor

Pro

Legal

Bulk Add Tasks

Authorizations

Body

Response