Entwicklerdokumentation

Websites auflisten

GET/sites
Berechtigung
sites:read
MCP-Tool
list_sites

Websites this key can read A website key lists its one website; a workspace key every website it covers.

Die Beschreibungen kommen aus dem OpenAPI-Dokument und sind auf Englisch.

Parameter

Keine Parameter.

Antwort

200 · application/json

FeldDetails
siteslist of object · required
sites[].idstring · required; Website id
sites[].namestring · required; Website name
sites[].urladdress (URL) · required; Home page address
sites[].platformwordpress | astro | shopify | webflow | other | unknown · required; What the website runs on
sites[].linkaddress (URL) · required; The website in the app

Fehler

StatusBedeutung
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.
429Too many requests this hour for this key. Codes: rate_limited.

Beispielanfrage

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

Beispielantwort

{
  "sites": [
    {
      "id": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13",
      "name": "Acme Bikes",
      "url": "https://acmebikes.com/",
      "platform": "wordpress",
      "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/overview"
    }
  ]
}

Der MCP-Server macht dasselbe mit dem Tool list_sites.