SERPWatcher
Rank tracking API — create and manage trackings, monitor keyword positions, generate reports, and organize with tags.
SERPWatcher is Mangools' rank tracking tool. The API lets you automate everything the SERPWatcher app does: create rank trackings for domains, add tracked keywords, pull position data and share-of-voice stats, schedule reports, and annotate ranking movements.
What you can do
- Manage trackings — create, update, and delete rank trackings for any domain and location.
- Fetch ranking stats — pull share-of-voice, average position, and keyword-level position history.
- Track keywords — add or remove keywords from any tracking programmatically.
- Automate reports — schedule and retrieve PDF ranking reports.
- Annotate changes — create annotations to mark events that influenced rankings.
- Organize with tags — create tags and assign them to trackings for structured workflows.
- Bulk operations — create multiple trackings in a single request.
Authentication
SERPWatcher endpoints require an API key passed as the x-access-token header. The shared location lookups are the exception — they are public. See Authentication for setup instructions.
Endpoints
| Method | Endpoint | Path | Quota |
|---|---|---|---|
GET | Get all trackings | /serpwatcher/trackings | Free |
POST | Create tracking | /serpwatcher/trackings | Free |
GET | Get detail of tracking (legacy) | /serpwatcher/trackings/{tracking_id} | Free |
PATCH | Ability to change tracking domain, location | /serpwatcher/trackings/{tracking_id} | Free |
DELETE | Remove tracking | /serpwatcher/trackings/{tracking_id} | Free |
GET | Get tracking detail and its keywords | /serpwatcher/trackings/{tracking_id}/detail | Free |
POST | Get detail of tracking | /serpwatcher/trackings/{tracking_id}/stats | Free |
POST | Create trackings | /serpwatcher/multiple-trackings | Free |
GET | Get all tracked keywords | /serpwatcher/trackings/{tracking_id}/tracked-keywords | Free |
POST | Track another keyword | /serpwatcher/trackings/{tracking_id}/tracked-keywords | Free |
DELETE | Remove keyword from tracking | /serpwatcher/trackings/{tracking_id}/tracked-keywords | Free |
GET | Get tracked keywords in tracking list | /serpwatcher/trackings/{tracking_id}/tracked-keywords/{tracked_keyword_id} | Free |
GET | Get all reports | /serpwatcher/trackings/{tracking_id}/reports | Free |
POST | Create new report | /serpwatcher/trackings/{tracking_id}/reports | Free |
DELETE | Remove report | /serpwatcher/trackings/{tracking_id}/reports/{report_id} | Free |
PUT | Update report | /serpwatcher/trackings/{tracking_id}/reports/{report_id} | Free |
POST | Creates new annotation | /serpwatcher/trackings/{tracking_id}/annotations | Free |
DELETE | Remove annotation | /serpwatcher/trackings/{tracking_id}/annotations/{annotation_id} | Free |
PUT | Change annotation text | /serpwatcher/trackings/{tracking_id}/annotations/{annotation_id} | Free |
GET | Get all tags | /serpwatcher/tags | Free |
GET | Get all tags for tracking | /serpwatcher/trackings/{tracking_id}/tags | Free |
POST | Create new tag for tracking | /serpwatcher/trackings/{tracking_id}/tags | Free |
DELETE | Delete tag | /serpwatcher/trackings/{tracking_id}/tags/{tag_id} | Free |
PUT | Updates tag | /serpwatcher/trackings/{tracking_id}/tags/{tag_id} | Free |
POST | Assign tracking with tag | /serpwatcher/trackings/{tracking_id}/tags/assign | Free |
POST | Unassign tag from tracking | /serpwatcher/trackings/{tracking_id}/tags/unassign | Free |
GET | Get list of all locations | /mangools/locations | Free |
GET | Get detail of location | /mangools/locations/{location} | Free |
Endpoints marked Paid consume your lookup quota on every successful call. Free endpoints do not.