خلاصه جست وجو

curl \
  -H "Authorization: Bearer mr_ws_…" \
  "https://app.monoranks.com/api/v1/sites/SITE_ID/search/summary"

const res = await fetch("https://app.monoranks.com/api/v1/sites/SITE_ID/search/summary", {
  headers: { Authorization: "Bearer mr_ws_…" },
});
if (!res.ok) throw new Error((await res.json()).error.message);
const data = await res.json();

import requests

res = requests.get(
    "https://app.monoranks.com/api/v1/sites/SITE_ID/search/summary",
    headers={"Authorization": "Bearer mr_ws_…"},
)
res.raise_for_status()
data = res.json()

<?php
$ch = curl_init("https://app.monoranks.com/api/v1/sites/SITE_ID/search/summary");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["Authorization: Bearer mr_ws_…"],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

import axios from "axios";

const { data } = await axios.get("https://app.monoranks.com/api/v1/sites/SITE_ID/search/summary", { headers: { Authorization: "Bearer mr_ws_…" } });

{
  "connected": true,
  "period": {
    "from": "2026-09-06",
    "to": "2026-10-03"
  },
  "previous": {
    "from": "2026-08-09",
    "to": "2026-09-05"
  },
  "totals": {
    "clicks": 4820,
    "impressions": 162400,
    "ctr": 0.0297,
    "position": 14.2
  },
  "previousTotals": {
    "clicks": 4310,
    "impressions": 151900,
    "ctr": 0.0284,
    "position": 15.1
  },
  "topPages": [
    {
      "key": "https://acmebikes.com/guides/how-to-choose-a-gravel-bike",
      "clicks": 912,
      "impressions": 24300,
      "ctr": 0.0375,
      "position": 6.8,
      "prevClicks": 840,
      "prevPosition": 7.4
    },
    {
      "key": "https://acmebikes.com/bikes/gravel",
      "clicks": 655,
      "impressions": 18120,
      "ctr": 0.0361,
      "position": 9.1,
      "prevClicks": 702,
      "prevPosition": 8.7
    }
  ],
  "topQueries": [
    {
      "key": "acme bikes",
      "clicks": 540,
      "impressions": 1980,
      "ctr": 0.2727,
      "position": 1.2,
      "prevClicks": 512,
      "prevPosition": 1.3,
      "topPage": "https://acmebikes.com/"
    },
    {
      "key": "best gravel bike under 1500",
      "clicks": 214,
      "impressions": 8650,
      "ctr": 0.0247,
      "position": 7.9,
      "prevClicks": 168,
      "prevPosition": 9.4,
      "topPage": "https://acmebikes.com/guides/how-to-choose-a-gravel-bike"
    }
  ],
  "note": "CTR and position are computed from sums over the period, never averaged across rows."
}

{
  "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."
  }
}