GET/api/v1/me/analytics/ai/story

What changed (AI)

Insights for the analytics home: a headline and 3 to 5 bullets, each a sentence on what changed against the period before and the likely cause, with an href to the analytics page to look at (and doc when it's about one of your links). Claude Haiku 5.5 writes it from totals and your own titles only. Kept for the day (cached: true); fresh=1 writes it again. status is thin when there are fewer than 20 views to go on, limit when an AI limit stops it (with reason and message), or error. Counts towards your AI limits.

API token required30 per minute per IPMCP: analytics_story

Guide: Insights and Ask

Code samples and Try it

Query parameters

rangestring
7d (the default), 30d or 90d. One of 7d, 30d, 90d. One of 7d, 30d, 90d. Default "7d".
freshinteger
1 writes it again instead of using today's copy. 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.

const res = await fetch("https://api.markdrop.in/api/v1/me/analytics/ai/story?range=7d", { 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/analytics/ai/story?range=7d", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, ) r.raise_for_status() print(r.json())