Skip to main content
GET
/
api
/
v1
/
tracked-accounts
List Tracked Accounts
curl --request GET \
  --url https://www.catchthegoodones.com/api/v1/tracked-accounts
{
  "accounts": [
    {
      "id": 1,
      "xHandle": "youraccount",
      "xUserId": "1234567890",
      "tier": "pro",
      "isActive": true,
      "profileImageUrl": "https://pbs.twimg.com/profile_images/example.jpg",
      "lastKnownFollowerCount": 12500,
      "savedSearchId": 3,
      "addedAt": "2026-03-01T00:00:00.000Z"
    }
  ],
  "sleepingAccounts": [],
  "subscriptionQuantities": {
    "starter": 0,
    "growth": 0,
    "pro": 1
  },
  "discount": null,
  "renewalDate": "2026-05-01T00:00:00.000Z"
}
Returns all active and sleeping tracked X accounts, plus your current subscription summary.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer ctgo_your_api_key_here

​
Example

curl https://www.catchthegoodones.com/api/v1/tracked-accounts \
  -H "Authorization: Bearer ctgo_your_api_key_here"

​
Response

{
  "accounts": [
    {
      "id": 1,
      "xHandle": "youraccount",
      "xUserId": "1234567890",
      "tier": "pro",
      "isActive": true,
      "profileImageUrl": "https://pbs.twimg.com/profile_images/example.jpg",
      "lastKnownFollowerCount": 12500,
      "savedSearchId": 3,
      "addedAt": "2026-03-01T00:00:00.000Z"
    }
  ],
  "sleepingAccounts": [],
  "subscriptionQuantities": {
    "starter": 0,
    "growth": 0,
    "pro": 1
  },
  "discount": null,
  "renewalDate": "2026-05-01T00:00:00.000Z"
}

​
Response fields

FieldTypeDescription
accountsarrayActive tracked accounts
sleepingAccountsarrayAccounts that have been put to sleep (paused)
subscriptionQuantitiesobject or nullCurrent Stripe subscription quantities per tier
discountobject or nullActive coupon/discount on the subscription
renewalDatestring or nullISO 8601 date of the next subscription renewal