Ignore a keyword, or undo it · REST API

Ignore a keyword, or undo it Hides the keyword from Keywords, Keyword gaps, content ideas and the opportunity counts. Kept by the keyword text, so it stays hidden after keyword and gap refreshes, and a gap keyword not in the list can be ignored too. on false undoes it. The same call twice changes nothing (changed false). Ignoring stops daily checks of the keyword. Recorded in the website's Activity as the key owner.

Las descripciones vienen del documento OpenAPI y están en inglés.

Parámetros

Nombre	Dónde	Detalles
`siteId`Obligatorio	ruta	stringWebsite id, from GET /sites.

Cuerpo de la petición

Campo	Detalles
`keyword`	string · at most 120 characters; The keyword text
`keyword_id`	string · Or the keyword id, from GET /keywords
`on`	true or false · Default true; false undoes it
`reason`	string · at most 300 characters; Why, kept with it (at most 300 characters)

{
  "keyword": "bike shop login",
  "reason": "A competitor brand"
}

Respuesta

200 · application/json

Campo	Detalles
`keyword`	string · required; The keyword text, normalised
`ignored`	true or false · required; Hidden now
`changed`	true or false · required; False when it already was in that state
`untracked`	true or false · required; True when ignoring stopped its daily checks
`link`	address (URL) · required; The Keywords screen in the app

Errores

Estado	Significado
`400`	Bad request. Codes: `missing_keyword`, `bad_keyword`, `bad_on`, `bad_reason`, `reason_too_long`.
`401`	Missing, unknown or revoked key. Codes: `missing_key`, `invalid_key`.
`403`	The key lacks the scope, covers another website, or its owner lost access. Codes: `missing_scope`, `other_site`, `owner_left`, `no_owner`, forbidden.
`404`	Not found. Codes: `not_found`, `keyword_not_found`.
`429`	Too many requests this hour for this key. Codes: `rate_limited`.

Petición de ejemplo

curl -X POST \
  -H "Authorization: Bearer mr_ws_…" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"bike shop login","reason":"A competitor brand"}' \
  "https://app.monoranks.com/api/v1/sites/SITE_ID/keywords/ignore"

const res = await fetch("https://app.monoranks.com/api/v1/sites/SITE_ID/keywords/ignore", {
  method: "POST",
  headers: { Authorization: "Bearer mr_ws_…", "Content-Type": "application/json" },
  body: JSON.stringify({
    "keyword": "bike shop login",
    "reason": "A competitor brand"
  }),
});
if (!res.ok) throw new Error((await res.json()).error.message);
const data = await res.json();

import requests

res = requests.post(
    "https://app.monoranks.com/api/v1/sites/SITE_ID/keywords/ignore",
    headers={"Authorization": "Bearer mr_ws_…"},
    json={
        "keyword": "bike shop login",
        "reason": "A competitor brand",
    },
)
res.raise_for_status()
data = res.json()

<?php
$ch = curl_init("https://app.monoranks.com/api/v1/sites/SITE_ID/keywords/ignore");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => ["Authorization: Bearer mr_ws_…", "Content-Type: application/json"],
    CURLOPT_POSTFIELDS => '{"keyword":"bike shop login","reason":"A competitor brand"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

import axios from "axios";

const { data } = await axios.post(
  "https://app.monoranks.com/api/v1/sites/SITE_ID/keywords/ignore",
  {
    "keyword": "bike shop login",
    "reason": "A competitor brand"
  },
  { headers: { Authorization: "Bearer mr_ws_…" } },
);

Respuesta de ejemplo

{
  "keyword": "bike shop login",
  "ignored": true,
  "changed": true,
  "untracked": false,
  "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/keywords"
}

{
  "error": {
    "code": "missing_keyword",
    "message": "Send keyword (the text) or keyword_id (from GET /keywords)."
  }
}

{
  "error": {
    "code": "missing_key",
    "message": "Send the key as Authorization: Bearer mr_site_…"
  }
}

{
  "error": {
    "code": "missing_scope",
    "message": "This key does not have the scope this call needs."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Website not found."
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "More than 1200 requests this hour for this key."
  }
}

El servidor MCP hace lo mismo con la herramienta ignore_keyword.