Rule out the bots already in the feed
POST /api/v1/projects/{project}/bot-sweep
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
| Name | Type | Description |
|---|---|---|
project requiredpath |
string | The project's id. |
Request body
JSON, sent with Content-Type: application/json.
| Name | Type | Description |
|---|---|---|
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}'