Compare a page title with the top 5 Google results

curl -X POST \
  -H "Authorization: Bearer mr_ws_…" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"what is aeo","language":"en"}' \
  "https://app.monoranks.com/api/v1/sites/SITE_ID/pages/PAGE_ID/title-compare"

const res = await fetch("https://app.monoranks.com/api/v1/sites/SITE_ID/pages/PAGE_ID/title-compare", {
  method: "POST",
  headers: { Authorization: "Bearer mr_ws_…", "Content-Type": "application/json" },
  body: JSON.stringify({
    "keyword": "what is aeo",
    "language": "en"
  }),
});
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/PAGE_ID/title-compare",
    headers={"Authorization": "Bearer mr_ws_…"},
    json={
        "keyword": "what is aeo",
        "language": "en",
    },
)
res.raise_for_status()
data = res.json()

<?php
$ch = curl_init("https://app.monoranks.com/api/v1/sites/SITE_ID/pages/PAGE_ID/title-compare");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => ["Authorization: Bearer mr_ws_…", "Content-Type: application/json"],
    CURLOPT_POSTFIELDS => '{"keyword":"what is aeo","language":"en"}',
    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/PAGE_ID/title-compare",
  {
    "keyword": "what is aeo",
    "language": "en"
  },
  { headers: { Authorization: "Bearer mr_ws_…" } },
);

{
  "page": {
    "id": "c7a9e1b3-5d7f-4b9c-8e1a-3c5e7a9b1d2f",
    "url": "https://acmebikes.com/learn/what-is-aeo/"
  },
  "comparison": {
    "keyword": "what is aeo",
    "locationCode": 2840,
    "languageCode": "en",
    "comparedAt": "2026-10-09T08:12:51.000Z",
    "results": {
      "date": "2026-10-09",
      "source": "live",
      "checkUrl": "https://www.google.com/search?q=what%20is%20aeo&num=10&hl=en&gl=US",
      "top": [
        {
          "position": 1,
          "domain": "enterprise-search.example",
          "url": "https://enterprise-search.example/aeo-guide",
          "title": "What is Answer Engine Optimization? Enterprise Guide to AEO",
          "length": 59
        },
        {
          "position": 2,
          "domain": "searchfuture.example",
          "url": "https://searchfuture.example/blog/what-is-aeo",
          "title": "What is answer engine optimization (AEO)? Understanding AEO for the future of search",
          "length": 84
        },
        {
          "position": 3,
          "domain": "aeoguide.example",
          "url": "https://aeoguide.example/",
          "title": "Answer Engine Optimization: Complete AEO Guide [2026]",
          "length": 53
        },
        {
          "position": 4,
          "domain": "marketingdocs.example",
          "url": "https://marketingdocs.example/aeo",
          "title": "What Is Answer Engine Optimization (AEO)? A Complete Guide",
          "length": 58
        },
        {
          "position": 5,
          "domain": "aisearchtools.example",
          "url": "https://aisearchtools.example/learn/aeo",
          "title": "Show Up in AI Search with Answer Engine Optimization (AEO)",
          "length": 58
        }
      ]
    },
    "ours": {
      "title": "What is AEO? A simple explanation",
      "length": 33,
      "position": null,
      "positionSource": null
    },
    "findings": [
      {
        "key": "length",
        "values": {
          "ours": 33,
          "min": 53,
          "max": 84
        }
      },
      {
        "key": "phrase",
        "values": {
          "phrase": "answer engine optimization",
          "count": 5,
          "n": 5
        }
      },
      {
        "key": "phrase",
        "values": {
          "phrase": "guide",
          "count": 3,
          "n": 5
        }
      },
      {
        "key": "farDown",
        "values": {
          "position": 0
        }
      }
    ],
    "notes": [
      "Every top result spells out \"Answer Engine Optimization\"; your title only says \"AEO\", so people who search the full name do not see their words."
    ],
    "notesLanguage": "en",
    "suggestions": [
      {
        "title": "What is AEO? Answer Engine Optimization Explained",
        "length": 49,
        "why": "Keeps your plain question and spells out the full name people search for."
      },
      {
        "title": "What is AEO (Answer Engine Optimization)? A Simple Guide",
        "length": 56,
        "why": "Adds the full name and the word guide that most top results use, in your simple voice."
      }
    ],
    "resultsCostUsd": 0.002
  },
  "cost": {
    "usd": 0.002,
    "lookups": 1,
    "reused": false
  },
  "aiNote": null,
  "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/pages/c7a9e1b3-5d7f-4b9c-8e1a-3c5e7a9b1d2f#title-compare"
}

{
  "error": {
    "code": "missing_argument",
    "message": "page_id or url is required."
  }
}

{
  "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": "Page not found. Use a page_id from page_findings or list_pages, or the exact crawled url."
  }
}

{
  "error": {
    "code": "unsupported_location",
    "message": "Google results are not available for Iran, so titles cannot be compared there.",
    "country": "Iran"
  }
}

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

{
  "error": {
    "code": "failed",
    "message": "Google results could not be fetched right now. Try again in a few minutes."
  }
}

{
  "error": {
    "code": "no_provider",
    "message": "Google results are not available on this server yet."
  }
}