Stop tracking keywords on a website, by ID or by text. This also deletes their stored ranking history.

POSThttps://api.rankparse.com/v1/rank-tracking/keywords/removeFreeAPI key (owner, admin, member or client with edit access)

Stops tracking keywords on one website. Name them by keyword_ids, by keywords text, or both.

Removing a keyword also deletes its stored ranking history on every search engine. That cannot be undone. Confirm which keywords to remove before calling it on someone else's behalf.

Query parameters

site_idstringrequired

The website, from List sites. A missing or unknown ID returns 404 rank_tracking_site_not_found.

Body parameters

keyword_idsarray of strings

Keyword IDs from List keywords.

keywordsarray of strings

Keyword text to remove, matched ignoring letter case and surrounding spaces.

Name at least one keyword. An empty request, a body that is not a JSON object, or a value that is not an array of strings returns 400 invalid_rank_tracking_keywords. At most 100 names per call.

Response

site_idstring

The website you changed.

removedarray

The keywords that were removed, as { keyword_id, keyword }.

not_foundarray of strings

Names that matched no tracked keyword on this website. Not an error, so a repeated call is safe.

tracked_totalinteger

How many keywords the website tracks now.

Behavior and limits

Credits: 0.
Idempotent: repeating a call removes nothing more and lists the names under not_found.
History: a removed keyword's daily metrics, device and country data and sync state are deleted with it.

Errors

HTTP	Code	When
400	`invalid_rank_tracking_keywords`	The body is not a JSON object, names nothing, has a value that is not an array of strings, or names more than 100.
401	`invalid_api_key`	Missing, invalid or revoked API key.
403	`capability_missing`	Your role may not edit tracked keywords.
404	`rank_tracking_site_not_found`	No website with that `site_id` in your workspace.
429	`rate_limited`	More than 60 requests per minute for this key.

MCP tool: remove_tracked_keywords (accepts site_id, keyword_ids and keywords; marked destructive).

List keywords

The keywords a website tracks, with their IDs.

Add keywords

Start tracking keywords.

curl -X POST "https://api.rankparse.com/v1/rank-tracking/keywords/remove?site_id=site_abc123" \
  -H "X-API-Key: rp_your_key" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["old phrase"]}'

Response

{
  "site_id": "site_abc123",
  "removed": [
    { "keyword_id": "5f1c0c1e-8a53-4f43-9b7e-3a0f1d2c9e11", "keyword": "old phrase" }
  ],
  "not_found": [],
  "tracked_total": 11,
  "note": "Removing a keyword also deletes its stored ranking history on every engine."
}

Remove keywords

Query parametersCopy Anchor Link

Body parametersCopy Anchor Link

ResponseCopy Anchor Link

Behavior and limitsCopy Anchor Link

ErrorsCopy Anchor Link

RelatedCopy Anchor Link

List keywords

Add keywords

Query parameters

Body parameters

Response

Behavior and limits

Errors

Related