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
All SERPWatcher endpoints require an API key passed as the x-access-token header. See Authentication for setup instructions.
Endpoints
| Method | Endpoint | Path |
|---|---|---|
GET | Get all trackings | /serpwatcher/trackings |
POST | Create tracking | /serpwatcher/trackings |
GET | Get detail of tracking (legacy) | /serpwatcher/trackings/{tracking_id} |
DELETE | Remove tracking | /serpwatcher/trackings/{tracking_id} |
PUT | Ability to change tracking domain, location | /serpwatcher/trackings/{tracking_id} |
GET | Get tracking detail and its keywords | /serpwatcher/trackings/{tracking_id}/detail |
POST | Get detail of tracking | /serpwatcher/trackings/{tracking_id}/stats |
POST | Create trackings | /serpwatcher/multiple-trackings |
GET | Get all tracked keywords | /serpwatcher/trackings/{tracking_id}/tracked-keywords |
POST | Track another keyword | /serpwatcher/trackings/{tracking_id}/tracked-keywords |
DELETE | Remove keyword from tracking | /serpwatcher/trackings/{tracking_id}/tracked-keywords |
GET | Get tracked keywords in tracking list | /serpwatcher/trackings/{tracking_id}/tracked-keywords/{tracked_keyword_id} |
GET | Get all reports | /serpwatcher/trackings/{tracking_id}/reports |
POST | Create new report | /serpwatcher/trackings/{tracking_id}/reports |
DELETE | Remove report | /serpwatcher/trackings/{tracking_id}/reports/{report_id} |
PUT | Update report | /serpwatcher/trackings/{tracking_id}/reports/{report_id} |
POST | Creates new annotation | /serpwatcher/trackings/{tracking_id}/annotations |
DELETE | Remove annotation | /serpwatcher/trackings/{tracking_id}/annotations/{annotation_id} |
PUT | Change annotation text | /serpwatcher/trackings/{tracking_id}/annotations/{annotation_id} |
GET | Get all tags | /serpwatcher/tags |
GET | Get all tags for tracking | /serpwatcher/trackings/{tracking_id}/tags |
POST | Create new tag for tracking | /serpwatcher/trackings/{tracking_id}/tags |
DELETE | Deletes tag from tracking | /serpwatcher/trackings/{tracking_id}/tags |
PUT | Updates tag | /serpwatcher/trackings/{tracking_id}/tags/{tag_id} |
POST | Assign tracking with tag | /serpwatcher/trackings/{tracking_id}/tags/assign |
POST | Unassign tag from tracking | /serpwatcher/trackings/{tracking_id}/tags/unassign |
GET | Get list of all locations | /mangools/locations |
GET | Get detail of location | /mangools/locations/{location} |