August 25, 2026

Read a Blacklist and Its Entries From the API

Read a Blacklist and Its Entries From the API screenshot

We have added two new API endpoints that make blacklists easier to work with.

Previously, the API could create a blacklist, add profiles, remove profiles, and list all your blacklists, but there was no direct way to open one blacklist or see the profiles inside it.

The only workaround was to read it through the regular lists endpoints.

What is new

Two new endpoints are now available:

  • Get blacklist returns a single blacklist by ID, including its profile count
  • List blacklist entries returns the excluded profiles inside that blacklist, page by page

These endpoints keep regular lists and blacklists clearly separated.

If you use the ID of a regular list, the blacklist endpoint will reject it.

If the blacklist does not exist, or does not belong to your account, Botdog now returns not found instead of an empty result.

Nothing changes for anything you already use.

If you were reading blacklists through the regular lists endpoints as a workaround, that will continue to work exactly as before.

Ready to Make the Jump?

Join thousands of professionals who are growing their network on autopilot. Start your journey today with our 7-day free trial.

Start your campaign now

Trusted by 5,000+ sales professionals worldwide

4.9/5 rating

All features free for 7 days

Signup takes 2 minutesNo credit card required