API reference

PostsList

List partner posts with filter, sort and cursor paging: partner, campaign, metrics and validity. Read access, posts toolset, MCP tool list_posts.

Access: Read

Variables

Variable	Type	Required	Accepts	Description
`after`	`Cursor`	no	Opaque cursor from `pageInfo.endCursor`
`filter`	`PartnerPostFilter`	no	PartnerPostFilter
`first`	`Int!`	yes	32-bit integer. MCP tools send `50` when it is left out
`orderBy`	`[PartnerPostOrderBy!]!`	no	One of 41 values, see PartnerPostOrderBy. Default `["PUBLISHED_AT_DESC"]`	The method to use when ordering `PartnerPost`.
`withSeries`	`Boolean!`	yes	MCP tools send `false` when it is left out	Included when true.

Call it

bash

curl https://api.missin.co.uk/graphql/v1 \
  -H "Authorization: Bearer $MISSIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operationName":"PostsList","variables":{"first":50,"withSeries":false},"extensions":{"persistedQuery":{"version":1,"sha256Hash":"454ab4aaf43e60b78210669f70f2fa2c50de0d4945b81f9a8d7efbeac77d1ea0"}}}'

Document

graphql

query PostsList($after: Cursor, $filter: PartnerPostFilter, $first: Int!, $orderBy: [PartnerPostOrderBy!]! = [PUBLISHED_AT_DESC], $withSeries: Boolean!) { __typename allPartnerPosts( first: $first after: $after orderBy: $orderBy filter: $filter ) { __typename nodes { __typename campaignByCampaignId { __typename id name rowId } campaignId campaignSignalByCampaignSignalId { __typename id kind value } campaignSignalId caption comments crosspostCount crosspostGroupId engagementRate hashtags id isSponsored lastSyncedAt likes mentions metricsUpdatedAt originId partnerByPartnerId { __typename profileImage: avatarUrl id name rowId username } partnerPostMetricsByPartnerPostId(last: 40) @include(if: $withSeries) { __typename nodes { __typename capturedAt comments likes shares views } } postType postUrl publishedAt rowId shares status title trackingEnabled validity views ... on PartnerPostFacebookPost { __typename ocrText thumbnailUrl } ... on PartnerPostInstagramPost { __typename displayUrl videoUrl } ... on PartnerPostInstagramReel { __typename displayUrl videoUrl } ... on PartnerPostTiktokVideo { __typename coverUrl } ... on PartnerPostYoutubeVideo { __typename thumbnailUrl } } pageInfo { __typename endCursor hasNextPage } totalCount } }