Skip to main content
POST
/
api
/
key
/
watched
Add tracked accounts
curl --request POST \
  --url 'https://www.utrack.club/api/key/watched?key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifier": "elonmusk,@twitter,44196397",
  "type": "username",
  "key": "your-api-key-here"
}
'
{
  "success": true,
  "message": "Processed 3 identifiers: 2 successful, 1 skipped, 0 failed",
  "results": {
    "successful": [
      {
        "identifier": "elonmusk",
        "trackedAccount": {
          "twitterUsername": "elonmusk",
          "twitterId": "44196397",
          "createdAt": "2024-01-15T10:30:00Z"
        }
      }
    ],
    "skipped": [
      {
        "identifier": "@twitter",
        "twitterUsername": "twitter",
        "reason": "Account @twitter is already being tracked"
      }
    ],
    "failed": []
  }
}

Authorizations

key
string
query
required

Your API key. Get your API key from the dashboard.

Body

application/json
identifier
string
required

Comma-separated list of Twitter usernames (with or without @) or Twitter IDs. Maximum 1000 characters.

Example:

"elonmusk,44196397,@twitter"

type
enum<string>
required

Specify whether the identifier is a username or ID

Available options:
username,
id
key
string
required

Your API key

Response

Successfully added at least one account

success
boolean
required

True if at least one account was successfully added

message
string
required

Summary message

results
object
required