Skip to main content
POST
/
api
/
v1
/
explore
Trigger Explore
curl --request POST \
  --url https://www.catchthegoodones.com/api/v1/explore
{
  "runId": 42
}
Queues an explore run that classifies cached profiles for a tracked account using a specific saved search. Returns immediately with a runId that you can poll via the sync status endpoint. Explore lets you re-classify previously fetched profiles against a different saved search. This is useful for finding people who match a new set of criteria without triggering a full sync. Explore runs asynchronously and has a monthly budget per tracked account based on tier.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer ctgo_your_api_key_here
Content-TypeYesapplication/json

​
Body

FieldTypeRequiredDescription
savedSearchIdintegerYesThe saved search to classify against
trackedXAccountIdintegerYesThe tracked account whose cached profiles to explore
triggerSyncFirstbooleanNoIf true, triggers a discovery sync before running the explore. Default: false.

​
Example

curl -X POST https://www.catchthegoodones.com/api/v1/explore \
  -H "Authorization: Bearer ctgo_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"savedSearchId": 1, "trackedXAccountId": 1}'

​
Response

{
  "runId": 42
}

​
Notes

  • The explore runs asynchronously. Poll the sync status endpoint using the returned runId.
  • Each tracked account has a monthly explore budget based on its tier. The budget resets at the start of each billing period.
  • Free tier and trial users have a shared explore limit across all accounts.