Developers
Ask
Sign inSign in

Get plan details

What exactly does a plan include and allow?

1 min readUpdated 15 November 2026
Short answer

dorna_get_plan returns the full plan sheet: the outlet and its metrics, the price, the content limits, the outlet's rules, where the article is published and the publisher's track record.

  • dorna_get_plan
  • Read only
Contents
  1. Parameters
  2. What it returns
  3. Example
  4. Access and confirmation

Parameters

FieldTypeDescription
planIdstring (ID)Required. The plan's ID, exactly as returned by dorna_search_media, dorna_get_media or dorna_get_plan.

What it returns

The price with VAT (priceRials) and without (priceRialsBeforeVat); content limits (words, images, videos, follow and nofollow links, forbidden words and subjects, tags); the outlet's rules; publish places (front page, category, sidebar, social channels, where included is in the price and viaAddon needs a separate add-on); the publisher's record (time to publish and index, index and health rates); buyer ratings; the latest published reportages; add-ons; and for backlinks the position, link type and durations. A null section means not measured, not zero.

Example

Ask your assistant: Does this plan allow two follow links and 800 words?

The assistant then calls the tool like this:

{
  "name": "dorna_get_plan",
  "arguments": {
    "planId": "64f1a2b3c4d5e6f7a8b9c0d1"
  }
}

A typical result looks like this (the values are examples):

{
  "media": {
    "id": "64f1a2b3c4d5e6f7a8b9c0d1",
    "name": "Tech Daily",
    "url": "https://tech.example.com/article",
    "logoUrl": "https://tech.example.com/logo.png",
    "domainAuthority": 52,
    "spamScore": 2,
    "domainRating": 48,
    "ahrefsRank": 120000,
    "monthlyTraffic": 450000,
    "referringDomains": 1800,
    "googleIndexCount": 12000
  },
  "plan": {
    "id": "64f1a2b3c4d5e6f7a8b9c0d1",
    "name": "Tech Daily",
    "planType": "WEB",
    "priceRials": 11880000,
    "priceRialsBeforeVat": 10800000,
    "orderPriceRials": 12000000,
    "slaDays": 3,
    "description": {
      "quotedSiteText": "Text copied from the site",
      "truncated": false
    }
  },
  "contentLimits": {
    "minWords": 300,
    "maxWords": 800,
    "maxPics": 3,
    "maxVideos": 0,
    "videoAllowed": false,
    "maxFollowLinks": 2,
    "maxNoFollowLinks": 1,
    "multipleDomainLinks": true,
    "tieredLinkBuilding": true,
    "forbiddenWords": [],
    "forbiddenSubjects": [],
    "forbiddenTags": [],
    "requiredTags": [],
    "recommendedTags": []
  },
  "rules": {
    "plan": {
      "quotedSiteText": "Text copied from the site",
      "truncated": false
    },
    "publisher": {
      "quotedSiteText": "Text copied from the site",
      "truncated": false
    },
    "archive": {
      "quotedSiteText": "Text copied from the site",
      "truncated": false
    },
    "primaryImageSize": "1200×630",
    "imageSize": "1200×630"
  },
  "publishing": {
    "places": [],
    "archivePlace": "Archive",
    "publishInHoliday": true,
    "directPublish": true
  },
  "publisherRecord": {
    "averagePublishTime": "2026-11-01T09:30:00.000Z",
    "averageIndexTime": "2026-11-01T09:30:00.000Z",
    "indexedPercentage": 91,
    "healthyReportagesPercentage": 97,
    "totalPublishCount": 320
  },
  "votes": {
    "averageScore": 4.6,
    "votes": 38,
    "perScore": [
      {
        "score": 5,
        "count": 1
      }
    ],
    "highlights": [
      {
        "title": {
          "quotedSiteText": "Text copied from the site",
          "truncated": false
        },
        "type": "monthly",
        "count": 1
      }
    ]
  },
  "latestReportages": [
    {
      "title": {
        "quotedSiteText": "Text copied from the site",
        "truncated": false
      },
      "url": "https://tech.example.com/article",
      "publishDate": "2026-11-01T09:30:00.000Z"
    }
  ],
  "addons": [
    {
      "id": "64f1a2b3c4d5e6f7a8b9c0d1",
      "key": "mainPage",
      "title": "Our new payments app is live",
      "priceRials": 11880000
    }
  ],
  "backlink": null
}

Access and confirmation

Read only: this tool never changes anything in your account.

Related tools: dorna_search_media dorna_get_media dorna_create_campaign

Still have a question?

Open this guide in your own AI assistant and ask it.

ChatGPTClaudeGemini