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

Get AI insights

The saved AI analysis of one of your documents or files, never a new one. kind is content (documents and pages), media (video and audio), pages (PDFs) or versions (files with several versions). state is ready (with result: summary and 3 to 5 findings), empty (nothing yet: POST to analyse), thin (fewer than 20 sessions with data: sample says how many), encrypted or unsupported. stale is true when the document changed since; limit says why AI can't run right now.

API token required120 per minute per IPMCP: analyze_document_engagement

Guide: AI insights for one link

Code samples and Try it

Path parameters

slugstringRequired
The document's address: the part after markdrop.in/.
kindstringRequired
One of content, media, pages, versions. One of content, media, pages, versions.

Query parameters

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.
verinteger
From 1 to 100,000.

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.

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

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