مستندات توسعه دهندگان

امتیازها و تاریخچه

GET/sites/{siteId}/scores
Scope
sites:read

Current score and 13 weeks of history One point per week (the last score of that week). A new website with less than two weeks of scores gets one point per day. versions lists the weeks the score formula changed.

توضیح ها از سند OpenAPI می آیند و انگلیسی اند.

پارامترها

ناممحلتوضیح
siteIdاجباریpathstringWebsite id, from GET /sites.

پاسخ

200 · application/json

فیلدتوضیح
currentobject or null · required; Latest score; null before the first audit
current.siteinteger or null · required; Site score, 0 to 100; null until enough is measured
current.healthinteger or null · required; Health score, 0 to 100; null until enough is measured
current.aeointeger or null · required; AEO readiness, 0 to 100; null until enough is measured
current.coveragenumber · required; Share measured, 0 to 1
current.versionstring · required; Score formula version
current.computedAtstring · required
weeklylist of object · required; Oldest first
weekly[].weekdate (YYYY-MM-DD) · required; Monday of the week (or the day, for a new website)
weekly[].labelstring · required; Short date label
weekly[].siteinteger or null · required; Site score, 0 to 100; null until enough is measured
weekly[].healthinteger or null · required; Health score, 0 to 100; null until enough is measured
weekly[].aeointeger or null · required; AEO readiness, 0 to 100; null until enough is measured
weekly[].openIssuesinteger · required; Open issues then
weekly[].fixesVerifiedinteger · required; Issues a check verified fixed that week
weekly[].versionstring · required; Score formula version
weekly[].recalculatedinteger or null · required; The site score recomputed under the newest formula, where it was
versionslist of object · required; When the score formula changed
versions[].weekdate (YYYY-MM-DD) · required; First week with the new version
versions[].versionstring · required; Score formula version

خطاها

کدمعنی
401Missing, unknown or revoked key. Codes: missing_key, invalid_key.
403The key lacks the scope, covers another website, or its owner lost access. Codes: missing_scope, other_site, owner_left, no_owner, forbidden.
404Not found. Codes: not_found.
429Too many requests this hour for this key. Codes: rate_limited.

نمونه درخواست

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

نمونه پاسخ

{
  "current": {
    "site": 78,
    "health": 81,
    "aeo": 69,
    "coverage": 0.92,
    "version": "1.1.0",
    "computedAt": "2026-10-04T02:41:12.000Z"
  },
  "weekly": [
    {
      "week": "2026-09-21",
      "label": "Sep 21",
      "site": 74,
      "health": 77,
      "aeo": 66,
      "openIssues": 21,
      "fixesVerified": 3,
      "version": "1.1.0",
      "recalculated": null
    },
    {
      "week": "2026-09-28",
      "label": "Sep 28",
      "site": 78,
      "health": 81,
      "aeo": 69,
      "openIssues": 17,
      "fixesVerified": 4,
      "version": "1.1.0",
      "recalculated": null
    }
  ],
  "versions": []
}