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('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('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.
