فهرست موضوع ها

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

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

{
  "period": {
    "from": "2026-09-06",
    "to": "2026-10-03"
  },
  "queriesWindow": {
    "from": "2026-09-04",
    "to": "2026-10-01"
  },
  "sort": "clicks",
  "minPages": 2,
  "searchData": true,
  "pagesCapped": false,
  "totalTopics": 14,
  "topics": [
    {
      "id": "t_8f3a2c1d",
      "name": "gravel bike",
      "nameFrom": "queries",
      "section": null,
      "words": [
        "gravel",
        "bike"
      ],
      "pageCount": 6,
      "pagesWithoutSearchData": 1,
      "pages": [
        {
          "url": "https://acmebikes.com/guides/how-to-choose-a-gravel-bike",
          "clicks": 912,
          "impressions": 24300,
          "position": 6.8
        },
        {
          "url": "https://acmebikes.com/bikes/gravel",
          "clicks": 655,
          "impressions": 18120,
          "position": 9.1
        }
      ],
      "pagesTruncated": false,
      "clicks": 1840,
      "impressions": 51200,
      "ctr": 0.0359,
      "position": 8.3,
      "clicksPer28Days": 1840,
      "strength": "strong",
      "clicksShort": 0,
      "topQueries": [
        {
          "query": "best gravel bike under 1500",
          "clicks": 214,
          "impressions": 8650,
          "ctr": 0.0247,
          "position": 7.9
        }
      ]
    }
  ],
  "ungrouped": {
    "pageCount": 9,
    "clicks": 140,
    "impressions": 6100,
    "pages": [
      {
        "url": "https://acmebikes.com/about",
        "clicks": 31,
        "impressions": 420,
        "position": 3.4
      }
    ]
  },
  "uncovered": {
    "pageCount": 3,
    "pages": [
      {
        "url": "https://acmebikes.com/bikes/kids/balance-bike-12",
        "section": "bikes"
      }
    ],
    "truncated": false
  },
  "cached": false,
  "computedAt": "2026-10-06T08:14:02.311Z",
  "note": "Pages grouped into topics by their address and their Search Console queries. …",
  "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/pages"
}

{
  "error": {
    "code": "bad_period",
    "message": "Send start and end as YYYY-MM-DD, end alone for the 28 days ending there, or neither for the last 28 days of final data."
  }
}

{
  "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": "Topics for this website were computed for 2 other periods in the last minute. Try again in a minute; a period asked before is answered from the cache."
  }
}