Skip to main content

​
Managing Your API Key

Use an API key to access your people of interest data programmatically via the Catch The Good Ones API.

​
Generating a key

  1. In the sidebar, click API Key under General
  2. Click Generate API Key
  3. Your key will be displayed once in a copiable field
  4. Copy and store it securely - you will not be able to see it again
API keys have the prefix ctgo_ and are 45 characters long.

​
Using your key

Include your API key in the Authorization header of API requests: 
curl https://www.catchthegoodones.com/api/v1/people-of-interest \
  -H "Authorization: Bearer ctgo_your_api_key_here"
For full API documentation, visit the API Reference.

​
Regenerating a key

If your key is compromised or you need a new one:
  1. Go to the API Key page
  2. Click Regenerate
  3. Confirm in the dialog
  4. Your old key immediately stops working
  5. Copy and store the new key

​
Revoking a key

To disable API access entirely:
  1. Go to the API Key page
  2. Click Revoke
  3. Confirm in the dialog
  4. The key is permanently invalidated
After revoking, the page returns to the “no key” state. You can generate a new key at any time.

​
Rate limits

API requests are limited to 60 requests per minute per key. Rate limit status is returned in response headers (X-RateLimit-Limit, X-RateLimit-Remaining). If you exceed the limit, you will receive a 429 response with a Retry-After header indicating when you can retry.

​
Zapier integration

Catch The Good Ones has a native Zapier app. Search for “Catch The Good Ones” in Zapier to set up automated workflows triggered when new people of interest are discovered.