Skip to main content
POST
/
api
/
v1
/
feedback
Submit Feedback
curl --request POST \
  --url https://www.catchthegoodones.com/api/v1/feedback
{
  "success": true
}
Mark a person of interest as a Good One or Bad One. This trains the system to better understand your preferences and affects how candidates are displayed on your dashboard.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer ctgo_your_api_key_here
Content-TypeYesapplication/json

​
Body

FieldTypeRequiredDescription
candidateIdintegerYesThe ID of the person of interest (from the id field in the people-of-interest response)
savedSearchIdintegerYesThe ID of the saved search this feedback applies to
feedbackstringYes"good" or "bad"
badReasonstringNoReason for bad feedback. One of: "bot", "wrong_gender", "wrong_job", "wrong_skill", "wrong_personality", "zapier", "other". Defaults to "zapier" for bad feedback.
badReasonFreeformstringNoOptional freeform text explaining the bad feedback (max 500 characters)

​
Example

# Mark as Good One
curl -X POST https://www.catchthegoodones.com/api/v1/feedback \
  -H "Authorization: Bearer ctgo_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"candidateId": 42, "savedSearchId": 1, "feedback": "good"}'

# Mark as Bad One
curl -X POST https://www.catchthegoodones.com/api/v1/feedback \
  -H "Authorization: Bearer ctgo_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"candidateId": 42, "savedSearchId": 1, "feedback": "bad", "badReason": "wrong_job"}'

​
Response

{
  "success": true
}

​
Notes

  • Feedback is per saved search. The same person can have different ratings under different searches.
  • Submitting feedback for a candidate that already has feedback will update (upsert) the existing rating.
  • Good Ones are promoted to a dedicated section on your dashboard. Bad Ones are hidden.