Content Tracking

List publications in a tracking

Returns paginated publications collected in a content tracking (metrics, music, stickers, and related fields). Content filters are not supported in this version.

get/content-tracking/v1/trackings/{trackingId}/publications

Request

  • Base URL
    https://api.influencity.com
  • Auth
    HTTP bearer

Path parameters

trackingIdstring required

Tracking identifier.

Example:507f1f77bcf86cd799439011

Query parameters

pageinteger

1-based page number.

Example:1

1-based page number (default 1).

limitinteger

Page size (max 100).

Example:20

Page size (default 20, max 100).

sortBy'publicationDate' | 'likes' | 'views' | 'comments' | 'shares' | 'saves' | 'engagement' | 'impressions' | 'profile' | '_id'

Sort field allow-list. When omitted, influ-api sends publicationDate.

Example:publicationDate

Sort field (closed enum).

sortOrder'asc' | 'desc'

Sort direction.

Example:desc

Sort direction (default desc).

Response

Paginated publications for the tracking.

Example response

{
  "data": [
    {
      "publicationId": "507f1f77bcf86cd799439033",
      "network": "instagram",
      "type": "reel",
      "dataSource": "contentTracking",
      "url": "https://www.instagram.com/reel/abc",
      "shortcode": "abc",
      "image": "https://cdn.example.com/image.jpg",
      "media": [
        "https://cdn.example.com/media1.jpg"
      ],
      "caption": "Hello #brand @handle",
      "title": "My video title",
      "hashtags": [
        "#brand"
      ],
      "mentions": [
        "@handle"
      ],
      "keywords": [
        "kw"
      ],
      "isVideo": true,
      "duration": 12.5,
      "numberOfSlides": 1,
      "partnershipLabelAndAds": "sponsored",
      "tags": [
        "tagged_user"
      ],
      "collaborators": [
        "collab_user"
      ],
      "socialNetworkStatus": "live",
      "internalStatus": "ok",
      "publicationDate": "2026-01-15T10:00:00.000Z",
      "lastUpdate": "2026-01-16T10:00:00.000Z",
      "createdAt": "2026-01-15T09:00:00.000Z",
      "updatedAt": "2026-01-16T10:00:00.000Z",
      "usageRights": "validIndefinitely",
      "usageRightsDateRangeStartDate": "2026-01-01T00:00:00.000Z",
      "usageRightsDateRangeEndDate": "2026-06-30T23:59:59.999Z",
      "likes": 10,
      "views": 100,
      "comments": 2,
      "shares": 1,
      "saves": 3,
      "engagement": 4.2,
      "impressions": 200,
      "reposts": 4,
      "totalInteractions": 20,
      "externalLinkTaps": 5,
      "estimatedViews": 150,
      "accountsReached": 90,
      "accountsEngaged": 40,
      "follows": 6,
      "profileVisits": 7,
      "avgWatchTime": 3.2,
      "watchTime": 40,
      "forwards": 1,
      "nextStory": 2,
      "exited": 3,
      "replies": 4,
      "returningViewers": 5,
      "music": {
        "title": "Song",
        "displayArtist": "Artist",
        "igUsername": "ig_artist",
        "igArtistFullname": "IG Artist",
        "igArtistIsVerified": true,
        "author": "Author",
        "album": "Album"
      },
      "link": {
        "title": "Shop",
        "displayUrl": "https://shop.example.com"
      },
      "quiz": {
        "question": "Q?",
        "tallies": [
          {
            "label": "Yes",
            "count": 7
          }
        ]
      },
      "poll": {
        "question": "Poll?",
        "totalVotes": 10,
        "tallies": [
          {
            "label": "Yes",
            "count": 7
          }
        ]
      },
      "question": "Ask me",
      "addYours": {
        "text": "Add yours",
        "participantCount": 9
      },
      "countdown": {
        "text": "Soon",
        "endTime": "2026-12-01T00:00:00.000Z"
      },
      "donation": {
        "contextualTitle": "Donate",
        "formattedAmountRaised": "$10",
        "formattedGoalAmount": "$100",
        "progressStatus": "inProgress",
        "fundraiserOwnerUsername": "owner",
        "fundraiserTitle": "Cause"
      },
      "slider": {
        "question": "Rate",
        "emoji": "🔥",
        "sliderVoteAverage": 4.5,
        "sliderVoteCount": 8
      },
      "location": {
        "name": "Madrid",
        "shortName": "MAD",
        "city": "Madrid",
        "country": "Spain",
        "countryCode": "ES"
      },
      "profiles": [
        {
          "profileId": "507f1f77bcf86cd799439022",
          "username": "creator",
          "socialNetwork": "instagram",
          "picture": "https://cdn.example.com/p.jpg",
          "isVerified": true
        }
      ],
      "contentTrackings": [
        {
          "contentTrackingId": "507f1f77bcf86cd799439011",
          "name": "My Tracking"
        }
      ],
      "campaignsV3": [
        {
          "campaignId": "507f1f77bcf86cd799439044",
          "name": "Campaign"
        }
      ],
      "irmInfluencers": [
        {
          "irmInfluencerId": "507f1f77bcf86cd799439055",
          "alias": "Alias",
          "picture": "https://cdn.example.com/irm.jpg"
        }
      ],
      "brandClients": [
        {
          "brandClientId": "507f1f77bcf86cd799439066",
          "name": "Client"
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.