Developer & API

PulseRank provides 32 REST API endpoints for integrating analytics data into custom dashboards, automations, and workflows.

Available Endpoints

32 REST endpoints organized by functionality.

13 Reports API

Traffic analytics, bot reports, referral tracking, conversions, channels, raw data export.

8 Settings API

Configuration management, health checks, cleanup operations, page listings

6 Content Optimization API

Run analysis, get summaries, issue breakdowns, batch processing

3 Diagnostic Tools

Bot detection testing, referral analysis, request inspection.

2 Email Reports API

Preview and send test emails.

Quick Start Examples

Get started quickly with our well-documented REST API.

Fetch Bot Analytics
fetch('https://yoursite.com/wp-json/pulserank/v1/reports/bots?days=7', {
  headers: {
    'Authorization': 'Basic ' + btoa('username:application_password')
  }
})
.then(response => response.json())
.then(data => {
  console.log('Bot Analytics:', data);
  // Response includes:
  // - bots[] (array of detected bots with visit counts)
  // - daily_trend[] (daily bot activity over period)
  // - hourly[] (24-hour activity pattern)
  // - top_pages[] (most visited pages by bots)
  // - status_codes[] (HTTP response codes)
  // - ai_bot_crawls (total AI bot visits)
  // - seo_bot_crawls (total SEO bot visits)
  // - total_crawls (combined total)
});
Fetch Traffic Overview
fetch('https://yoursite.com/wp-json/pulserank/v1/reports/overview?days=30', {
  headers: {
    'Authorization': 'Basic ' + btoa('username:application_password')
  }
})
.then(response => response.json())
.then(data => {
  console.log('Traffic Overview:', data);
  // Includes current vs previous period comparison
});

Frequently Asked Questions

We’ve anticipated your concerns and engineered solutions for each one.

The REST API uses WordPress’s standard authentication methods:

Nonce-based Authentication – Include X-WP-Nonce header with valid nonce value

Application Passwords (recommended) – Generate in WordPress admin: Users → Your Profile → Application Passwords. Use HTTP Basic Auth.

Cookie-based Authentication – Automatically handled when logged into WordPress admin

Most endpoints require manage_options capability (Administrator role). Editor metabox endpoint requires edit_posts capability.

The REST API endpoints themselves have no rate limiting. You can make unlimited API requests. However, PulseRank’s visitor tracking system has configurable rate limiting (default: 60 requests/min per IP) to prevent spam/abuse.

Stop Guessing. Start Measuring.

Join WordPress sites already using PulseRank to uncover their AI traffic and optimize for the future of search.