WordPress plugin and API
Show your Google rankings in your WordPress dashboard with the free PulseSERP plugin, or read them with the PulseSERP API: keys, addresses, limits and examples.
Your rankings can be read outside PulseSERP in two ways: the WordPress plugin, which shows a summary on your WordPress dashboard (every plan, Free included), and the API, for Google Sheets, Zapier or your own dashboard (paid plans). Both only read; nothing can be changed through them.
Show your rankings in WordPress
- In PulseSERP, open the website and click WordPress (or go to My account → API keys and choose the website). Click Make key and copy it.
- In WordPress, go to Plugins → Add New, search for PulseSERP, then install and activate PulseSERP: SEO & AI Visibility Tracker. (It's also on wordpress.org.) WordPress keeps it up to date like any other plugin.
- Open Settings → PulseSERP, paste the key and save.
The PulseSERP rankings box then appears on the WordPress dashboard for administrators: keywords in the top 3 and top 10, what moved this week, your best positions and, on plans with AI Watch, how often Google's AI cites you. It refreshes twice a day.
Agencies: make a key for each client's website and put it in that client's WordPress. A website key reads that one website only, so a client never sees your other clients, and if their website is ever hacked, only that key is exposed. Delete it and make a new one in a click.
Two kinds of key
- One website: reads that website only. For WordPress. Every plan; one key per website (making another replaces it).
- All websites: reads every website in your account. For your own tools only; never put it on a client's website. Paid plans: Starter 1, Pro 2, Agency 5.
Only the account owner can make keys. A key is shown once; we keep only a scrambled copy, so if you lose it, delete it and make a new one. My account shows when each key was last used.
The API
Send the key in a header: Authorization: Bearer pserp_… (or X-Api-Key: pserp_…). Answers are JSON.
curl -H "Authorization: Bearer YOUR_KEY" https://serp.pulseinf.com/api/v1/me
| Address | What it gives | Plans |
|---|---|---|
GET /me | The account, the key, and the websites it can read (with their ids) | All |
GET /websites/{id}/summary | Top 3 and top 10 counts, this week's moves, best positions, AI Watch summary | All |
GET /websites | Websites with their keyword counts | Paid |
GET /websites/{id}/keywords | Every keyword: position, day and week change, best, page, groups | Paid |
GET /websites/{id}/keywords/{keyword}/history?days=90 | Position by date (up to 400 days) | Paid |
GET /websites/{id}/ai-watch | Each watched keyword: AI answer or not, cited or not, which sites were cited | Paid |
All addresses start with https://serp.pulseinf.com/api/v1. Positions: 1 is first; null means not found in the results read (not_in_top says how many). change_7d is places moved in a week; positive is up. source is live (Google checks) or search_console (Google's average, on Free).
Google Sheets example
In a sheet, open Extensions → Apps Script, paste this, put your key and website id in, and run pulseserp. Add a daily trigger to keep it current.
function pulseserp() {
const key = 'YOUR_KEY', website = 'WEBSITE_ID';
const res = UrlFetchApp.fetch('https://serp.pulseinf.com/api/v1/websites/' + website + '/keywords',
{ headers: { Authorization: 'Bearer ' + key } });
const rows = JSON.parse(res.getContentText()).keywords
.map(k => [k.keyword, k.country, k.device, k.position, k.change_7d, k.url]);
const sheet = SpreadsheetApp.getActiveSheet();
sheet.clearContents().appendRow(['Keyword', 'Country', 'Device', 'Position', 'Week change', 'Page']);
if (rows.length) sheet.getRange(2, 1, rows.length, 6).setValues(rows);
}
Limits
A key can make 60 calls a minute, on every plan; past that you get 429 and a Retry-After header. There's no daily limit. Positions change at most once a day, so the same answer is given again for 15 minutes: calling more often doesn't get newer figures.
Errors come as {"error": {"code": …, "message": …}}: 401 invalid_key, 403 plan (that address needs a paid plan), 404 not_found, 429 too_many_requests.
Still stuck?
Tell us what you were trying to do and we'll reply by email.