فهرست موردهای جذب لینک

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

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

{
  "filters": {
    "status": null,
    "source": null,
    "tag": null,
    "spam": false,
    "include": []
  },
  "counts": {
    "all": 64,
    "status": {
      "to_contact": 51,
      "contacted": 8,
      "added": 3,
      "declined": 2
    },
    "source": {
      "ai_source": 12,
      "best_list": 9,
      "link_gap": 38,
      "lost_link": 4,
      "manual": 1
    },
    "spamHidden": 5,
    "platformHidden": 2,
    "autoHidden": 11,
    "goneHidden": 3
  },
  "total": 64,
  "page": 1,
  "per": 50,
  "hasMore": true,
  "targets": [
    {
      "id": "0b2d4f6a-8c0e-4a2c-9e4a-8c0e2a4c6e8a",
      "source": "link_gap",
      "url": "https://rideguide.example/best-bike-shops/",
      "domain": "rideguide.example",
      "title": "The best online bike shops",
      "score": 82,
      "class": "editorial",
      "reason": {
        "competitors": [
          "bikeworld.example",
          "cyclehub.example"
        ],
        "domainRank": 47,
        "ourRank": 33,
        "spamScore": 4,
        "outOf": 2,
        "backlinks": 5,
        "pages": [
          {
            "competitor": "bikeworld.example",
            "url": "https://rideguide.example/best-bike-shops/",
            "anchor": "Bike World",
            "title": "The best online bike shops"
          }
        ],
        "pageKind": "review",
        "pageKindBy": "ai"
      },
      "status": "contacted",
      "statusAt": "2026-10-02T09:30:00.000Z",
      "statusAuto": false,
      "note": "Emailed the editor on Oct 2.",
      "tags": [
        "gear-review"
      ],
      "firstSeen": "2026-09-14T03:00:00.000Z",
      "lastSeen": "2026-10-05T03:00:00.000Z",
      "gone": false,
      "check": {
        "at": "2026-10-05T03:10:00.000Z",
        "ok": true,
        "status": 200,
        "linksUs": false,
        "mentionsUs": false,
        "matched": []
      },
      "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/outreach?open=0b2d4f6a-8c0e-4a2c-9e4a-8c0e2a4c6e8a"
    }
  ],
  "note": "Pages and sites worth asking for a link or a mention, with why (reason) and a score (0–100, higher first).",
  "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/outreach"
}

{
  "error": {
    "code": "bad_status",
    "message": "status must be one of to_contact, contacted, added, declined."
  }
}

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