---
title: Settings API 
description: "##### `GET`/settings Retrieve all plugin settings. **Response** ``` { \"data_retention_days\": 90, \"exclude_logged_in_users\": true, \"rate_limit_per_minute\": 60, \"enable_content_opt\": true, \"enable_conversions\": true, \"email_reports_enabled\": true, \"email_reports_frequency\": \"weekly\" } ``` ##### `POST`/settings Update plugin settings. **Response** ``` { \"success\": true, \"message\": \"Settings updated successfully\", \"updated_settings\":…"
url: "https://pulserank.ai/docs/settings-api/"
updated: "2026-01-09"
category: API Documentation
---

# Settings API 

##### `GET`/settings

Retrieve all plugin settings.

**Response**

```
{
    "data_retention_days": 90,
    "exclude_logged_in_users": true,
    "rate_limit_per_minute": 60,
    "enable_content_opt": true,
    "enable_conversions": true,
    "email_reports_enabled": true,
    "email_reports_frequency": "weekly"
}
```

##### `POST`/settings

Update plugin settings.

**Response**

```
{
    "success": true,
    "message": "Settings updated successfully",
    "updated_settings": { ... }
}
```

##### `GET`/health

System health check and diagnostics.

**Response**

```
{
    "database_tables": [...],
    "environment": {
        "php_version": "8.2.0",
        "wp_version": "6.7.0",
        "memory_limit": "256M"
    },
    "cron_jobs": { ... },
    "cache_plugins": ["LiteSpeed Cache", "WP Rocket"],
    "woocommerce_active": true
}
```

##### `POST`/run-cleanup

Manually trigger data cleanup (deletes old records).

**Response**

```
{
    "deleted_records": 2345,
    "message": "Cleanup completed successfully"
}
```

##### `POST`/settings/reset

Reset all settings to defaults.

**Response**

```
{
    "success": true,
    "message": "Settings reset to defaults"
}
```

##### `GET`/pages

Get list of tracked pages with visit counts.

**Parameters**

`days`(integer)— Number of days. Default: 30

`limit`(integer)— Results to return. Default: 50

**Response**

```
{
    "total_pages": 234,
    "returned": 50,
    "pages": [
        { "url": "/blog/post-title", "post_id": 123, "visits": 234, "title": "..." }
    ]
}
```