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": []
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.utrack.club/llms.txt

Use this file to discover all available pages before exploring further.

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