Skip to main content
GET
/
api
/
v1
/
people-of-interest
Get People of Interest
curl --request GET \
  --url https://www.catchthegoodones.com/api/v1/people-of-interest
{
  "data": [
    {
      "id": 42,
      "platform": "x",
      "profilePlatformUserId": "1234567890",
      "sourceType": "new_follower",
      "sourcePostId": null,
      "discoveredAt": "2026-03-10T14:30:00.000Z",
      "lastSeenAt": "2026-03-12T09:15:00.000Z",
      "trackedAccount": {
        "id": 1,
        "handle": "youraccount"
      },
      "profile": {
        "displayName": "Jane Smith",
        "handle": "janesmith",
        "bio": "Product designer at Acme Corp. Previously at Stripe.",
        "profileImageUrl": "https://pbs.twimg.com/profile_images/example.jpg",
        "followerCount": 12500,
        "followingCount": 890,
        "tweetCount": 4200,
        "isVerified": false,
        "accountCreatedAt": "2019-06-15T00:00:00.000Z",
        "profileFetchedAt": "2026-03-12T09:15:00.000Z"
      },
      "classification": {
        "gender": "female",
        "followerCountTier": "micro",
        "classifiedLabels": {
          "job_role": ["Product Designer"],
          "job_industry": ["Design"],
          "personality": ["Creative", "Detail-oriented"]
        }
      },
      "feedback": "good"
    }
  ]
}

​
Request

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer ctgo_your_api_key_here

​
Query parameters

ParameterRequiredDescription
sinceNoISO 8601 timestamp. Only return people discovered after this time. Useful for polling for new results. Example: 2026-03-24T00:00:00Z

​
Example

# Get all people of interest
curl https://www.catchthegoodones.com/api/v1/people-of-interest \
  -H "Authorization: Bearer ctgo_your_api_key_here"

# Get only people discovered since a specific time
curl "https://www.catchthegoodones.com/api/v1/people-of-interest?since=2026-03-24T00:00:00Z" \
  -H "Authorization: Bearer ctgo_your_api_key_here"

​
Response

Returns a data array containing all discovered people of interest, sorted newest first. 
{
  "data": [
    {
      "id": 42,
      "platform": "x",
      "profilePlatformUserId": "1234567890",
      "sourceType": "new_follower",
      "sourcePostId": null,
      "discoveredAt": "2026-03-10T14:30:00.000Z",
      "lastSeenAt": "2026-03-12T09:15:00.000Z",
      "trackedAccount": {
        "id": 1,
        "handle": "youraccount"
      },
      "profile": {
        "displayName": "Jane Smith",
        "handle": "janesmith",
        "bio": "Product designer at Acme Corp. Previously at Stripe.",
        "profileImageUrl": "https://pbs.twimg.com/profile_images/example.jpg",
        "followerCount": 12500,
        "followingCount": 890,
        "tweetCount": 4200,
        "isVerified": false,
        "accountCreatedAt": "2019-06-15T00:00:00.000Z",
        "profileFetchedAt": "2026-03-12T09:15:00.000Z"
      },
      "classification": {
        "gender": "female",
        "followerCountTier": "micro",
        "classifiedLabels": {
          "job_role": ["Product Designer"],
          "job_industry": ["Design"],
          "personality": ["Creative", "Detail-oriented"]
        }
      },
      "feedback": "good"
    }
  ]
}

​
Response fields

FieldTypeDescription
idintegerUnique identifier for this person of interest
platformstringSocial platform (currently "x")
profilePlatformUserIdstringThe person’s user ID on the platform
sourceTypestringHow they were discovered: "new_follower" or "fast_post_liker"
sourcePostIdstring or nullPost ID if discovered via a liked post
discoveredAtstringISO 8601 timestamp of first discovery
lastSeenAtstringISO 8601 timestamp of most recent observation
trackedAccountobjectThe tracked account they engaged with
trackedAccount.idintegerTracked account ID
trackedAccount.handlestringTracked account handle
profileobjectProfile information from the platform
profile.displayNamestringDisplay name
profile.handlestringUsername/handle
profile.biostringBio/description
profile.profileImageUrlstringProfile image URL
profile.followerCountintegerNumber of followers
profile.followingCountintegerNumber following
profile.tweetCountintegerNumber of posts
profile.isVerifiedbooleanVerification status
profile.accountCreatedAtstringISO 8601 account creation date
profile.profileFetchedAtstringISO 8601 when profile was last fetched
classificationobjectAI-generated classification data
classification.genderstring or nullInferred gender
classification.followerCountTierstring or nullFollower count bracket (e.g. "nano", "micro", "macro")
classification.classifiedLabelsobjectKey-value pairs of category to label arrays (e.g. {"job_role": ["CEO"], "job_industry": ["Technology"]})
feedbackstring or null"good", "bad", or null (not yet rated)