Profiles and connections
Read an account's profile, recent original posts, followers, and following.
Read a profile
GET /{handle} — the permalink form. It returns the profile and up to 20 recent original posts. Replies and reposts are filtered after retrieval, so a page can contain fewer than 20 posts.
curl -sS 'https://xmd.staticvar.dev/vercel?full=true'GET /api/v1/profiles/{handle} — the same read on the versioned surface.
curl -sS 'https://xmd.staticvar.dev/api/v1/profiles/vercel?full=true'Read connections
GET /{handle}/followers and GET /{handle}/following list who follows an account and who it follows.
curl -sS 'https://xmd.staticvar.dev/vercel/followers'The same two lists sit under /api/v1/profiles/{handle}:
curl -sS 'https://xmd.staticvar.dev/api/v1/profiles/vercel/following?format=json'| Permalink route | Versioned route | JSON fields |
|---|---|---|
/{handle} |
/api/v1/profiles/{handle} |
profile and posts |
/{handle}/followers |
/api/v1/profiles/{handle}/followers |
users |
/{handle}/following |
/api/v1/profiles/{handle}/following |
users |
Both forms take the same options and return the same body; the versioned ones are the stable machine surface. Use a handle without @ in the URL. Connection data depends on upstream availability.
Options
| Parameter | Default | Behavior |
|---|---|---|
limit |
20 |
Items per response, maximum 20. Larger values are clamped. |
cursor |
— | Opaque nextCursor from the previous response. |
page |
1 |
Page 1–10; prefer cursors. Ignored when cursor is present. |
full |
false |
true or 1 adds dates, metrics, and expanded profile details. |
format |
markdown |
markdown or json. Browse routes do not accept obsidian. |
nocache |
false |
true or 1 bypasses the application cache. |
Follow nextCursor to continue. See pagination.