Skip to main content
POST
/
api
/
v1
/
saved-searches
Create Saved Search
curl --request POST \
  --url https://www.catchthegoodones.com/api/v1/saved-searches
{
  "savedSearch": {
    "id": 1,
    "userFacingId": "S-1",
    "name": "Tech founders",
    "description": "Looking for startup founders in tech",
    "genderValues": ["male", "female"],
    "followerCountTiers": null,
    "appliedSearchFilters": {
      "job_role": ["Founder", "CEO", "CTO"],
      "job_industry": ["Technology", "SaaS"]
    },
    "createdAt": "2026-04-17T12:00:00.000Z",
    "updatedAt": "2026-04-17T12:00:00.000Z"
  }
}
Creates a new saved search with optional filter values.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer ctgo_your_api_key_here
Content-TypeYesapplication/json

​
Body

All fields are optional. Omit a field or pass null to leave it unset.
FieldTypeRequiredDescription
namestringNoDisplay name (max 100 characters)
descriptionstringNoDescription (max 500 characters)
genderValuesarray of stringsNoGender filter values (max 10 items)
followerCountTiersarray of stringsNoFollower count tier filter values (max 20 items)
appliedSearchFiltersobjectNoCustom AI filter categories, as { "category": ["label1", "label2"] }

​
Example

curl -X POST https://www.catchthegoodones.com/api/v1/saved-searches \
  -H "Authorization: Bearer ctgo_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech founders",
    "description": "Looking for startup founders in tech",
    "genderValues": ["male", "female"],
    "appliedSearchFilters": {
      "job_role": ["Founder", "CEO", "CTO"],
      "job_industry": ["Technology", "SaaS"]
    }
  }'

​
Response

{
  "savedSearch": {
    "id": 1,
    "userFacingId": "S-1",
    "name": "Tech founders",
    "description": "Looking for startup founders in tech",
    "genderValues": ["male", "female"],
    "followerCountTiers": null,
    "appliedSearchFilters": {
      "job_role": ["Founder", "CEO", "CTO"],
      "job_industry": ["Technology", "SaaS"]
    },
    "createdAt": "2026-04-17T12:00:00.000Z",
    "updatedAt": "2026-04-17T12:00:00.000Z"
  }
}