Queries

Read operations exposed by the Archive GraphQL API, grouped by functional area.

Workspaces

workspace: Return the current workspace, identified by the WORKSPACE-ID header.
workspaces: List every workspace the current API user can access.

Items & Media

itemIdsByUrl: Look up item IDs by social media URL within the current workspace. Accepts any public HTTP(S) URL. INVALID_URL means a malformed or non-HTTP URL, or a private/reserved host. A valid public URL that does not resolve returns NOT_FOUND: an unrecognized shape, a short link, or no matching item. Recognized shapes (not exhaustive): Instagram (/p/, /reel/, /reels/), TikTok (@user/video/{id}, @user/photo/{id}), and YouTube (/shorts/, /watch?v=, youtu.be/).
items: Search and paginate archived items (social content) for the current workspace. Order results with the sorting argument, for example by engagement or earned media value: items(sorting: [{sortKey: EARNED_MEDIA_VALUE, sortOrder: DESC}]). Narrow by engagement ranges with filter.engagement.
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.
transcriptions: Return transcriptions for media contents in the current workspace. Pass either mediaContentIds or itemIds, not both.

Creators & Social Profiles

creator: Return a single creator by ID for the current workspace.
creators: List and paginate creators for the current workspace, ordered newest first unless sorting or a presetId view says otherwise.
locationGroups: List the region groups (European Union, DACH, continents, UN regions, ...) a canonical location filter accepts as group, in catalogue order, each with the country names it matches. The list is the same for every workspace and is not paginated.
socialProfile: Return a single social profile by ID or account identifier for the current workspace.
socialProfiles: List and paginate social profiles for the current workspace. Pass presetId (a Social Profile View id from socialProfileViews / socialProfileView) to drive results off the view's stored conditions and sort. Otherwise narrow with filter.

Labels

labels: List the creator labels of the current workspace, alphabetically by name (case-insensitive). deleting is true while a workspace-wide deletion of the label is in progress; do not assign such a label, and do not recreate it until it disappears from this list. Returns at most 1000 rows; this field is not paginated.

Engagement

engagementHistory: Paginate engagement metric snapshots for one item, newest first.

Campaigns

campaign: Return a single campaign by ID for the current workspace, or null if no such campaign exists here.
campaignCreators: Paginate one campaign's roster, newest first, with each creator's campaign-specific custom attributes. An unknown campaign ID, or one from another workspace, returns a NOT_FOUND error. Paging is offset-based: rows added or removed between pages can be skipped or returned twice.
campaigns: List and paginate campaigns for the current workspace, ordered newest first. Excludes campaigns of templates hidden for the workspace. Workflow campaigns appear only when their type is exposed by the API and the in-app campaigns page lists them.

Competitor Insights

competitorBrand: Return a single Competitor Insights brand by ID for the current workspace, or null if no brand with that ID is tracked here. The workspace's own-brand entry also resolves, by its stable id. Pair with competitorBrandItems(brandId:, filter:, …) to paginate the brand's media items. When aggregate metrics are unavailable, the roster data still returns, with a SERVICE_UNAVAILABLE error. Match on extensions.code and retry later.
competitorBrandItems: Paginate Competitor Insights posts for a brand within a required filter.takenAt window. Posts for a month become queryable on day 9 of the following month.
competitorBrands: List Competitor Insights brands tracked by the current workspace, newest first. Each brand carries aggregate metrics over a period/date window (default month). The first page also returns the workspace's own brand as one pinned node, flagged isOwnBrand. It comes in addition to up to first competitor brands, so one query gives self-vs-competitor Share of Voice. totalCount counts tracked competitor brands only. Pair with competitorBrandItems(brandId:, filter:, …) to paginate a brand's media items. When aggregate metrics are unavailable, the roster data still returns, with a SERVICE_UNAVAILABLE error. Match on extensions.code and retry later.

Collections

collection: Return a single Collection by ID for the current workspace, or null if no such Collection exists here.
collections: List Collections (saved tag sets) for the current workspace, in the workspace's saved order. Returns at most 1000 rows; this field is not paginated.

Views & View Groups

contentView: Return a single saved Content View by ID for the current workspace, or null if no such view exists here or it is hidden in the Archive app. Pair with items(presetId:) to fetch its items.
contentViews: List saved Content Views for the current workspace, most-recently-updated first. Views hidden in the Archive app are not returned. Pair with items(presetId:) to fetch a view's items. Returns at most 1000 rows; this field is not paginated.
creatorView: Return a single saved Creator View by ID for the current workspace, or null if no such view exists here or it is hidden in the Archive app. Pair with creators(presetId:) to fetch its creators.
creatorViews: List saved Creator Views for the current workspace, most-recently-updated first. Views hidden in the Archive app are not returned. Pair with creators(presetId:) to fetch a view's creators. Returns at most 1000 rows; this field is not paginated.
socialProfileView: Return a single saved Social Profile View by ID for the current workspace, or null if no such view exists here or it is hidden in the Archive app. Pair with socialProfiles(presetId:) to fetch its social profiles.
socialProfileViews: List saved Social Profile Views for the current workspace, most-recently-updated first. Views hidden in the Archive app are not returned. Pair with socialProfiles(presetId:) to fetch a view's social profiles. Returns at most 1000 rows; this field is not paginated.
viewGroup: Return a single user-created view group by ID for the current workspace, or null if no such group exists here.
viewGroups: List user-created view groups for the current workspace, ordered oldest-first. Returns at most 1000 rows; this field is not paginated.

Custom Attributes

customAttributeSchemas: List the custom attribute schemas that interpret customAttributes values. Returns at most 1000 rows; this field is not paginated.

Filtering

filterPresets deprecated: List saved filter presets for items queries in the current workspace. Returns at most 1000 rows; this field is not paginated.

Async Operations

operation: Return an operation by ID, including its status and progress.
operationRecords: Paginate the per-item records of an operation, newest first. Optionally filter by record status.
operations: List operations for the current workspace, ordered newest first. Operations run by Archive staff or by no user are not listed, as in the Archive app.

Deep Research

deepResearchQuote: Validate a Deep Research report input and quote its cost without starting it.
deepResearchReport: Return one Deep Research report, with its Markdown once it has completed.
deepResearchReports: List the Deep Research reports in the current workspace, newest first.
deepResearchTemplates: List the Deep Research templates this workspace can run. A template is listed when it runs on at least one DeepResearchInputType kind and states its audienceComments and brandThreads as DeepResearchSupport values.

Webhooks

webhookDeliveries: Paginate webhook deliveries (the dead-letter surface) for the current workspace, newest first. Filter by subscription and/or status. History is retained for 30 days.
webhookEvents: Paginate webhook events (the outbox) for the current workspace, newest first. Filter by event type. History is retained for 30 days.
webhookLimits: Get the current workspace's outbound-webhook caps (maximum subscriptions, maximum content views per subscription, maximum metadata size) and how many subscriptions it already has. The caps come from the workspace plan tier unless a negotiated override applies (see capsSource).
webhookSubscriptions: List outbound-webhook subscriptions for the current workspace, newest first. Returns at most 1000 rows; this field is not paginated.
webhookSubscriptionsConnection: Paginate outbound-webhook subscriptions for the current workspace, newest first. The cursor-paginated variant of webhookSubscriptions.