--- title: "List publications in a tracking" method: GET path: "/content-tracking/v1/trackings/{trackingId}/publications" tags: ["Content Tracking"] --- # List publications in a tracking `GET /content-tracking/v1/trackings/{trackingId}/publications` ## Request - Base URL: `https://api.influencity.com` - URL: `https://api.influencity.com/content-tracking/v1/trackings/{trackingId}/publications` - Auth: HTTP bearer Returns paginated publications collected in a content tracking (metrics, music, stickers, and related fields). Content filters are not supported in this version. ## Path parameters - `trackingId` string, required: Tracking identifier. ## Query parameters - `page` integer: 1-based page number. - `limit` integer: Page size (max 100). - `sortBy` 'publicationDate' | 'likes' | 'views' | 'comments' | 'shares' | 'saves' | 'engagement' | 'impressions' | 'profile' | '_id': Sort field allow-list. When omitted, influ-api sends publicationDate. - `sortOrder` 'asc' | 'desc': Sort direction. ## Response `200` Paginated publications for the tracking. - ContentTrackingGetTrackingPublicationsResponse - `data` ContentTrackingPublication[], required: Publications in the tracking. - `publicationId` string, required: Stable publication identifier. Always present. - `network` string: Social network of the post. Content tracking typically returns `instagram`, `tiktok`, or `youtube`. Omitted if unknown. - `type` string: Post format on that network (`photo`, `reel`, `story`, `video`, `carousel`, `short`, and others). Omitted if unknown. - `dataSource` string: Origin of the publication. On this endpoint almost always `contentTracking`. Omitted if unknown. - `url` string: Public permalink of the post. Omitted if unknown. - `shortcode` string: Network short code or media id used in the permalink. Omitted if unknown. - `image` string: Cover or thumbnail image URL. Omitted if unknown. - `media` string[]: Ordered media URLs (slides or extra assets). Omitted if none. - `caption` string: Post caption or description text. Omitted if empty. - `title` string: Post title when the network provides one (only on YouTube / TikTok). Omitted if none. - `hashtags` string[]: Hashtags extracted from the post. Omitted if none. - `mentions` string[]: Mentioned handles from the post. Distinct from `tags` (people tagged on the media). Omitted if none. - `keywords` string[]: Keywords or topics associated with the publication content. Not the tracking filter list. Omitted if none. - `isVideo` boolean: True when the post is treated as video. Omitted if unknown. - `duration` number: Media duration in seconds when the network provides it. Typical on Instagram Reels, TikTok video, and YouTube. Omitted if unknown. - `numberOfSlides` number: Number of slides in a carousel (or 1 for a single item). Omitted if unknown. - `partnershipLabelAndAds` string: Paid-partnership label: `sponsored` or `notCommercial`. Omitted if unknown. - `tags` string[]: Usernames tagged on the media (people in the photo or video). Omitted if none. - `collaborators` string[]: Usernames of collaborator accounts on the post. Omitted if none. - `socialNetworkStatus` string: Lifecycle of the post on the network. For content tracking: `live`, `removed`, or `expired`. Omitted if unknown. - `internalStatus` string: Ingestion or refresh status in Influencity: `ok`, `processing`, or `error`. Omitted if unknown. - `publicationDate` string: Instant the post was published, ISO 8601 UTC. Omitted if unknown. - `lastUpdate` string: Instant this publication was last refreshed by the tracking, ISO 8601 UTC. Distinct from `updatedAt`. Omitted if unknown. - `createdAt` string: Instant the publication record was created in Influencity, ISO 8601 UTC. Omitted if unknown. - `updatedAt` string: Instant the publication record was last written, ISO 8601 UTC. Omitted if unknown. - `usageRights` string: Usage-rights state: `validUntil`, `validIndefinitely`, `noUsageRights`, `expired`, or `undefined`. Omitted if unknown. - `usageRightsDateRangeStartDate` string: Start of the usage-rights window, ISO 8601 UTC. Present when rights are time-bounded. Omitted otherwise. - `usageRightsDateRangeEndDate` string: End of the usage-rights window, ISO 8601 UTC. Present when `usageRights` is `validUntil`. Omitted otherwise. - `likes` number: Like count. Omitted if the network did not provide it. - `views` number: View count. Omitted if the network did not provide it. - `comments` number: Comment count. Omitted if the network did not provide it. - `shares` number: Share count. Omitted if the network did not provide it. - `saves` number: Save or bookmark count. Omitted if the network did not provide it. - `engagement` number: Engagement rate as a percentage of the author follower count. Omitted when interactions or followers are missing. - `impressions` number: Impression count. Omitted if unknown. - `reposts` number: Repost or reuse count when provided. Omitted otherwise. - `totalInteractions` number: Sum of interactions that have occurred on the publication. Omitted if no interaction components are present. - `externalLinkTaps` number: Taps on an external link when provided. Omitted if unknown. - `dislikes` number: Dislike count. Typical on YouTube. Omitted if the network did not provide it. - `estimatedViews` number: Estimated view count when computed. Omitted otherwise. - `accountsReached` number: Unique accounts that viewed the publication when provided. Omitted if unknown. - `accountsEngaged` number: Unique accounts that engaged when provided. Omitted if unknown. - `follows` number: Follows attributed to the post when provided. Omitted if unknown. - `profileVisits` number: Profile visits attributed to the post when provided. Omitted if unknown. - `avgWatchTime` number: Average watch time in seconds when provided. Omitted if unknown. - `watchTime` number: Total watch time in seconds when provided. Omitted if unknown. - `forwards` number: Story forwards when provided. Typical on Instagram Stories. Omitted if unknown. - `nextStory` number: Taps to the next story when provided. Typical on Instagram Stories. Omitted if unknown. - `exited` number: Story exits when provided. Typical on Instagram Stories. Omitted if unknown. - `replies` number: Story or reply count when provided. Omitted if unknown. - `returningViewers` number: Viewers who returned to the content when provided. Omitted if unknown. - `likeAndViewCountDisabled` boolean: True when the creator hid like or view counts on the network. Typical on Instagram. Omitted if unknown. - `music` ContentTrackingPublicationMusic: Licensed music or audio metadata. Omitted if no audio metadata is present. - `title` string: Track title. Omitted if unknown. - `displayArtist` string: Artist display name. Omitted if unknown. - `igUsername` string: Instagram username of the artist, when provided. Omitted if unknown. - `igArtistFullname` string: Instagram full name of the artist. Omitted if unknown. - `igArtistIsVerified` boolean: Whether the Instagram artist account is verified. Omitted if unknown. - `author` string: Author or composer credit. Omitted if unknown. - `album` string: Album name. Omitted if unknown. - `link` ContentTrackingPublicationLink: Link sticker. Omitted if absent. - `title` string: Link-sticker label. Typical on Instagram Stories. Omitted if unknown. - `displayUrl` string: Link-sticker URL shown to viewers. Omitted if unknown. - `quiz` ContentTrackingPublicationQuiz: Quiz sticker. Omitted if absent. - `question` string: Quiz sticker question. Omitted if unknown. - `correctAnswer` number: Index of the correct quiz option. Omitted if unknown. - `tallies` ContentTrackingPublicationLabelCount[]: Per-option vote counts. Omitted if none. - `label` string: Option label in a quiz or poll tally. Omitted if unknown. - `count` number: Votes for that option. Omitted if unknown. - `poll` ContentTrackingPublicationPoll: Poll sticker. Omitted if absent. - `question` string: Poll sticker question. Omitted if unknown. - `isMultiOptionPoll` boolean: True when multiple options can be selected. Omitted if unknown. - `totalVotes` number: Total poll votes. Omitted if unknown. - `tallies` ContentTrackingPublicationLabelCount[]: Per-option vote counts. Omitted if none. - `label` string: Option label in a quiz or poll tally. Omitted if unknown. - `count` number: Votes for that option. Omitted if unknown. - `question` string: Free-text question sticker prompt. Omitted if absent. - `addYours` ContentTrackingPublicationAddYours: Add Yours sticker. Omitted if absent. - `text` string: Add Yours prompt. Omitted if unknown. - `participantCount` number: Number of Add Yours participants. Omitted if unknown. - `countdown` ContentTrackingPublicationCountdown: Countdown sticker. Omitted if absent. - `text` string: Countdown sticker label. Omitted if unknown. - `endTime` string: Countdown end instant, ISO 8601 UTC. Omitted if unknown. - `donation` ContentTrackingPublicationDonation: Donation or fundraiser sticker. Omitted if absent. - `contextualTitle` string: Donation sticker contextual title. Omitted if unknown. - `formattedAmountRaised` string: Amount raised, already formatted for display. Omitted if unknown. - `formattedGoalAmount` string: Goal amount, already formatted for display. Omitted if unknown. - `progressStatus` string: Fundraiser progress: `inProgress` or `ended`. Omitted if unknown. - `fundraiserOwnerUsername` string: Fundraiser owner handle. Omitted if unknown. - `fundraiserTitle` string: Fundraiser title. Omitted if unknown. - `slider` ContentTrackingPublicationSlider: Emoji slider sticker. Omitted if absent. - `question` string: Emoji-slider question. Omitted if unknown. - `emoji` string: Emoji used on the slider. Omitted if unknown. - `sliderVoteAverage` number: Average slider score when provided. Omitted if unknown. - `sliderVoteCount` number: Number of slider votes. Omitted if unknown. - `location` ContentTrackingPublicationLocation: Tagged location without coordinates. Omitted if none. - `name` string: Location display name. Omitted if unknown. Coordinates are never returned. - `shortName` string: Short location label. Omitted if unknown. - `city` string: City name. Omitted if unknown. - `country` string: Country name. Omitted if unknown. - `countryCode` string: ISO country code. Omitted if unknown. - `profiles` ContentTrackingPublicationProfile[]: Profiles linked to the publication. Omitted if empty. - `profileId` string, required: Influencity profile identifier linked to the publication. - `username` string: Profile username. Omitted if unknown. - `socialNetwork` string: Profile network. Omitted if unknown. - `picture` string: Profile picture URL. Omitted if unknown. - `isVerified` boolean: Whether the profile is verified on the network. Omitted if unknown. - `contentTrackings` ContentTrackingPublicationContentTrackingRef[]: Content trackings this publication belongs to. Omitted if empty. - `contentTrackingId` string, required: Tracking this publication belongs to. - `name` string: Tracking display name. Omitted if unknown. - `campaignsV3` ContentTrackingPublicationCampaignRef[]: Linked campaign v3 references. Omitted if empty. - `campaignId` string, required: Linked campaign v3 identifier. - `name` string: Campaign display name. Omitted if unknown. - `irmInfluencers` ContentTrackingPublicationIrmInfluencerRef[]: Linked IRM influencers. Omitted if empty. - `irmInfluencerId` string, required: Linked IRM influencer identifier. - `alias` string: IRM influencer alias. Omitted if unknown. - `picture` string: IRM influencer picture URL. Omitted if unknown. - `brandClients` ContentTrackingPublicationBrandClientRef[]: Linked brand clients. Omitted if empty. - `brandClientId` string, required: Linked brand-client identifier. - `name` string: Brand-client display name. Omitted if unknown. - `pagination` ContentTrackingPaginationMeta, required - `page` integer, required: Current 1-based page. - `limit` integer, required: Page size. - `total` integer, required: Total matching publications. - `totalPages` integer, required: Total pages. ## Other responses - `400`: Invalid request payload or validation failed. - `401`: Missing or invalid API token. - `403`: The requested capability is not enabled for this brand plan. - `404`: Tracking was not found or does not belong to the authenticated brand. - `429`: Request rate exceeded (short-term throttle) or daily organization quota exhausted. `error.code` is `RATE_LIMIT_EXCEEDED` for throttling (may include `Retry-After`) or `QUOTA_EXCEEDED` when the daily quota is used up. - `502`: The API could not complete the request. - `503`: Service temporarily unavailable. - `504`: The request timed out. --- [API](https://skmtc.dev/influencity/apis/influencity-api.md) - [All operations](https://skmtc.dev/influencity/apis/influencity-api/llms.txt) - [OpenAPI document](https://skmtc.dev/influencity/apis/influencity-api/revisions/827263990edf?raw)