API Reference

VisitorFilters provides a RESTful API for programmatic access to your account, sites, rules, and visitor data. All API requests require authentication via API tokens.

Authentication

Include your API token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Generate API tokens from Settings → API Tokens in your dashboard.

Base URL

https://visitorfilters.com/api/v1

Endpoints

Sites

Method	Endpoint	Description
`GET`	`/sites`	List all sites
`GET`	`/sites/{id}`	Get site details
`POST`	`/sites`	Create a new site
`PUT`	`/sites/{id}`	Update site settings

Rules

Method	Endpoint	Description
`GET`	`/sites/{id}/rules`	List rules for a site
`POST`	`/sites/{id}/rules`	Create a rule
`PUT`	`/rules/{id}`	Update a rule
`DELETE`	`/rules/{id}`	Delete a rule

Visitors & Events

Method	Endpoint	Description
`GET`	`/sites/{id}/visitors`	List visitors (paginated)
`GET`	`/sites/{id}/events`	List recent events
`GET`	`/visitors/{id}`	Visitor detail with risk score

Bans

Method	Endpoint	Description
`GET`	`/sites/{id}/bans`	List active bans
`POST`	`/sites/{id}/bans`	Create a ban
`DELETE`	`/bans/{id}`	Remove a ban

Rate Limits

API requests are rate-limited per token:

Standard plans: 60 requests/minute
Pro plans: 120 requests/minute
Enterprise: Custom limits

Rate limit headers are included in every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1716400000

Error Responses

All errors return a consistent JSON structure:

{
  "message": "The given data was invalid.",
  "errors": {
    "field": ["Error description"]
  }
}