Rank Tracker
Read ranking visibility and stored results, then manage tracked keywords and URL-based segments with the Screpy REST API.
Keep ranking work project-scoped
Start with the project overview.
Filter keywords by device, search text, or segment. Numeric keyword, analysis, and segment IDs are scoped to the project UID in the request path. Use the Rank Tracker guide to interpret movement before changing a page.
Adding keywords consumes the project's Rank Tracker allowance and starts the normal first-analysis workflow. Scheduled analyses continue at the configured frequency. The REST API reads stored results and manages keywords or segments; it does not provide export, live search, or manual reanalysis endpoints.
Endpoints
Choose the endpoint that matches the smallest unit of data or action your integration needs. Each endpoint page documents one request so the reference remains fast and focused.
Get Rank Tracker input options
Returns public country, language, device, frequency, and segment rule options. Internal provider identifiers are omitted.
Get the Rank Tracker overview
Returns summary metrics, a 30-day visibility series, position distribution, plan usage, and update frequency.
List Rank Tracker keywords
Returns a lightweight cursor-paginated list. Use the analysis endpoints for history and stored organic results.
Add Rank Tracker keywords
Adds at most 100 unique keywords. `both` creates two tracked records per keyword and consumes two units. Initial analysis is scheduled automatically; manual reanalysis is not available.
Delete Rank Tracker keywords
Deletes up to 100 project-scoped keyword IDs. Set `delete_all_devices` to remove matching mobile and desktop variants.
Get a Rank Tracker keyword
Get a Rank Tracker keyword
Delete a Rank Tracker keyword
Delete a Rank Tracker keyword
List all saved analyses for a keyword
List all saved analyses for a keyword
Get saved organic results for an analysis
Returns stored organic rows and explicit scan coverage. This does not run a live search.
List segments, suggestions, and unmatched count
List segments, suggestions, and unmatched count
Create a segment
Create a segment
Preview segment rules without saving
Preview segment rules without saving
Update a segment
Update a segment
Delete a segment
Delete a segment