Archive API docs
    Jump to

    Narrow by kind with a prefix — q: queries, m: mutations, t: types, g: guides, f: fields and arguments.

    Object

    Item

    A single piece of social content archived in Archive.

    Fields

    Object, input and enum types open in place — use + to reveal their fields. A type that is already open above the row stops at a ↻ circular marker, and anything nested past the depth limit links out to its own page instead.

    aiFilterReasons [AiFilterReason!]!
    Explanations the AI Filters produced for this item's AI-generated custom attributes, one entry per AI-generated attribute the item has. Pair each entry to its value by key in customAttributes; customAttributeSchemas marks which keys are AI-generated via aiGenerated. Empty when the item has none.
    archivePublicUrl String
    Stable Archive permalink for this item. Unlike originalUrl, this URL keeps resolving after the source post is deleted or the creator account goes private.
    caption String
    Caption text of the content, when available.
    coAuthors [SocialProfile!]!
    Other social profiles credited as co-authors of a collaborative post, excluding socialProfile itself. Empty for a single-author post.
    createdAt DateTime!
    Timestamp when Archive ingested the item into this workspace (UTC). Compare takenAt, the publication time on the platform.
    creator Creator!
    Creator who posted this content.
    currentEngagement Engagement
    Most recent engagement metrics (likes, comments, impressions, shares, EMV) and virality score for this item. Read impressions for views, plays, or reach.
    customAttributes JSON!
    Custom metadata fields associated with the item.
    customProduct ItemCustomProduct
    The custom product (a link with a call to action) attached to this item. Null when none is attached.
    detectedPaidPartnership Boolean!
    Whether Archive's AI classifier detected a paid partnership (sponsored, affiliate, collab or gifted content) on this item. Reflects AI detection only: a native platform paid-partnership disclosure on its own does not make this true. See detectedPaidPartnershipDetails for the classifier's reasoning.
    detectedPaidPartnershipDetails DetectedPaidPartnershipDetails
    The AI classifier's detection details for this item. Null when detectedPaidPartnership is false.
    externalId ID!
    Platform-specific identifier for the content (e.g., Instagram post ID, TikTok video ID).
    hashtags [String!]
    List of hashtags used in the item’s caption or metadata.
    id ID!
    Unique identifier for the item in Archive's system.
    location Location
    Location associated with the content, if present.
    mediaItemId ID!
    Identifier of the parent media item. Use this to group related contents (e.g., carousel frames) that belong to the same post.
    mentions [String!]
    List of user mentions used in the item’s caption or metadata.
    originalUrl String
    Direct URL to the original content on the social platform. Returns null for content types without public URLs (e.g., Instagram Stories).
    products ItemProduct paginated
    Products from the workspace's Shopify catalog linked to this item, by a person or by Archive's product detection, ordered by product ID. Paginated with first (default 20, maximum 100) and after; totalCount is computed only when selected. Empty when none is linked.
    provider Provider!
    Platform where the content exists (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
    restricted Boolean
    True when the workspace's legacy per-creator plan limit hides this item's preview and public link in the Archive app (its creator falls outside the plan's creator limit and the item is not in any of the workspace's collections). False otherwise, including on every plan priced by monthly content volume. The API still returns the full item.
    sentiment ItemSentiment
    AI-classified sentiment of the content, from the workspace's sentiment custom attribute. Null when the item has not been classified or the workspace does not run sentiment analysis.
    socialProfile SocialProfile!
    Social media profile on which this content was posted.
    sourceIds [ID!]!
    IDs of the workspace sources (tracked hashtags, mentions or accounts) that captured this item. The same IDs ItemFilterInput.sourcesIds takes. Empty when no source captured it (for example a manual upload).
    takenAt DateTime!
    Timestamp when the content was originally published on the social platform (UTC).
    thumbnailUrl String
    URL of a preview image for the item: the first of its media contents' thumbnailUrl that is available. Null when no content has a preview.
    transcriptions [Transcription!]!
    Text transcriptions and subtitles generated for video content within this item.
    type ItemType!
    Type of archived content (for example POST, REEL, STORY or SHORT), depending on the platform. Platform-neutral: read it together with provider. ItemFilterInput.itemTypes uses platform-qualified values instead (a TikTok POST is filtered as TIKTOK).
    usageRights ItemUsageRights paginated
    The usage-rights, Instagram Partnership Ad and TikTok Spark Ad requests the workspace sent the creator for this item, one entry per request, newest first. An item matched by ItemFilterInput.usageRightsStatus, instagramWhitelistingStatus or tiktokSparkCodeStatus has an entry with that scope and status. Paginated with first (default 20, maximum 100) and after; totalCount is computed only when selected. Empty when none was requested.