فهرست کلمات کلیدی

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

const res = await fetch("https://app.monoranks.com/api/v1/sites/SITE_ID/keywords", {
  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/keywords",
    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/keywords");
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/keywords", { headers: { Authorization: "Bearer mr_ws_…" } });

{
  "view": "all",
  "filters": {
    "q": null,
    "intent": null,
    "minVolume": null,
    "opportunity": null,
    "source": null
  },
  "counts": {
    "all": 1240,
    "tracked": 48,
    "opportunities": 212,
    "rising": 31,
    "positions": 160,
    "notranking": 702,
    "branded": 12,
    "offtopic": 9,
    "top10": 188,
    "opportunity": {
      "new": 141,
      "improve": 71,
      "defend": 54
    }
  },
  "location": {
    "locationCode": 2840,
    "location": "United States",
    "languageCode": "en",
    "device": "mobile"
  },
  "total": 1240,
  "page": 1,
  "per": 50,
  "hasMore": true,
  "keywords": [
    {
      "id": "2d4f6b8d-0f2b-4d4f-9b6d-0f2b4d6f8b0d",
      "keyword": "gravel bike tires",
      "source": "search_console",
      "branded": false,
      "cluster": "gravel tires",
      "intent": "commercial",
      "locationCode": 2840,
      "location": "United States",
      "languageCode": "en",
      "device": "mobile",
      "volume": 2900,
      "difficulty": 34,
      "cpc": 1.12,
      "competition": 0.81,
      "monthly": [
        2400,
        2400,
        2900,
        2900,
        3600,
        3600,
        3600,
        2900,
        2900,
        2400,
        2400,
        2900
      ],
      "dataUpdatedAt": "2026-10-01T04:12:00.000Z",
      "position": 6,
      "positionFrom": "tracked",
      "gscPosition": 7.4,
      "gscClicks": 118,
      "gscImpressions": 3240,
      "gscUrl": "https://acmebikes.com/tires/gravel/",
      "tracked": true,
      "latestPosition": 6,
      "latestUrl": "https://acmebikes.com/tires/gravel/",
      "latestDate": "2026-10-05",
      "deepPosition": 6,
      "deepDate": "2026-10-05",
      "weekAgoPosition": 8,
      "bestPosition": 5,
      "features": [
        "people_also_ask",
        "images"
      ],
      "opportunity": "improve",
      "opportunityScore": 42.7,
      "relevance": 92,
      "relevanceStatus": "reviewed",
      "offTopic": false,
      "topic": "Tires",
      "relevanceReason": "Acme Bikes sells gravel tires on this page.",
      "relevanceIntent": "commercial",
      "action": {
        "id": "b2e4c6a8-1d3f-4a5b-9c7d-0e2f4a6b8c1d",
        "status": "open",
        "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/actions/b2e4c6a8-1d3f-4a5b-9c7d-0e2f4a6b8c1d"
      }
    }
  ],
  "note": "position: yesterday's Google check for tracked keywords, else the Search Console 28-day average.",
  "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/keywords"
}

{
  "error": {
    "code": "bad_view",
    "message": "view must be one of all, tracked, opportunities, rising, positions, notranking, branded, offtopic."
  }
}

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