Query

mediaContents

Return media contents (images / videos) for items or Competitor Insights posts. Pass exactly one of itemIds or competitorBrandItemIds; both, or neither, is a GraphQL error. itemIds must belong to the current workspace. competitorBrandItemIds come from competitorBrandItems; posts of a brand the workspace does not track return no rows.

MCP: getMediaContents

Arguments

competitorBrandItemIds [ID!]: CompetitorBrandItem UUIDs to fetch contents for (1 to 100 per request). Obtain them from the competitorBrandItems(brandId:, filter:) query. Mutually exclusive with itemIds.
itemIds [ID!]: Item UUIDs to fetch contents for (1 to 100 per request). Mutually exclusive with competitorBrandItemIds.

Returns

Returns [MediaContent!]!.

Open in explorer ↗

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

Fetch images and videos for a set of item IDs.

query.graphql

query MediaContentsDefault($itemIds: [ID!]) {
  mediaContents(itemIds: $itemIds) {
    ... on Image {
      id
      type
      mediaItemId
      fileUrl
      thumbnailUrl
      width
      height
    }
    ... on Video {
      id
      type
      mediaItemId
      fileUrl
      thumbnailUrl
      videoDuration
    }
  }
}

variables.json

{
  "itemIds": [
    "63c311c4-32f0-5d8c-ac02-78b160f2290a",
    "99bb982f-563c-5cd7-9475-2798be58f881"
  ]
}

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 MediaContentsDefault($itemIds: [ID!]) {\n  mediaContents(itemIds: $itemIds) {\n    ... on Image {\n      id\n      type\n      mediaItemId\n      fileUrl\n      thumbnailUrl\n      width\n      height\n    }\n    ... on Video {\n      id\n      type\n      mediaItemId\n      fileUrl\n      thumbnailUrl\n      videoDuration\n    }\n  }\n}",
  "variables": {
    "itemIds": [
      "63c311c4-32f0-5d8c-ac02-78b160f2290a",
      "99bb982f-563c-5cd7-9475-2798be58f881"
    ]
  }
}'

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 MediaContentsDefault($itemIds: [ID!]) {
  mediaContents(itemIds: $itemIds) {
    ... on Image {
      id
      type
      mediaItemId
      fileUrl
      thumbnailUrl
      width
      height
    }
    ... on Video {
      id
      type
      mediaItemId
      fileUrl
      thumbnailUrl
      videoDuration
    }
  }
}`,
    variables: {
      "itemIds": [
        "63c311c4-32f0-5d8c-ac02-78b160f2290a",
        "99bb982f-563c-5cd7-9475-2798be58f881"
      ]
    }
  })
})
console.log(JSON.stringify(await response.json(), null, 2))

Request · Ruby

require "json"
require "net/http"

query = <<~'GRAPHQL'
  query MediaContentsDefault($itemIds: [ID!]) {
    mediaContents(itemIds: $itemIds) {
      ... on Image {
        id
        type
        mediaItemId
        fileUrl
        thumbnailUrl
        width
        height
      }
      ... on Video {
        id
        type
        mediaItemId
        fileUrl
        thumbnailUrl
        videoDuration
      }
    }
  }
GRAPHQL

response = Net::HTTP.post(
  URI("https://app.archive.com/api/v2"),
  { query: query, variables: { "itemIds" => ["63c311c4-32f0-5d8c-ac02-78b160f2290a", "99bb982f-563c-5cd7-9475-2798be58f881"] } }.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 MediaContentsDefault($itemIds: [ID!]) {
  mediaContents(itemIds: $itemIds) {
    ... on Image {
      id
      type
      mediaItemId
      fileUrl
      thumbnailUrl
      width
      height
    }
    ... on Video {
      id
      type
      mediaItemId
      fileUrl
      thumbnailUrl
      videoDuration
    }
  }
}
"""

response = requests.post(
    "https://app.archive.com/api/v2",
    json={"query": query, "variables": {"itemIds": ["63c311c4-32f0-5d8c-ac02-78b160f2290a", "99bb982f-563c-5cd7-9475-2798be58f881"]}},
    headers={
        "Authorization": "Bearer docs_demo_token_0000000000000000000000",
        "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
    },
)
print(json.dumps(response.json(), indent=2))

200 OK 23 lines

{
  "data": {
    "mediaContents": [
      {
        "id": "1",
        "type": "IMAGE",
        "mediaItemId": "70150764-391a-5058-a409-df18743603d5",
        "fileUrl": "http://example.com/seeds/images-600x600/0001.jpg",
        "thumbnailUrl": "http://example.com/seeds/images-600x600/0001.jpg",
        "width": 600,
        "height": 600
      },
      {
        "id": "2",
        "type": "VIDEO",
        "mediaItemId": "710e5589-be6b-5fc5-9f9f-f4e4d6d0f076",
        "fileUrl": "http://example.com/seeds/images-600x600/0002.jpg",
        "thumbnailUrl": "http://example.com/seeds/images-600x600/0002.jpg",
        "videoDuration": 10
      }
    ]
  }
}