Contents

API reference / Projects

Rule out the bots already in the feed

POST /api/v1/projects/{project}/bot-sweep

sweep_bots Write

Checks the project's open, kept posts for bot and spam accounts (a giveaway or follow-for-follow account, a crypto or income funnel, a numbered-handle account posting spam, the same post from several accounts) and rules them out, with the reason, under Ruled out. Company accounts that are only promoting themselves stay in the feed, marked as companies. Posts you have already acted on, and posts whose author is already classified, are left alone; a ruled-out post can be put back. dry_run: true counts and shows samples without changing anything.

A full-access key (ss_sk_…), or an editor or owner signed in.

Parameters

NameTypeDescription
project required
path
string The project's id.

Request body

JSON, sent with Content-Type: application/json.

NameTypeDescription
dry_run boolean Count and sample only.

Example

curl -X POST "https://sniffington.com/api/v1/projects/{project}/bot-sweep" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dry_run":true}'