List content ideas

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

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

{
  "domains": [
    "bikeworld.example",
    "cyclehub.example"
  ],
  "total": 12,
  "page": 1,
  "per": 20,
  "hasMore": false,
  "gapKeywords": 318,
  "hiddenKeywords": 23,
  "topics": [
    {
      "topic": "Tires",
      "keywords": 24,
      "volume": 18400,
      "opportunity": 1210,
      "bestOpportunity": 74,
      "avgDifficulty": 31,
      "suggestion": "expand",
      "ourPages": [
        {
          "url": "https://acmebikes.com/tires/gravel/",
          "path": "/tires/gravel/",
          "keywords": 6
        }
      ],
      "competitorPages": [
        {
          "url": "https://bikeworld.example/tires/tubeless/",
          "path": "/tires/tubeless/",
          "keywords": 9
        }
      ],
      "top": [
        {
          "keyword": "tubeless gravel tires",
          "volume": 1900,
          "difficulty": 28,
          "opportunity": 74,
          "relevance": 90,
          "positions": {
            "bikeworld.example": 4,
            "cyclehub.example": 9
          },
          "pages": {
            "bikeworld.example": "https://bikeworld.example/tires/tubeless/",
            "cyclehub.example": null
          }
        }
      ]
    }
  ],
  "note": "Keyword gaps grouped by topic, most opportunity first.",
  "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/competitors"
}

{
  "error": {
    "code": "unknown_competitor",
    "message": "Not in the competitor set: shop.example. GET /competitors lists it."
  }
}

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