Skip to main content
GET
/
api
/
v1
/
sync-history
Sync History
curl --request GET \
  --url https://www.catchthegoodones.com/api/v1/sync-history
{
  "runs": [
    {
      "id": 42,
      "trackedXAccountId": 1,
      "xHandle": "youraccount",
      "source": "manual",
      "status": "completed",
      "triggeredAt": "2026-04-17T12:00:00.000Z",
      "completedAt": "2026-04-17T12:05:00.000Z",
      "newFollowersCount": 150,
      "existingFollowersCount": 65,
      "likersCount": 30,
      "candidatesPassedCount": 12,
      "tierFilteredCount": 5,
      "genderFilteredCount": 3,
      "enrichedCount": 10,
      "filteredOutCount": 8,
      "errorMessage": null,
      "searchLabel": "Tech founders",
      "progressLog": ["Fetching new followers...", "Classification complete"]
    }
  ]
}
Returns the history of all sync runs for the authenticated user, sorted newest first.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer ctgo_your_api_key_here

​
Example

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

​
Response

{
  "runs": [
    {
      "id": 42,
      "trackedXAccountId": 1,
      "xHandle": "youraccount",
      "source": "manual",
      "status": "completed",
      "triggeredAt": "2026-04-17T12:00:00.000Z",
      "completedAt": "2026-04-17T12:05:00.000Z",
      "newFollowersCount": 150,
      "existingFollowersCount": 65,
      "likersCount": 30,
      "candidatesPassedCount": 12,
      "tierFilteredCount": 5,
      "genderFilteredCount": 3,
      "enrichedCount": 10,
      "filteredOutCount": 8,
      "errorMessage": null,
      "searchLabel": "Tech founders",
      "progressLog": ["Fetching new followers...", "Classification complete"]
    }
  ]
}

​
Response fields

FieldTypeDescription
idintegerSync run ID
trackedXAccountIdintegerThe tracked account that was synced
xHandlestringX handle of the tracked account
sourcestring"manual" or "cron" (scheduled)
statusstring"queued", "running", "completed", or "failed"
triggeredAtstringISO 8601 timestamp of when the sync was triggered
completedAtstring or nullISO 8601 completion timestamp
newFollowersCountintegerNew followers discovered
existingFollowersCountintegerExisting followers re-crawled plus backfilled
likersCountintegerFast post likers discovered
candidatesPassedCountintegerCandidates that passed all filters
tierFilteredCountintegerCandidates filtered out by tier
genderFilteredCountintegerCandidates filtered out by gender
enrichedCountintegerProfiles enriched with detailed data
filteredOutCountintegerProfiles filtered out during enrichment
errorMessagestring or nullError message if the sync failed
searchLabelstring or nullName of the saved search used
progressLogarrayOrdered list of progress messages