Apply a title or description to any page

curl -X POST \
  -H "Authorization: Bearer mr_ws_…" \
  -H "Content-Type: application/json" \
  -d '{"field":"seo_title","keyword":"trail bikes","changes":[{"url":"https://acmebikes.com/","value":"Trail Bikes Built for Real Trails | Acme Bikes"}]}' \
  "https://app.monoranks.com/api/v1/sites/SITE_ID/pages/apply"

const res = await fetch("https://app.monoranks.com/api/v1/sites/SITE_ID/pages/apply", {
  method: "POST",
  headers: { Authorization: "Bearer mr_ws_…", "Content-Type": "application/json" },
  body: JSON.stringify({
    "field": "seo_title",
    "keyword": "trail bikes",
    "changes": [
      {
        "url": "https://acmebikes.com/",
        "value": "Trail Bikes Built for Real Trails | Acme Bikes"
      }
    ]
  }),
});
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/pages/apply",
    headers={"Authorization": "Bearer mr_ws_…"},
    json={
        "field": "seo_title",
        "keyword": "trail bikes",
        "changes": [
            {
                "url": "https://acmebikes.com/",
                "value": "Trail Bikes Built for Real Trails | Acme Bikes",
            },
        ],
    },
)
res.raise_for_status()
data = res.json()

<?php
$ch = curl_init("https://app.monoranks.com/api/v1/sites/SITE_ID/pages/apply");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => ["Authorization: Bearer mr_ws_…", "Content-Type: application/json"],
    CURLOPT_POSTFIELDS => '{"field":"seo_title","keyword":"trail bikes","changes":[{"url":"https://acmebikes.com/","value":"Trail Bikes Built for Real Trails | Acme Bikes"}]}',
    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/pages/apply",
  {
    "field": "seo_title",
    "keyword": "trail bikes",
    "changes": [
      {
        "url": "https://acmebikes.com/",
        "value": "Trail Bikes Built for Real Trails | Acme Bikes"
      }
    ]
  },
  { headers: { Authorization: "Bearer mr_ws_…" } },
);

{
  "approved": 1,
  "batchId": "f6b8d0f2-4a6c-4e8a-ac2e-6a8cae2a4c6d",
  "field": "seo_title",
  "keyword": "trail bikes",
  "note": "Written by the worker, then rechecked. A value the recheck does not find on the live page gets status not_live. Undo is available in the app (Activity) for 30 days.",
  "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/activity"
}

{
  "error": {
    "code": "field_not_supported",
    "message": "field must be seo_title or seo_description."
  }
}

{
  "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": "not_connected",
    "message": "Connect WordPress first."
  }
}

{
  "error": {
    "code": "not_writable",
    "message": "https://acmebikes.com/category/gravel/ is a category or tag archive. Update the MonoRanks plugin in WordPress so MonoRanks can write its title and description."
  }
}

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