Documents

30- and 7-day counters for one document. All zero when it has none.

Public reader and agent activity counters. Not billed.

get/v2/documents/{document_id}/activity

Request

  • Base URL: https://api.machinelibrary.ai
  • URL: https://api.machinelibrary.ai/v2/documents/{document_id}/activity
  • Auth: one of:
    • API key in header X-Api-Key
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.machinelibrary.ai/v2/oauth/authorize, token URL https://api.machinelibrary.ai/v2/oauth/token, scopes: search)

Path parameters

document_idstring required

Machine Library document ID.

Response

Activity counters, refreshed every 15 minutes, and live comment counts.

agent_reads_30dinteger required
agent_reads_7dinteger required

MCP agents fetched the document or searched inside it.

ai_citations_30dinteger required
ai_citations_7dinteger required

Cited in generated answers.

as_of_atinteger nullable

Snapshot time (Unix seconds); null when the document has no recorded activity.

document_idstring required
positive_ratings_30dinteger required
positive_ratings_7dinteger required

Relevance feedback graded 2 or 3.

shown_30dinteger required
shown_7dinteger required

Times returned by authenticated searches.

views_30dinteger required
views_7dinteger required

Page views, once per visitor and UTC day.

Changes

No recorded changes to this operation across all 1 revision of this API.