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

Video and audio retention

How many people are still watching or listening through a video or audio file.

API token required120 per minute per IP

Guide: Video and audio

Code samples and Try it

Path parameters

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

Query parameters

verinteger
From 1 to 100,000.
rangestring
The period to count: 7d, 30d, 90d or all. One of 7d, 30d, 90d, all. One of 7d, 30d, 90d, all. Default "30d".
internalinteger
From 0 to 1. Default 0.

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).
429Too many requests from your IP address. Wait the seconds in Retry-After.

bash

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

javascript

const res = await fetch("https://api.markdrop.in/api/v1/me/documents/k3x9q2m/analytics/media", {
  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/media",
    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

ver

range

internal

Your request

curl https://api.markdrop.in/api/v1/me/documents/k3x9q2m/analytics/media \
  -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?