engagementHistory

Paginated history of engagement metric snapshots for a specific item, ordered newest first.

Paginated · weighted cost MCP: getEngagementHistory

Arguments

after String default: null: Cursor for fetching the next page of results.
filter EngagementHistoryFilterInput default: null: Filter criteria for engagement history entries.
first Int default: 20: Number of entries to return (page size).
itemId ID! required: The ID of the item to fetch engagement history for.

Returns

A paginated connection of EngagementHistoryEntry nodes. See Pagination for the connection shape.

Open in explorer ↗

Values are sampled from a demo workspace — substitute your own token and workspace id.

Paginate an item's engagement metric snapshots, newest first.

query.graphql

query EngagementHistoryDefault($itemId: ID!, $first: Int) {
  engagementHistory(itemId: $itemId, first: $first) {
    totalCount
    edges {
      node {
        at
        likes
        comments
        views
        shares
        earnedMediaValue
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

variables.json

{
  "itemId": "63c311c4-32f0-5d8c-ac02-78b160f2290a",
  "first": 5
}

Headers

Authorization: Bearer docs_demo_token_0000000000000000000000
WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a

Request · cURL

curl https://app.archive.com/api/v2 \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer docs_demo_token_0000000000000000000000' \
  -H 'WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a' \
  -d '{
  "query": "query EngagementHistoryDefault($itemId: ID!, $first: Int) {\n  engagementHistory(itemId: $itemId, first: $first) {\n    totalCount\n    edges {\n      node {\n        at\n        likes\n        comments\n        views\n        shares\n        earnedMediaValue\n      }\n    }\n    pageInfo {\n      hasNextPage\n      endCursor\n    }\n  }\n}",
  "variables": {
    "itemId": "63c311c4-32f0-5d8c-ac02-78b160f2290a",
    "first": 5
  }
}'

Request · Node.js

const response = await fetch("https://app.archive.com/api/v2", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer docs_demo_token_0000000000000000000000",
    "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a"
  },
  body: JSON.stringify({
    query: `query EngagementHistoryDefault($itemId: ID!, $first: Int) {
  engagementHistory(itemId: $itemId, first: $first) {
    totalCount
    edges {
      node {
        at
        likes
        comments
        views
        shares
        earnedMediaValue
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}`,
    variables: {
      "itemId": "63c311c4-32f0-5d8c-ac02-78b160f2290a",
      "first": 5
    }
  })
})
console.log(JSON.stringify(await response.json(), null, 2))

Request · Ruby

require "json"
require "net/http"

query = <<~'GRAPHQL'
  query EngagementHistoryDefault($itemId: ID!, $first: Int) {
    engagementHistory(itemId: $itemId, first: $first) {
      totalCount
      edges {
        node {
          at
          likes
          comments
          views
          shares
          earnedMediaValue
        }
      }
      pageInfo {
        hasNextPage
        endCursor
      }
    }
  }
GRAPHQL

response = Net::HTTP.post(
  URI("https://app.archive.com/api/v2"),
  { query: query, variables: { "itemId" => "63c311c4-32f0-5d8c-ac02-78b160f2290a", "first" => 5 } }.to_json,
  "Content-Type" => "application/json",
  "Authorization" => "Bearer docs_demo_token_0000000000000000000000",
  "WORKSPACE-ID" => "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a"
)
puts response.body

Request · Python

import json
import requests

query = """
query EngagementHistoryDefault($itemId: ID!, $first: Int) {
  engagementHistory(itemId: $itemId, first: $first) {
    totalCount
    edges {
      node {
        at
        likes
        comments
        views
        shares
        earnedMediaValue
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}
"""

response = requests.post(
    "https://app.archive.com/api/v2",
    json={"query": query, "variables": {"itemId": "63c311c4-32f0-5d8c-ac02-78b160f2290a", "first": 5}},
    headers={
        "Authorization": "Bearer docs_demo_token_0000000000000000000000",
        "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
    },
)
print(json.dumps(response.json(), indent=2))

200 OK43 lines · expand

{
  "data": {
    "engagementHistory": {
      "totalCount": 3,
      "edges": [
        {
          "node": {
            "at": "2025-01-01T00:00:00Z",
            "likes": "100",
            "comments": "10",
            "views": null,
            "shares": "5",
            "earnedMediaValue": "200"
          }
        },
        {
          "node": {
            "at": "2024-12-31T23:00:00Z",
            "likes": "100",
            "comments": "10",
            "views": null,
            "shares": "5",
            "earnedMediaValue": "200"
          }
        },
        {
          "node": {
            "at": "2024-12-31T22:00:00Z",
            "likes": "100",
            "comments": "10",
            "views": null,
            "shares": "5",
            "earnedMediaValue": "200"
          }
        }
      ],
      "pageInfo": {
        "hasNextPage": false,
        "endCursor": "Z2lkOi8vYXJjaGl2ZS9FbmdhZ2VtZW50SGlzdG9yeUVudHJ5LzJkYTYyMTI4LTY1YTctNThhZi1hOGI2LTMwMWM3NTdlMjA4Zg=="
      }
    }
  }
}

Return an item's engagement snapshots captured within a window.