GET/api/v1/me/documents/{slug}/analytics

Document view totals

View counts, unique readers, read depth and top referrers for a document. Owner only: anyone else who can read it gets 403.

API token requiredMCP: get_document_stats

Code samples and Try it

Path parameters

slugstringRequired
The document's address: the part after markdrop.in/.

Query parameters

rangestring
The period to count: 7d, 30d, 90d or all. One of 7d, 30d, all. One of 7d, 30d, all. Default "30d".

Responses

200OK.
401No token, or the token is revoked or mistyped.
422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).

bash

curl https://api.markdrop.in/api/v1/me/documents/k3x9q2m/analytics \
  -H "Authorization: Bearer $MARKDROP_TOKEN"

javascript

const res = await fetch("https://api.markdrop.in/api/v1/me/documents/k3x9q2m/analytics", {
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
  },
});
const data = await res.json();

python

import os

import requests

r = requests.get(
    "https://api.markdrop.in/api/v1/me/documents/k3x9q2m/analytics",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
)
r.raise_for_status()
print(r.json())

Try it

API token

Kept in this tab only. Without one, the command reads $MARKDROP_TOKEN. Create a token

slugrequired

range

Your request

curl https://api.markdrop.in/api/v1/me/documents/k3x9q2m/analytics \
  -H "Authorization: Bearer $MARKDROP_TOKEN"

The API accepts browser requests only from markdrop.in, so this page can’t send it for you. Run the command in a terminal.

Did this page help?